Ansible Role: AWX (open source Ansible Tower)

Installs and configures AWX, the open source version of Ansible Tower.

Requirements

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.

Role Variables

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
awx_secret_key: awxsecret
pg_password: awxpass
default_admin_user: admin
default_admin_password: password
awx_host_port: 3001
postgres_data_dir: /opt/awx/pgdocker

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.

Dependencies

None.

Example Playbook

- 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
    - rndmh3ro.awx

After AWX is installed, you can log in with the default username admin and password password.

License

MIT / BSD

Author Information

Author:: Sebastian Gumprich

This role was created in 2017 by Jeff Geerling, author of Ansible for DevOps.