README.md

Ansible Tower roles

This directory contains various roles to install, configure and manage Ansible Tower.

Requirements

• For Install: Access to the Ansible Tower software and an Ansible Tower license.
• For Management: Access to a running Ansible Tower with admin permissions.

Variables

The following is a list of required variables for the Ansible Tower roles that are common to all of them.

Variable	Description	Required	Defaults
ansible_tower.url	URL for the Ansible Tower	no	https://localhost
ansible_tower.admin_user	Admin user for the Ansible Tower	no	admin
ansible_tower.admin_password	Admin password for the Ansible Tower	yes
ansible_tower.validate_certs	Wheter or not to validate Ansible Tower SSL Certificate, use false when using not trusted certificates	no	true

Note: You should ensure that the ansible_tower.url variable that is being used is not being redirected (i.e. redirected from http -> https, etc.). If there are concerns with how you're getting/setting this URL, you can use the discover-url-redirect role found in this repo.

Roles

The following roles exists in this directory:

• config-ansible-tower role used to install and do initial configuration of Ansible tower.
• config-ansible-tower-ldap role used to configure Ansible Tower to use a LDAP backend for authentication.
• config-ansible-tower-license role used to configure Ansible Tower licensing.
• config-ansible-tower-subscription-manifest role used to configure Ansible Tower subscription.
• manage-credential-types role used to manage and populate Ansible Tower Credential Types ("Settings >> Credential Types").
• manage-credentials role used to manage and populate Ansible Tower Credentials ("Settings >> Credentials").
• manage-inventories role used to manage and populate Ansible Tower Inventories ("Inventories").
• manage-job-templates role used to manage and populate Ansible Tower Job Templates ("Templates >> ADD >> Job Templates").
• manage-projects role used to manage and populate Ansible Tower Projects ("Projects").
• manage-settings role used to manage and configure Ansible Tower Settings ("Settings").
• manage-workflow-templates role used to manage and Ansible Tower WorkFlow templates. ("WorkFlow").
• wait-for-tower-to-be-ready role used to wait for Tower to be ready.

Example Inventory

---

ansible_tower:
  url: https://tower.example.com
  admin_user: 'admin'
  admin_password: 'password'
  install:
    : # see config-ansible-tower README for more details
  ldap:
    : # see config-ansible-tower-ldap README for more details
  license:
    : # see config-ansible-tower-license README for more details
  credential-types:
    : # see manage-credential-types README for more details
  credentials:
    : # see manage-credentials README for more details
  inventories:
    : # see manage-inventories README for more details
  job-templates:
    : # see manage-job-templates README for more details
  projects:
    : # see manage-projects README for more details
  settings:
    : # see manage-settings README for more details
  workflow-templates:
    : # see manage-workflow-templates README for more details

License

Apache License 2.0

Author Information

Red Hat Community of Practice & staff of the Red Hat Open Innovation Labs.