In this exercise, we are going to configure Tower so that we can run a playbook.

The Tower UI

There are a number of constructs in the Ansible Tower UI that enable multi-tenancy, notifications, scheduling, etc. However, we are only going to focus on a few of the key constructs that are required for this workshop today.

  • Credentials

  • Projects

  • Inventory

  • Job Template

Logging into Tower and Installing the License Key

Step 1: To log in, use the username admin and and the password ansibleWS.


ansible lab figure01 logon screen
Figure 3: Ansible Tower Login Screen

As soon as you login, you will prompted to request a license or browse for an existing license file


at lic prompt
Figure 4: Uploading a License

Step 2: In a seperate browser tab, download your license key by browsing to http://ansible-workshop.redhatgov.io/workshop-files/ansible_tower_license.txt
Step 3: Back in the Tower UI, choose BROWSE LicB and upload your recently downloaded license file into Tower.
Step 4: Select "I agree to the End User License Agreement"
Step 5: Click on SUBMIT Sub

Creating a Credential

Credentials are utilized by Tower for authentication when launching jobs against machines, synchronizing with inventory sources, and importing project content from a version control system.

There are many types of credentials including machine, network, and various cloud providers. In this workshop, we are using a machine credential.

Step 1: Select the gear icon Gear

Step 2: Select CREDENTIALS

Step 3: Click on ADD Add

Step 4: Complete the form using the following entries

NAME

Ansible Workshop Credential

DESCRIPTION

Credentials for Ansible Workshop

ORGANIZATION

Default

TYPE

Machine

USERNAME

Your Workshop Username - Student(x)

PASSWORD

Your Workshop Password

PRIVILEGE ESCALATION

Sudo (This is the default)


Cred_Detail
Figure 5: Adding a Credential

Step 5: Select SAVE Save

Creating a Project

A Project is a logical collection of Ansible playbooks, represented in Tower. You can manage playbooks and playbook directories by either placing them manually under the Project Base Path on your Tower server, or by placing your playbooks into a source code management (SCM) system supported by Tower, including Git, Subversion, and Mercurial.

Step 1: Click on PROJECTS

Step 2: Select ADD Add

Step 3: Complete the form using the following entries

NAME

Ansible Workshop Project

DESCRIPTION

Workshop playbooks

ORGANIZATION

Default

SCM TYPE

Git

SCM URL

https://github.com/ansible/lightbulb

SCM BRANCH

SCM UPDATE OPTIONS

  • Clean

  • Delete on Update

  • Update on Launch


at project detail
Figure 6: Defining a Project

Step 4: Select SAVE Save

Creating an Inventory

An inventory is a collection of hosts against which jobs may be launched. Inventories are divided into groups and these groups contain the actual hosts. Groups may be sourced manually, by entering host names into Tower, or from one of Ansible Tower’s supported cloud providers.

An Inventory can also be imported into Tower using the tower-manage command and this is how we are going to add an inventory for this workshop.

Step 1: Click on INVENTORIES

Step 2: Select ADD Add

Step 3: Complete the form using the following entries

NAME

Ansible Workshop Inventory

DESCRIPTION

Ansible Inventory

ORGANIZATION

Default


at inv create
Figure 7: Create an Inventory

Step 4: Select SAVE Save

Step 5: Using ssh, login to your control node

ssh <username>@<IP_Address_of_your_control_node>

Step 6: Use the tower-manage command to import an existing inventory. (Be sure to replace <username> with your actual username)

sudo tower-manage inventory_import --source=/home/<username>/lightbulb/lessons/lab_inventory/<username>-instances.txt --inventory-name="Ansible Workshop Inventory"

You should see output similar to the following: