https://github.com/ppodgorsek/ansible-awx-cli
The CLI for Ansible AWX / Tower, made easily available in a container image
https://github.com/ppodgorsek/ansible-awx-cli
ansible awx-ansible awx-ansible-tower awx-cli docker podman
Last synced: about 1 month ago
JSON representation
The CLI for Ansible AWX / Tower, made easily available in a container image
- Host: GitHub
- URL: https://github.com/ppodgorsek/ansible-awx-cli
- Owner: ppodgorsek
- License: mit
- Created: 2024-02-14T09:01:39.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-15T10:32:09.000Z (over 2 years ago)
- Last Synced: 2025-03-19T22:04:25.405Z (over 1 year ago)
- Topics: ansible, awx-ansible, awx-ansible-tower, awx-cli, docker, podman
- Language: Dockerfile
- Homepage: https://hub.docker.com/r/ppodgorsek/ansible-awx-cli
- Size: 9.77 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Ansible AWX CLI container
## Table of contents
- [What is it?](#what-is-it)
- [Versioning](#versioning)
- [Running the container](#running-the-container)
- [Continuous integration](#continuous-integration)
- [Azure DevOps](#azure-devops)
- [Please contribute!](#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](https://hub.docker.com/r/ppodgorsek/ansible-awx-cli).
## Versioning
The versioning of this project follows the one of the official [awxkit library](https://pypi.org/project/awxkit/).
## Running the container
This container can be run using the following command:
```sh
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:
```sh
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](https://docs.ansible.com/ansible-tower/latest/html/towercli/reference.html).
## 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](https://learn.microsoft.com/en-us/azure/devops/pipelines/tasks/reference/docker-v2) currently only allows to build and push images:
```yml
- 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](https://github.com/ppodgorsek/ansible-awx-cli/issues).