/ansible-role-awx

Ansible Role - AWX

Primary LanguageShellMIT LicenseMIT

Ansible Role: AWX (open source Ansible Tower)

Build Status

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

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