WIP: PED10891-Ansible-basics #544
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,16 @@ | ||
| # This file originates from the project https://github.com/openSUSE/doc-kit | ||
| # This file can be edited downstream. | ||
|
|
||
| MAIN="ansible.asm.xml" | ||
| # Point to the ID of the <structure> of your assembly | ||
| SRC_DIR="articles" | ||
| IMG_SRC_DIR="images" | ||
|
|
||
| PROFOS="sles4sap" | ||
| PROFCONDITION="16.0" | ||
| STRUCTID="ansible" | ||
| #PROFCONDITION="suse-product;beta" | ||
| #PROFCONDITION="community-project" | ||
|
|
||
| STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns" | ||
| FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse-ns" |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,16 @@ | ||
| # This file originates from the project https://github.com/openSUSE/doc-kit | ||
| # This file can be edited downstream. | ||
|
|
||
| MAIN="ansible.asm.xml" | ||
| # Point to the ID of the <structure> of your assembly | ||
| SRC_DIR="articles" | ||
| IMG_SRC_DIR="images" | ||
|
|
||
| PROFOS="sles" | ||
| PROFCONDITION="16.0" | ||
| STRUCTID="ansible" | ||
| #PROFCONDITION="suse-product;beta" | ||
| #PROFCONDITION="community-project" | ||
|
|
||
| STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns" | ||
| FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse-ns" |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| @@ -0,0 +1,156 @@ | ||||||||||
| <?xml version="1.0" encoding="UTF-8" standalone="no"?> | ||||||||||
| <?xml-model href="https://cdn.docbook.org/schema/5.2/rng/assemblyxi.rnc" | ||||||||||
| type="application/relax-ng-compact-syntax"?> | ||||||||||
| <!DOCTYPE assembly | ||||||||||
| [ | ||||||||||
| <!ENTITY % entities SYSTEM "../common/generic-entities.ent"> | ||||||||||
| %entities; | ||||||||||
| ]> | ||||||||||
| <assembly version="5.2" xml:lang="en" | ||||||||||
| xmlns:xlink="http://www.w3.org/1999/xlink" | ||||||||||
| xmlns:trans="http://docbook.org/ns/transclusion" | ||||||||||
| xmlns:its="http://www.w3.org/2005/11/its" | ||||||||||
| xmlns="http://docbook.org/ns/docbook"> | ||||||||||
| <!-- R E S O U R C E S --> | ||||||||||
| <resources> | ||||||||||
| <resource href="../concepts/ansible-intro.xml" xml:id="_ansible-intro"/> | ||||||||||
| <resource href="../references/ansible-configure.xml" xml:id="_ansible-configure"/> | ||||||||||
| <resource href="../concepts/ansible-inventory-file.xml" xml:id="_ansible-inventory-file"/> | ||||||||||
| <resource href="../tasks/ansible-install.xml" xml:id="_ansible-install"/> | ||||||||||
| <resource href="../references/ansible-basic-usage.xml" xml:id="_ansible-basic-usage"/> | ||||||||||
| <resource href="../references/ansible-support-coverage.xml" xml:id="_ansible-support-coverage"/> | ||||||||||
| <resource href="../references/ansible-best-practices.xml" xml:id="_ansible-best-practices"/> | ||||||||||
| <resource href="../glues/ansible-more-info.xml" xml:id="_ansible-more-info"/> | ||||||||||
| <resource href="../common/legal.xml" xml:id="_legal"/> | ||||||||||
| <resource href="../common/license_gfdl1.2.xml" xml:id="_gfdl"/> | ||||||||||
| </resources> | ||||||||||
| <!-- S T R U C T U R E --> | ||||||||||
| <structure renderas="article" xml:id="ansible" xml:lang="en"> | ||||||||||
| <merge> | ||||||||||
| <title>Ansible core</title> | ||||||||||
|
There was a problem hiding this comment. I suggest an extended title, e.g. Ansible Core Installation Configuration and Automation Basics |
||||||||||
| <revhistory xml:id="rh-ansible"> | ||||||||||
| <revision><date>2025-06-19</date> | ||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||
| <revdescription> | ||||||||||
| <para> | ||||||||||
| Initial version | ||||||||||
| </para> | ||||||||||
| </revdescription> | ||||||||||
| </revision> | ||||||||||
| </revhistory> | ||||||||||
|
|
||||||||||
| <!-- Maintainer--> | ||||||||||
| <meta name="maintainer" content="[email protected]" its:translate="no"/> | ||||||||||
|
|
||||||||||
| <!-- Series--> | ||||||||||
| <meta name="series" its:translate="no">Smart Docs</meta> | ||||||||||
|
|
||||||||||
| <!-- Task --> | ||||||||||
| <meta name="task" its:translate="no"> | ||||||||||
| <phrase>Administration</phrase> | ||||||||||
| <phrase>Configuration</phrase> | ||||||||||
| <phrase>Security</phrase> | ||||||||||
| </meta> | ||||||||||
|
|
||||||||||
| <!-- Docmanager --> | ||||||||||
| <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager"> | ||||||||||
| <dm:bugtracker> | ||||||||||
| <dm:url>https://bugzilla.suse.com/enter_bug.cgi</dm:url> | ||||||||||
| <dm:component>Documentation</dm:component> | ||||||||||
| <dm:product>SUSE Linux Enterprise Server 16.0</dm:product> | ||||||||||
| <dm:assignee>[email protected]</dm:assignee> | ||||||||||
| </dm:bugtracker> | ||||||||||
| <dm:translation>yes</dm:translation> | ||||||||||
| </dm:docmanager> | ||||||||||
|
|
||||||||||
| <!-- Architecture --> | ||||||||||
| <meta name="architecture" its:translate="no"> | ||||||||||
| <phrase>&x86-64;</phrase> | ||||||||||
| <phrase>&power;</phrase> | ||||||||||
| <phrase>&zseries;</phrase> | ||||||||||
| <phrase>&aarch64;</phrase> | ||||||||||
| </meta> | ||||||||||
|
|
||||||||||
| <!-- Productname & Version --> | ||||||||||
| <meta name="productname" its:translate="no"> | ||||||||||
| <productname version="16">&sles;</productname> | ||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||
| </meta> | ||||||||||
|
|
||||||||||
| <!-- Social Media --> | ||||||||||
| <meta name="title" its:translate="yes">Ansible automation platform</meta> | ||||||||||
|
There was a problem hiding this comment. The title must be the same as the article title. There was a problem hiding this comment.
Suggested change
|
||||||||||
| <meta name="social-descr" its:translate="yes">Learn how to automate IT tasks using Ansible</meta> | ||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||
|
|
||||||||||
| <!-- Search --> | ||||||||||
| <meta name="description" its:translate="yes">Save time by using Ansible automation platform.</meta> | ||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||
|
|
||||||||||
| <abstract> | ||||||||||
| <variablelist> | ||||||||||
| <varlistentry> | ||||||||||
| <term>WHAT?</term> | ||||||||||
| <listitem> | ||||||||||
| <para> | ||||||||||
| This article gives an introduction to Ansible and guides you on how to automate repetitive IT tasks. | ||||||||||
|
There was a problem hiding this comment. I'd leave the first sentence from here as it mentioned in the Why?
Suggested change
|
||||||||||
| Ansible is an IT automation tool that simplifies configuration management, application deployment and | ||||||||||
| task orchestration by enabling you to define infrastructure as code in a simple way. | ||||||||||
| </para> | ||||||||||
| </listitem> | ||||||||||
| </varlistentry> | ||||||||||
| <varlistentry> | ||||||||||
| <term>WHY?</term> | ||||||||||
| <listitem> | ||||||||||
| <para> | ||||||||||
| Learn how to automate IT infrastructure with Ansible; how to install and configure, create | ||||||||||
| an inventory file and a playbook. | ||||||||||
|
Comment on lines
+101
to
+102
There was a problem hiding this comment.
Suggested change
|
||||||||||
| </para> | ||||||||||
| </listitem> | ||||||||||
| </varlistentry> | ||||||||||
| <varlistentry> | ||||||||||
| <term>EFFORT</term> | ||||||||||
| <listitem> | ||||||||||
| <para> | ||||||||||
| The average reading time of this article is approximately 40 minutes. | ||||||||||
| </para> | ||||||||||
| </listitem> | ||||||||||
| </varlistentry> | ||||||||||
| <varlistentry> | ||||||||||
| <term>REQUIREMENTS</term> | ||||||||||
| <listitem> | ||||||||||
| <itemizedlist> | ||||||||||
| <listitem> | ||||||||||
| <para> | ||||||||||
| <emphasis>Linux fundamentals:</emphasis> Understanding basic Linux commands,file permissions, directory structures | ||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||
| and usage of the command line. | ||||||||||
|
Comment on lines
+120
to
+121
There was a problem hiding this comment.
Suggested change
|
||||||||||
| </para> | ||||||||||
| </listitem> | ||||||||||
| <listitem> | ||||||||||
| <para> | ||||||||||
| <emphasis>Networking:</emphasis> Ansible connects to remote machines via SSH so knowledge of IP addresses, SSH, host names and ports is required. | ||||||||||
| </para> | ||||||||||
| </listitem> | ||||||||||
| <listitem> | ||||||||||
| <para> | ||||||||||
| <emphasis>YAML:</emphasis> Ansible playbooks are written in YAML so knowing how to structure a YAML file is essential. | ||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||
| </para> | ||||||||||
| </listitem> | ||||||||||
| </itemizedlist> | ||||||||||
| </listitem> | ||||||||||
| </varlistentry> | ||||||||||
| </variablelist> | ||||||||||
| </abstract> | ||||||||||
| </merge> | ||||||||||
| <module resourceref="_ansible-intro"></module> | ||||||||||
| <module resourceref="_ansible-configure"> | ||||||||||
|
There was a problem hiding this comment. Please switch the order here. |
||||||||||
| </module> | ||||||||||
| <module resourceref="_ansible-install"> | ||||||||||
| </module> | ||||||||||
| <module resourceref="_ansible-inventory-file"> | ||||||||||
| </module> | ||||||||||
| <module resourceref="_ansible-basic-usage"/> | ||||||||||
| <module resourceref="_ansible-best-practices"/> | ||||||||||
| <module resourceref="_ansible-support-coverage"/> | ||||||||||
| <module resourceref="_ansible-more-info"/> | ||||||||||
| <module resourceref="_legal"/> | ||||||||||
| <module resourceref="_gfdl"> | ||||||||||
| <output renderas="appendix"/> | ||||||||||
| </module> | ||||||||||
| </structure> | ||||||||||
| </assembly> | ||||||||||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,140 @@ | ||
| <?xml version="1.0" encoding="UTF-8" standalone="no"?> | ||
| <?xml-model href="https://cdn.docbook.org/schema/5.2/rng/assemblyxi.rnc" | ||
| type="application/relax-ng-compact-syntax"?> | ||
| <!DOCTYPE assembly | ||
| [ | ||
| <!ENTITY % entities SYSTEM "../common/generic-entities.ent"> | ||
| %entities; | ||
| ]> | ||
| <!-- refers to legacy doc: https://github.com/SUSE/doc-sle/blob/main/xml/adm_sudo.xml --> | ||
|
|
||
| <assembly version="5.2" xml:lang="en" | ||
| xmlns:xlink="http://www.w3.org/1999/xlink" | ||
| xmlns:trans="http://docbook.org/ns/transclusion" | ||
| xmlns:its="http://www.w3.org/2005/11/its" | ||
| xmlns="http://docbook.org/ns/docbook"> | ||
|
|
||
|
|
||
| <resources> | ||
| <resource xml:id="_sap-for-ansible-intro" href="../concepts/sap-for-ansible-intro.xml"/> | ||
|
|
||
| <resource xml:id="_about-install-sap-pattern-ansible" href="../concepts/about-install-sap-pattern-ansible.xml"/> | ||
| <resource xml:id="_install-sap-playbook-ansible" href="../tasks/install-sap-playbook-ansible.xml"/> | ||
| <resource xml:id="_sap-ansible-playbook-more-info" href="../glues/ansible-sap-more-info.xml"/> | ||
| <resource href="../common/legal.xml" xml:id="_legal"/> | ||
| <resource href="../common/license_gfdl1.2.xml" xml:id="_gfdl"/> | ||
| </resources> | ||
| <!-- S T R U C T U R E --> | ||
| <structure renderas="article" xml:id="intro-sap-ansible" xml:lang="en"> | ||
| <merge> | ||
| <title>Introduction to Ansible automation for &sles4sap; 16</title> | ||
|
There was a problem hiding this comment. I wasn't able to build this DC file for SAP |
||
| <!-- Create changelog to enable versioning; add most recent entries at the top. --> | ||
| <revhistory xml:id="rh-intro-sap-automation"> | ||
| <revision><date>2025-10-19</date> | ||
| <revdescription> | ||
| <para>Initial version</para> | ||
| </revdescription> | ||
| </revision> | ||
| </revhistory> | ||
|
|
||
| <meta name="maintainer" content="[email protected]" its:translate="no"/> | ||
|
|
||
| <meta name="productname" its:translate="no"> | ||
| <productname os="sles4sap" version="16.0">&sles4sap;</productname> | ||
| </meta> | ||
|
|
||
| <meta name="architecture" its:translate="no"> | ||
| <phrase>&x86-64;</phrase> | ||
| <phrase>&power;</phrase> | ||
| <phrase>&zseries;</phrase> | ||
| <phrase>&aarch64;</phrase> | ||
| </meta> | ||
|
|
||
| <meta name="title" its:translate="yes">Introduction to Ansible automation for &sles4sap;</meta> | ||
| <meta name="description" its:translate="yes">Learn about a set of Ansible collections and playbooks designed specifically for &sles4sap; on &productname; 16.</meta> | ||
| <meta name="social-descr" its:translate="yes">How to use Ansible automation for SAP environments on &productname; 16 systems. </meta> | ||
|
|
||
| <meta name="category" its:translate="no"> | ||
| <phrase>Administration</phrase> | ||
| </meta> | ||
|
|
||
| <meta name="task" its:translate="no"> | ||
| <phrase>Authentication</phrase> | ||
| <phrase>Security</phrase> | ||
| </meta> | ||
|
|
||
| <meta name="series" its:translate="no">Products & Solutions</meta> | ||
|
|
||
| <!-- Docmanager --> | ||
| <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager"> | ||
| <dm:bugtracker> | ||
| <dm:url>https://bugzilla.suse.com/enter_bug.cgi</dm:url> | ||
| <dm:component>Documentation</dm:component> | ||
| <dm:product os="sles4sap">SUSE Linux Enterprise Server 16.0</dm:product> | ||
| <dm:assignee>[email protected]</dm:assignee> | ||
| </dm:bugtracker> | ||
| <dm:translation>yes</dm:translation> | ||
| </dm:docmanager> | ||
|
|
||
| <abstract> | ||
| <variablelist> | ||
| <varlistentry> | ||
| <term>WHAT?</term> | ||
| <listitem> | ||
| <para> | ||
| Learn about a powerful set of Ansible collections and playbooks that are designed &sles4sap;. | ||
| This automation codifies best practices, allowing you to build and maintain your SAP landscapes with speed, reliability and consistency. | ||
| </para> | ||
| </listitem> | ||
| </varlistentry> | ||
| <varlistentry> | ||
| <term>WHY?</term> | ||
| <listitem> | ||
| <para> | ||
| Ansible automation is essential for &sap; environments for organizations to codify and standardize the complex, time-consuming, and high-risk administrative tasks associated with &sap; infrastructure and operations. | ||
| </para> | ||
| </listitem> | ||
| </varlistentry> | ||
| <varlistentry> | ||
| <term>EFFORT</term> | ||
| <listitem> | ||
| <para> | ||
| It takes you up to an hour to read through this article. | ||
| </para> | ||
| </listitem> | ||
| </varlistentry> | ||
| <varlistentry> | ||
| <term>GOAL</term> | ||
| <listitem> | ||
| <para> | ||
| To transform the management of &sap; environments from a complex, error-prone and time-intensive manual process into a fast, consistent, and fully auditable Infrastructure as Code (IaC) workflow. | ||
| </para> | ||
| </listitem> | ||
| </varlistentry> | ||
| <varlistentry> | ||
| <term>REQUIREMENTS</term> | ||
| <listitem> | ||
| <itemizedlist> | ||
| <listitem> | ||
| <para> | ||
| Understanding of Ansible core and how it works.</para> | ||
| </listitem> | ||
| <listitem> | ||
| <para> | ||
| Understanding the architecture of &sap; systems. | ||
| </para> | ||
| </listitem> | ||
| </itemizedlist> | ||
| </listitem> | ||
| </varlistentry> | ||
| </variablelist> | ||
| </abstract> | ||
| </merge> | ||
| <module resourceref="_sap-for-ansible-intro" renderas="section"/> | ||
| <module resourceref="_about-install-sap-pattern-ansible" renderas="section"/> | ||
| <module resourceref="_install-sap-playbook-ansible" renderas="section"/> | ||
| <module resourceref="_sap-ansible-playbook-more-info" renderas="section"/> | ||
| <module resourceref="_legal" renderas="section"/> | ||
| <module resourceref="_gfdl" renderas="appendix"/> | ||
| </structure> | ||
| </assembly> | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Feel free to change, however, as a beginner I wouldn't know what Ansible core is, so I'd search for Introduction or Getting started.