ansible-role-awx
Configures AWX on a server.
Requirements
- Ansible >= 2.4
Install
Install from GitHub
ansible-galaxy install git+https://github.com/joshuacherry/ansible-role-awx.git
Features
- Web-based user interface
- REST API
- Ansible Task Engine
OS | |
---|---|
Ubuntu 16.04 | ✓ |
Centos 7 | ✓ |
Versioning
For the versions available, see the tags on this repository.
Additionaly you can see what change in each version in the CHANGELOG.md file.
Role variables
Look to the defaults properties file to see the possible configuration properties.
Testing
This role includes a Vagrantfile used with a Docker-based test harness for integration testing. Using Vagrant allows all contributors to test on the same platform and avoid false test failures due to untested or incompatible docker versions.
- Install Vagrant and VirtualBox.
- Run
vagrant up
from the same directory as the Vagrantfile in this repository. - SSH into the VM with:
vagrant ssh
- Run tests with
molecule
.
Testing with Docker and molecule
cd /ansible-role-awx
molecule test
See molecule
for more information including a full list of available commands.
interactive debugging
You can use log into a docker image created by molecule for interactive testing with the below commands.
cd /ansible-role-awx
molecule converge
# Ubuntu
docker exec -it ubuntu /bin/bash
# CentOS
docker exec -it centos /bin/bash
Example Playbook
---
- name: Playbook for ansible-role-awx
hosts: all
tasks:
- include_role:
name: ansible-role-awx
vars:
awx_inv_awx_official: true
cleanup_docker_base: false