Add running Ansible playbook in Foreman (#2951)

Co-authored-by: Aneta Šteflová Petrová <[email protected]>
Co-authored-by: Maximilian Kolb <[email protected]>

guides/common/modules/proc_running-an-ansible-playbook.adoc

@@ -0,0 +1,28 @@
+[id="running-an-ansible-playbook-from-{project-context}_{context}"]
+= Running an Ansible playbook from {Project}
+
+You can run an Ansible playbook on a host or host group by executing a remote job in {Project}.
+
+.Prerequisites
+* Ansible plugin in {Project} is enabled.
+* Remote job execution is configured.
+For more information, see xref:Configuring_and_Setting_Up_Remote_Jobs_{context}[].
+* You have an Ansible playbook ready to use.
+
+.Procedure
+. In the {ProjectWebUI}, navigate to *Monitor* > *Jobs*.
+. Click *Run Job*.
+. In *Job category*, select `Ansible Playbook`.
+. In *Job template*, select `Ansible - Run playbook`.
+. Click *Next*.
+. Select the hosts on which you want to run the playbook.
+. In the *playbook* field, paste the content of your Ansible playbook.
+. Follow the wizzard to complete setting the remote job.
+For more information, see xref:executing-a-remote-job_{context}[].
+. Click *Submit* to run the Ansible playbook on your hosts.
+
+.Additional resources
+* Alternatively, you can import Ansible playbooks from {SmartProxyServers}.
+For more information, see the following resources:
+** xref:importing-an-ansible-playbook-by-name_{context}[]
+** xref:importing-all-available-ansible-playbooks_{context}[]

guides/doc-Managing_Configurations_Ansible/master.adoc

@@ -13,6 +13,8 @@ include::common/assembly_getting-started-with-ansible.adoc[leveloffset=+1]
 
 include::common/assembly_using-ansible-roles.adoc[leveloffset=+1]
 
+include::common/modules/proc_running-an-ansible-playbook.adoc[leveloffset=+1]
+
 include::common/assembly_configuring-and-setting-up-remote-jobs.adoc[leveloffset=+1]
 
 include::common/assembly_integrating-awx.adoc[leveloffset=+1]