diff --git a/guides/common/assembly_using-ansible-roles.adoc b/guides/common/assembly_using-ansible-roles.adoc index 24495dfeeaa..72ce918fc5a 100644 --- a/guides/common/assembly_using-ansible-roles.adoc +++ b/guides/common/assembly_using-ansible-roles.adoc @@ -2,7 +2,7 @@ include::modules/con_using-ansible-roles-to-automate-repetitive-tasks-on-clients.adoc[] -include::modules/proc_assigning-ansible-roles-to-an-existing-host.adoc[leveloffset=+1] +include::modules/proc_assigning-ansible-roles-to-a-host.adoc[leveloffset=+1] include::modules/proc_removing-ansible-roles-from-a-host.adoc[leveloffset=+1] diff --git a/guides/common/modules/con_converting-a-host-to-rhel.adoc b/guides/common/modules/con_converting-a-host-to-rhel.adoc index a8905029030..e108e2f1d5c 100644 --- a/guides/common/modules/con_converting-a-host-to-rhel.adoc +++ b/guides/common/modules/con_converting-a-host-to-rhel.adoc @@ -48,11 +48,11 @@ For more information, see {ContentManagementDocURL}Enabling_Red_Hat_Repositories .High-level conversion steps . Import the `{ansible-namespace}.convert2rhel` Ansible role and variables. -For more information, see {ManagingConfigurationsAnsibleDocURL}Importing_Ansible_Roles_and_Variables_ansible[Importing Ansible Roles and Variables] in _{ManagingConfigurationsAnsibleDocTitle}_. +For more information, see {ManagingConfigurationsAnsibleDocURL}Importing_Ansible_Roles_and_Variables_ansible[Importing Ansible roles and variables] in _{ManagingConfigurationsAnsibleDocTitle}_. . Configure Ansible variables for generation of conversion data. For more information, see xref:ansible-variables-for-conversion_{context}[]. . Assign the `{ansible-namespace}.convert2rhel` role to the host that represents {ProjectServer}. -For more information, see {ManagingConfigurationsAnsibleDocURL}Assigning_Ansible_Roles_to_an_Existing_Host_ansible[Assigning Ansible Roles to an Existing Host] in _{ManagingConfigurationsAnsibleDocTitle}_. +For more information, see {ManagingConfigurationsAnsibleDocURL}assigning-ansible-roles-to-a-host[Assigning Ansible roles to host] in _{ManagingConfigurationsAnsibleDocTitle}_. . Run the Ansible role on {ProjectServer}. For more information, see {ManagingConfigurationsAnsibleDocURL}running-ansible-roles-on-a-host_ansible[Running Ansible Roles on a Host] in _{ManagingConfigurationsAnsibleDocTitle}_. + diff --git a/guides/common/modules/proc_adding-rhel-system-roles.adoc b/guides/common/modules/proc_adding-rhel-system-roles.adoc index 147f1e14977..b7bf0816de3 100644 --- a/guides/common/modules/proc_adding-rhel-system-roles.adoc +++ b/guides/common/modules/proc_adding-rhel-system-roles.adoc @@ -47,7 +47,7 @@ You can view and make any modifications that you want to the files before you im . From the list of Ansible roles, select the checkbox of the roles you want to import, and then click *Update*. You can now assign Ansible roles to hosts or host groups. -For more information, see xref:Assigning_Ansible_Roles_to_an_Existing_Host_{context}[]. +For more information, see xref:assigning-ansible-roles-to-a-host[]. You can also add the modules contained in these roles to your Ansible Playbooks by adding them to Ansible Job Templates. You must include the `hosts:all` line in the job template. diff --git a/guides/common/modules/proc_assigning-ansible-roles-to-a-host.adoc b/guides/common/modules/proc_assigning-ansible-roles-to-a-host.adoc new file mode 100644 index 00000000000..a763c521dd0 --- /dev/null +++ b/guides/common/modules/proc_assigning-ansible-roles-to-a-host.adoc @@ -0,0 +1,22 @@ +:_mod-docs-content-type: PROCEDURE + +[id="assigning-ansible-roles-to-a-host"] += Assigning Ansible roles to a host + +You can configure hosts registered to {Project} with Ansible roles. + +.Prerequisites +* Ensure that you have imported Ansible roles. +For more information, see xref:Importing_Ansible_Roles_and_Variables_{context}[]. + +.Procedure +. In the {ProjectWebUI}, navigate to *Hosts* > *All Hosts*. +. Select your host. +. On the *Ansible* tab, select the *Roles* tab. +. Click *Assign roles directly to the host*. +. In the *Edit Ansible Roles* window, assign one or more Ansible roles to your host. +. Click *Confirm* to submit your change. + +.Next steps +* Run all Ansible roles assigned to your host. +For more information, see xref:running-ansible-roles-on-a-host_{context}[]. diff --git a/guides/common/modules/proc_assigning-ansible-roles-to-an-existing-host.adoc b/guides/common/modules/proc_assigning-ansible-roles-to-an-existing-host.adoc deleted file mode 100644 index 2cb92906308..00000000000 --- a/guides/common/modules/proc_assigning-ansible-roles-to-an-existing-host.adoc +++ /dev/null @@ -1,25 +0,0 @@ -:_mod-docs-content-type: PROCEDURE - -[id="Assigning_Ansible_Roles_to_an_Existing_Host_{context}"] -= Assigning Ansible roles to an existing host - -You can use Ansible roles for remote management of {Project} clients. - -.Prerequisites -* Ensure that you have configured and imported Ansible roles. - -.Procedure -. In the {ProjectWebUI}, navigate to *Hosts > All Hosts*. -. Select the host and click *Edit*. -. On the *Ansible Roles* tab, select the role that you want to add from the *Available Ansible Roles* list. -. Click the *+* icon to add the role to the host. -You can add more than one role. -. Click *Submit*. - -After you assign Ansible roles to hosts, you can use Ansible for remote execution. -For more information, see xref:Distributing_SSH_Keys_for_Remote_Execution_{context}[]. - -.Overriding parameter variables -On the *Parameters* tab, click *Add Parameter* to add any parameter variables that you want to pass to job templates at run time. -This includes all Ansible Playbook parameters and host parameters that you want to associate with the host. -To use a parameter variable with an Ansible job template, you must add a *Host Parameter*. diff --git a/guides/common/modules/proc_overriding-ansible-variables-in-project.adoc b/guides/common/modules/proc_overriding-ansible-variables-in-project.adoc index be09a1d4e65..3bd055388f4 100644 --- a/guides/common/modules/proc_overriding-ansible-variables-in-project.adoc +++ b/guides/common/modules/proc_overriding-ansible-variables-in-project.adoc @@ -48,11 +48,13 @@ If the hashes contain the same key, the value is overwritten by the value of the . Optional: Expand the *Specify Matchers* area and specify criteria for selecting hosts on which the variable overrides. . To save the override settings, click *Submit*. -To use the Ansible variable, add the variable as a parameter to your host or host group, or add the variable as a global parameter. +Alternatively, if you only want to override the value of a variable of a single host, you can change the variable on the *Ansible* tab on the host details page. -.Adding the variable to a host -. In the {ProjectWebUI}, navigate to *Hosts > All Hosts* and select the host that you want to use. -. Click the *Ansible* tab, and in the *Variables* area, click the pencil icon to edit the value of the variable. +.Overriding variables for individual hosts +. In the {ProjectWebUI}, navigate to *Hosts* > *All Hosts*. +. Select your host. +. On the *Ansible* tab, select the *Variables* tab. +. Click the pencil icon to edit the value of the variable. . Click the tick icon to accept the value of the changed variable or the cross icon to cancel the change. .Adding the variable to a host group