Rework assigning Ansible roles to a host

Author: maximiliankolb

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]
 

guides/common/modules/con_converting-a-host-to-rhel.adoc

@@ -52,7 +52,7 @@ For more information, see {ManagingConfigurationsAnsibleDocURL}Importing_Ansible
 . 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}_.
 +

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.

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}[].