diff --git a/guides/common/modules/proc_running-an-ansible-playbook.adoc b/guides/common/modules/proc_running-an-ansible-playbook.adoc new file mode 100644 index 00000000000..63d249f821d --- /dev/null +++ b/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}[] diff --git a/guides/doc-Managing_Configurations_Ansible/master.adoc b/guides/doc-Managing_Configurations_Ansible/master.adoc index 942d1aea6d0..430e224cbe8 100644 --- a/guides/doc-Managing_Configurations_Ansible/master.adoc +++ b/guides/doc-Managing_Configurations_Ansible/master.adoc @@ -15,6 +15,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]