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.