geerlingguy.awx

Ansible Role: AWX (Open Source Ansible Tower)

DEPRECATED: This role is no longer recommended. Installing AWX has changed a lot since this role was first made, and it keeps changing. Please use the official installation guide, and if you need automation, consider the awx-operator.

This role helps install and set up AWX, which is the open source version of Ansible Tower.

Requirements

To use this role to completely set up AWX with its installer, you need to make sure the following dependencies are installed:

Dependency	Suggested Role
EPEL repo (for RedHat OSes)	`geerlingguy.repo-epel`
Git	`geerlingguy.git`
Ansible	`geerlingguy.ansible`
Docker	`geerlingguy.docker`
Python Pip	`geerlingguy.pip`
Node.js (version 10.x)	`geerlingguy.nodejs`

Check the role's molecule/default/converge.yml playbook for an example that works on different operating systems.

Role Variables

Here are the variables you can use, along with their default values (found in defaults/main.yml):

awx_repo: https://github.com/ansible/awx.git
awx_repo_dir: "~/awx"
awx_version: devel
awx_keep_updated: true

These variables are used to decide what version of AWX to install.

awx_run_install_playbook: true

By default, this role will run the AWX installation playbook, which sets up the necessary containers. You can stop the playbook from running 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