Installs and configures AWX, the open source version of Ansible Tower.
Before this role runs, assuming you want the role to completely set up AWX using it's included installer, you need to make sure the following AWX dependencies are installed:
Dependency | Suggested Role |
---|---|
EPEL repo (RedHat OSes only) | geerlingguy.repo-epel |
Git | geerlingguy.git |
Ansible | geerlingguy.ansible |
Docker | geerlingguy.docker |
Python Pip | geerlingguy.pip |
Node.js (6.x) | geerlingguy.nodejs |
See this role's tests/test.yml
playbook for an example that works across many different OSes.
Available variables are listed below, along with default values (see defaults/main.yml
):
awx_repo: https://github.com/ansible/awx.git
awx_repo_dir: "~/awx"
awx_version: devel
awx_keep_updated: yes
Variables to control what version of AWX is checked out and installed.
awx_run_install_playbook: yes
By default, this role will run the installation playbook included with AWX (which builds a set of containers and runs them). You can disable the playbook run by setting this variable to no
.
None.
- hosts: awx-centos
become: yes
vars:
nodejs_version: "6.x"
pip_install_packages:
- name: docker-py
roles:
- geerlingguy.repo-epel
- geerlingguy.git
- geerlingguy.ansible
- geerlingguy.docker
- geerlingguy.pip
- geerlingguy.nodejs
- geerlingguy.awx
After AWX is installed, you can log in with the default username admin
and password password
.
MIT / BSD
This role was created in 2017 by Jeff Geerling, author of Ansible for DevOps.