AWX-TEST

AWX-test is a project that is based on using the Ansible tower-cli to perform actions within AWX. It provides you with a simple Python class which uses tower-cli to run its available commands.

Benefit

One of the main reasons for the Python class is that each of the tower-cli commands require objects from other tower-cli commands. For example: when creating an inventory you need to have the organization id to associate the inventory too. You cannot pass the name of the organization in string format. This requires you too create an object for organization resource, get the organization object and return the organization id to create an inventory. There was also checks needed to see if the organization was valid, etc. This class allows all commands (organization, host, etc) to have access to the required commands it may need.

Usage

It is recommended that you configure your tower_cli.cfg file with your authentication details for accessing your AWX instance.

$ vi /etc/tower/tower_cli.cfg

host: http://localhost
username: admin
password: password
verify_ssl: False

Here are some examples on how to use the Python class wrapping tower-cli library.

from awx import Awx
from pprint import pprint

# create awx object
awx = Awx()

# list all organizations
print(awx.organizations.organizations)

# list all inventories
print(awx.inventory.inventories)

# create organization
awx.organization.create('minions')