5-explore-controller

Exercise 5: Explore Ansible Automation Platform

Read this in other languages: English, 日本語, Español, Français.

Table of Contents

• Exercise 5: Explore Ansible Automation Platform
  • Table of Contents
  • Objective
  • Guide
    • Step 1: Login to Ansible Automation Platform
    • Step 2: Examine the Ansible Automation Platform Inventory
    • Step 3: Examine the Ansible Automation Platform Workshop Project
    • Step 4: Examine the Ansible Automation Platform Workshop Credential
  • Takeaways
  • Complete

Objective

Explore and understand the lab environment. This exercise will cover

• Determining the Ansible Automation Platform version running on the control node
• Locating and understanding:
  • Inventory
  • Credentials
  • Projects

Guide

Step 1: Login to Ansible Automation Platform

1. Return to the workshop launch page provided by your instructor.

2. Click on the link to the Ansible Automation Platform webUI. You should see a login screen similar to the follow:

Screenshot of Ansible Automation Platform login window.

• The username will be admin
• password provided on launch page

3. After logging in the Job Dashboard will be the default view as shown below.

   

4. Click on the ? button on the top right of the user interface and click About

   

5. A window will pop up similar to the following:

   

Step 2: Examine the Ansible Automation Platform Inventory

An inventory is required for Ansible Automation Platform to be able to run jobs. An inventory is a collection of hosts against which jobs may be launched, the same as an Ansible inventory file. In addition, Ansible Automation Platform can make use of an existing configuration management data base (cmdb) such as ServiceNow or Infoblox DDI.

Note:

More info on Inventories in respect to Ansible Automation Platform can be found in the documentation here

1. Click on Infrastructure link under Automation Execution on the left menu bar, then click the Inventories link.

   

2. Under Inventories click on the Workshop Inventory.

   

3. Under the Workshop Inventory click the Hosts button at the top. There will be four hosts here, rtr1 through rtr4 as well as the ansible control node.

   

4. Click on one of the devices.

   

   Take note of the VARIABLES field. The host_vars are set here including the ansible_host variable.

5. Click on GROUPS. There will be multiple groups here including routers and cisco. Click on one of the groups.

   

6. Click on one of the groups.

   

   Take note of the VARIABLES field. The group_vars are set here including the ansible_connection and ansible_network_os variable.

Step 3: Examine the Ansible Automation Platform Workshop Project

A project is how Ansible Playbooks are imported into Ansible Automation Platform. You can manage playbooks and playbook directories by either placing them manually under the Project Base Path on your Ansible Automation Platform server, or by placing your playbooks into a source code management (SCM) system supported by Ansible Automation Platform, including Git (Github, Gitlab, etc).

Note:

For more information on Projects in Ansible Automation Platform, please refer to the documentation

1. Click on the Projects link under Automation Execution on the left menu bar.

   

2. Under PROJECTS there will be a Workshop Project.

   

   Note that GIT is listed for this project. This means this project is using Git for SCM.

3. Click on the Workshop Project.

Note:

Source Control URL is set to https://github.com/network-automation/toolkit.

Step 4: Examine the Ansible Automation Platform Workshop Credential

Credentials are utilized by Ansible Automation Platform for authentication when launching Jobs against machines, synchronizing with inventory sources, and importing project content from a version control system. For the workshop we need a credential to authenticate to the network devices.

Note:

For more information on Credentials in Ansible Automation Platform please refer to the documentation.

1. Click on the Infrastructure link under Automation Execution on the left menu bar, then click on the Credentials link

   

2. Under Credentials there will be multiple pre-configured credentials, including Workshop Credential, Controller Credential and the registry.redhat.io credential. Click on the Workshop Credential.

   

3. Under the Workshop Credential examine the following:

• The Credential type is a Machine credential.
• The Username is set to ec2-user.
• The SSH Private Key is already configured, and is Encrypted.

{% include mesh.md %}

Takeaways

• Ansible Automation Platform needs an inventory to execute Ansible Playbooks against. This inventory is identical to what users would use with the command line only Ansible project.
• Ansible Automation Platform can sync to existing SCM (source control management) including GitHub.
• Ansible Automation Platform can store and encrypt credentials including SSH private keys and plain-text passwords. Ansible Automation Platform can also sync to existing credential storage systems such as CyberArk and Vault by HashiCorp.

Complete

You have completed lab exercise 5

You have now examined all three components required to get started with Ansible Automation Platform. A credential, an inventory and a project. In the next exercise we will create a job template.

---

Previous Exercise | Next Exercise

Click here to return to the Ansible Network Automation Workshop