Ansible AWX CLI container

Table of contents

• What is it?
• Versioning
• Running the container
• Continuous integration
  • Azure DevOps
• Please contribute!

What is it?

This repository contains the CLI for Ansible AWX / Tower, made easily available in a container image.

The container image can be found on the Docker Hub.

Versioning

The versioning of this project follows the one of the official awxkit library⁠.

Running the container

This container can be run using the following command:

docker run --rm \
  -t docker.io/ppodgorsek/ansible-awx-cli:latest \
  awx {{ CLI arguments }}

For example, triggering a job template can be done as follows:

docker run --rm \
  -t docker.io/ppodgorsek/ansible-awx-cli:latest \
  awx job_templates launch 'Job name CHANGEME' --conf.host='https://changeme' --conf.token='changeme' --filter=status --monitor -f human

All official AWX CLI arguments can be used. The complete list can be found in AWX CLI's official documentation⁠.

Continuous integration

Azure DevOps

It is possible to run the project within an Azure DevOps pipeline by relying on a simple script, as the Docker@2 task⁠ currently only allows to build and push images:

- script: |
    docker run --rm -t docker.io/ppodgorsek/ansible-awx-cli:latest awx {{ CLI arguments }}
  displayName: Ansible AWX

Please contribute!

Have you found an issue? Do you have an idea for an improvement? Feel free to contribute by submitting it on the GitHub project⁠.