Ansible on Clouds Controller Setup and Configuration

This collection contains playbooks and roles that demonstrate using configuration-as-code to declare the setup and configuration for Ansible Automation Controller. This approach to Ansible Automation Controller configuration provides an easy-to-read and manage deployment model and keeps your Ansible Automation Controller configuration portable between different AAP deployments.

Included Content

Roles

Click on the role name to be directed to the README specifically for that role.

Name	Description
lab.ansible_controller_config.azure	Role that deploys a demo configuration of job templates, projects, inventories, etc.

Playbooks

Name	Role(s) Used	Description
lab.ansible_controller_config.configure_aap_azure.yml	lab.ansible_controller_config.azure	A playbook that runs the AAP on Azure configuration role.

Running Configure AAP Azure

Run the lab.ansible_controller_config.configure_aap_azure.yml playbook with ansible_navigator from the root directory of this repository. The role expects that there is an ssh key called id_rsa_azure_demo that exists in your ~/.ssh directory. The following command maps that folder into the EE container for access to that key and its public key.

ansible-navigator run playbooks/configure_aap_azure.yml \
--pae false \
--mode stdout \
--eei quay.io/scottharwell/cloud-ee:latest \
--eev $HOME/.ssh:/home/runner/.ssh \
--penv CONTROLLER_HOST \
--penv CONTROLLER_USERNAME \
--penv CONTROLLER_PASSWORD \
--penv AZURE_TENANT_ID \
--penv AZURE_SUBSCRIPTION_ID \
--penv AZURE_CLIENT_ID \
--penv AZURE_CLIENT_SECRET \
--penv RED_HAT_ACCOUNT \
--penv RED_HAT_PASSWORD \
--extra-vars "ssh_public_key={{ lookup('file','~/.ssh/id_rsa_azure_demo.pub') }}"

Installation and Usage

Installing the Collection with the Ansible Galaxy CLI

Before using the this collection, you need to install it with the Ansible Galaxy CLI:

ansible-galaxy collection install git+https://github.com/ansible-content-lab/lab.ansible_controller_config.git

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

---
collections:
  - name: https://github.com/ansible-content-lab/lab.ansible_controller_config
    type: git
    version: main

Playbook Use

This collection is not available on Ansible Galaxy, so you will need to have it available for a playbook either through an Execution Environment or manual installation. Once available, referencing the role happens just like any other Ansible role.

- hosts: localhost
  roles:
    - role: lab.ansible_controller_config.aoc_demo_setup

License

GPLv3

Author

This role was originally written by Scott Harwell and Hicham Mourad from the Ansible team at Red Hat.