README.md

Ansible Role: AWX (open source Ansible Tower)

DEPRECATED: This role has been deprecated. AWX installation is a lot different than it was when I first created the role, and continues evolving. Please follow the official install guide and if you need automation around it, please consider the awx-operator.

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 (10.x)	geerlingguy.nodejs

See this role's molecule/default/converge.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: true

Variables to control what version of AWX is checked out and installed.

awx_run_install_playbook: true

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 false.

Dependencies

None.

Example Playbook

- hosts: awx-centos
  become: true

  vars:
    nodejs_version: "10.x"
    docker_install_compose: false
    pip_install_packages:
      - name: docker
      - name: docker-compose

  roles:
    - geerlingguy.repo-epel
    - geerlingguy.git
    - geerlingguy.pip
    - geerlingguy.ansible
    - geerlingguy.docker
    - geerlingguy.nodejs
    - geerlingguy.awx

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

License

MIT / BSD

Author Information

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