APD - Ansible Product Demos

The Ansible Product Demos (APD) project is a set of Ansible demos that run on the Red Hat Ansible Automation Platform (AAP). These demos are deployed using configuraton-as-code and playbooks that create AAP resources (such as projects, templates, and credentials) meant for demonstrating automation use cases in several technology domains:

Demo Name	Description
Linux	Repository of demos for RHEL and Linux automation
Windows	Repository of demos for Windows Server automation
Cloud	Demo for infrastructure and cloud provisioning automation
Network	Network automation demos
OpenShift	OpenShift automation demos
Infrastructure	Infrastructure provisioning demos (ROSA cluster lifecycle, etc.)
Satellite	Demos of automation with Red Hat Satellite Server

Demo catalog

Browse all demos, presenter guides, and walkthroughs on the Ansible Product Demos — GitHub Pages site.

Installation

APD can be added to an existing AAP deployment by running the installation playbook. It relies on the APD execution environment image for access to the modules and roles used to apply configuration-as-code to AAP.

Installing with the installation playbook

1. Clone this repository
2. Set the following environment variables for authentication to your AAP deployment:

export AAP_HOSTNAME=https://your-aap-server.example.com

# either set AAP_USERNAME and AAP_PASSWORD for password auth to AAP
export AAP_USERNAME=admin  # or another AAP account with superuser privileges
export AAP_PASSWORD=<admin_user_password>

# or alternately set AAP_TOKEN if you have an admin token
#export AAP_TOKEN=<admin_user_token>

3. Use ansible-navigator to run the installation playbook using the APD execution environment image. The ansible-navigator program must be installed as a prerequisite, either from the AAP package repository or from the upstream ansible-dev-tools PyPI package.

ansible-navigator run -m stdout install-apd.yml

Note

The execution environment used with the install-apd.yml playbook must match the version of the AAP deployment where APD is being installed. The ansible-navigator configuration defaults to the EE image aligned with AAP 2.6. To install on an AAP 2.7 deployment, use the --eei option to use the related EE image:

ansible-navigator run -m stdout install-apd.yml \
    --eei quay.io/ansible-product-demos/apd-ee-27:latest

Quick-start one-liner (no environment variables needed)

You can pass all credentials directly as extra vars instead of exporting environment variables. This is useful for a quick setup or when running from a shared machine:

ansible-navigator run install-apd.yml \
  --eei quay.io/ansible-product-demos/apd-ee-27:latest \
  -e aap_hostname=https://your-aap-server.example.com \
  -e aap_username=admin \
  -e aap_password='your-password' \
  -e '{"aap_validate_certs": false}' \
  -m stdout

Important

If your AAP deployment uses self-signed or untrusted TLS certificates, aap_validate_certs must be set to the boolean false (not the string "false"). Use the JSON syntax shown above: -e '{"aap_validate_certs": false}'

Use a pre-installed APD environment on the Red Hat Demo Platform (account required)

For Red Hat associates and partners, there is an Ansible Product Demos catalog item available on demo.redhat.com that provides a pre-installed environment for demo purposes. An existing account is required for access to the Red Hat Demo Platform system.

Bring Your Own Demo

Can't find what you're looking for? Customize this repo to make it your own.

1. Create a fork of this repo.
2. Update the URL of the Ansible Project Demos project your Ansible Automation Platform controller.
3. Make changes to your fork as needed and run the Product Demos | Single demo setup job

See the contributing guide for more details on how to customize the project.

---

Privacy statement | Terms of use | Security disclosure | All policies and guidelines