Skip to content

lennysh/aap-ee-version-matrix

Repository files navigation

Red Hat Ansible Automation Platform Execution Environment Version Matrix

GitHub last commit GitHub license Contributions welcome GitHub contributors GitHub Issues or Pull Requests

This repository is a community-driven version matrix for Red Hat Ansible Automation Platform (AAP) Execution Environments (EEs). It provides a quick reference for the package versions (ansible-core, python), included Ansible Collections, and OS details for each official EE image.

📋 Available Execution Environments

The tables below are automatically generated. Click on an image name to see detailed information about its contents.

Image Name (Click for more details)
registry.redhat.io/ansible-automation-platform/ee-minimal-rhel8
registry.redhat.io/ansible-automation-platform/ee-minimal-rhel9
registry.redhat.io/ansible-automation-platform-24/ee-minimal-rhel8
registry.redhat.io/ansible-automation-platform-24/ee-minimal-rhel9
registry.redhat.io/ansible-automation-platform-24/ee-supported-rhel8
registry.redhat.io/ansible-automation-platform-24/ee-supported-rhel9
registry.redhat.io/ansible-automation-platform-25/ee-minimal-rhel8
registry.redhat.io/ansible-automation-platform-25/ee-minimal-rhel9
registry.redhat.io/ansible-automation-platform-25/ee-supported-rhel8
registry.redhat.io/ansible-automation-platform-25/ee-supported-rhel9
registry.redhat.io/ansible-automation-platform-26/ee-minimal-rhel9
registry.redhat.io/ansible-automation-platform-26/ee-supported-rhel9
registry.redhat.io/ansible-automation-platform-27/ee-minimal-rhel9
registry.redhat.io/ansible-automation-platform-27/ee-supported-rhel9
registry.redhat.io/ansible-automation-platform-tech-preview/ee-minimal-rhel8
registry.redhat.io/ansible-automation-platform-tech-preview/ee-minimal-rhel9

🛠 Updating the version matrix

The tables above are generated from Ansible vars files. Do not edit images/**/README.md directly — run the playbooks below instead.

Prerequisites

  • Ansible 2.15+ with the community.general collection
  • podman and skopeo on your PATH
  • Access to registry.redhat.io (podman login registry.redhat.io)

Workflow

Run from the repository root:

# 1. Discover registry tags/digests and write/update per-digest vars files
ansible-playbook image_inspector.yml --tags discover

# 2. (Optional) Pull images and inspect package/collection contents — slow
ansible-playbook image_inspector.yml --tags discover,details

# 3. Regenerate README.md for each image path from the vars files
ansible-playbook md_generator.yml

Discover (--tags discover) queries the registry and writes one Ansible vars file per digest to images/<image_path>/vars/<digest-hex>.yml with digest, image_tags, and created. It is safe to run regularly to pick up new tags.

Details (--tags details) pulls each digest with podman, runs inspection commands inside the container, and fills in ansible_core_version, collections, RPM/pip lists, etc. Only digests missing data or with prior failures are re-inspected.

Markdown generation reads all vars/*.yml files under each image path and writes images/<image_path>/README.md.

Common options

# Drop digest vars files that no longer exist in the registry
ansible-playbook image_inspector.yml --tags discover -e prune_images=true

# Single image path for this run
ansible-playbook image_inspector.yml --tags discover \
  -e '{"image_inspector_image_paths": ["registry.redhat.io/ansible-automation-platform/ee-minimal-rhel8"]}'

# Validate no duplicate tags across digests
python3 scripts/check_duplicate_tags.py

See also:

🤝 Contributing

Contributions are highly encouraged! If you find a mistake or have an update for a new release, please help improve this resource.

To add or update an execution environment:

  1. Add the image path to image_inspector_image_paths in roles/image_inspector/defaults/main.yml (if not already listed).
  2. Run the workflow above (discover, optionally details, then md_generator).
  3. Submit a pull request with the updated vars files and generated READMEs.

To contribute, please submit a pull request with your changes to the Ansible roles, playbooks, and generated data under images/. Do not edit the Markdown files in the images/ directory by hand, as they are regenerated by md_generator. Manual edits to those READMEs will be overwritten and should not be submitted alone.

✍️ Authors

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.

About

No description, website, or topics provided.

Resources

License

Stars

6 stars

Watchers

1 watching

Forks

Contributors