/aap_utilities

Ansible Collection for roles and other objects for general use with Tower

Primary LanguageYAML

Red Hat Communities of Practice Tower Utilities Collection

Ansible Lint Galaxy Release

This ansible collection includes a number of roles which can be useful for installing and managing AWX or Ansible Tower. Using this collection, you'll be able to automate following tasks:

  • prepare and install Tower (on a normal OS, or on OpenShift)
  • configure the OS to support Kerberos (if you plan to manage Windows hosts using AD credentials)
  • backup and restore Ansible Tower
  • install a minimal Git repo over SSH, for demonstration and learning purposes

Included content

Click the Content button to see the list of content included in this collection.

Installing this collection

You can install the redhat_cop aap_utilities collection with the Ansible Galaxy CLI:

ansible-galaxy collection install redhat_cop.aap_utilities

You can also include it in a requirements.yml file and install it with ansible-galaxy collection install -r requirements.yml, using the format:

---
collections:
  - name: redhat_cop.aap_utilities
    # If you need a specific version of the collection, you can specify like this:
    # version: ...

Using this collection

See Also:

Release and Upgrade Notes

Many roles and variables have been renamed to reflect the product renaming from Tower to controller/AAP. Verify carefully your inventory variables and playbooks.

The OCP installation role has been suppressed due to the introduction of an operator. Further (community) automation for AAP on OCP is available from the https://github.com/redhat-cop/gitops-catalog/tree/main/ansible-automation-platform[GitOps catalogue].

Roadmap

Contributing to this collection

We welcome community contributions to this collection. If you find problems, please open an issue or create a PR against the Tower/AAP Utilities collection repository. More information about contributing can be found in our Contribution Guidelines.

Licensing

GNU General Public License v3.0 or later.

See LICENCE to see the full text.