Chapter 7. Using Ansible Roles

7.1. Assigning Ansible Roles to an Existing Host

You can use Ansible roles for remote management of Red Hat Enterprise Linux versions 8, 7, and 6.9 or later.

Prerequisites

You must import the roles to Satellite before you can assign them to a host. For more information, see Adding Red Hat Enterprise Linux System Roles in Administering Red Hat Satellite.

Procedure

  1. In the Satellite web UI, navigate to Hosts > All Hosts.
  2. On the host you want to assign an Ansible role to, click Edit.
  3. Select the Ansible Roles tab, and in the All items list, search for the roles that you want to add.
  4. Select the roles that you want to add, and click the arrow icon to move the roles to the Selected items list.
  5. Click Submit.

After you assign Ansible roles to hosts, you can use Ansible for remote execution. For more information, see Section 8.1, “Establishing a Secure Connection for Remote Commands”.

Overiding 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.

7.2. Running Ansible Roles on a Host

You can run Ansible roles on a host through the Satellite web UI.

Prerequisites

  • You must have imported the Ansible roles to Satellite.
  • You must have assigned the Ansible roles to the host.

Procedure

  1. In the Satellite web UI, navigate to Hosts > All Hosts.
  2. Select the check box of the host that contains the Ansible role you want to run.
  3. From the Select Action list, select Play Ansible roles.

You can view the status of your Ansible job on the Run Ansible roles page. To rerun a job, click the Rerun button.

7.3. Assigning an Ansible Role to a Host Group

You can use Ansible roles for remote management of Red Hat Enterprise Linux versions 8, 7, and 6.9 or later.

Prerequisites

You must import the roles to Satellite before you can assign them to a host group. For more information, see Adding Red Hat Enterprise Linux System Roles in Administering Red Hat Satellite.

Procedure

  1. In the Satellite web UI, navigate to Configure > Host Groups.
  2. From the list of host groups, click the host group name that you want to add an Ansible Role to.
  3. Select the Ansible Roles tab, and in the All items list, search for the roles that you want to add.
  4. Select the roles that you want to add, and click the arrow icon to move the roles to the Selected items list.
  5. Click Submit.

7.4. Running Ansible Roles on a Host Group

You can run Ansible roles on a host group through the Satellite web UI.

Prerequisites

  • You must have imported the Ansible roles to Satellite.
  • You must have assigned the Ansible roles to the host group.
  • You must have at least one host in your host group.

Procedure

  1. In the Satellite web UI, navigate to Configure > Host Groups.
  2. From the list in the Actions column for the host group, select Play Roles.

You can view the status of your Ansible job on the Run Ansible roles page. To rerun a job, click the Rerun button.