Skip to content

feat: migrate to ansible-navigator with Red Hat EE#168

Open
chadmf wants to merge 1 commit into
ericcames:mainfrom
chadmf:navigator
Open

feat: migrate to ansible-navigator with Red Hat EE#168
chadmf wants to merge 1 commit into
ericcames:mainfrom
chadmf:navigator

Conversation

@chadmf

@chadmf chadmf commented Jun 15, 2026

Copy link
Copy Markdown

Closes #167

Summary

Replace local collection installation with ansible-navigator using Red Hat supported Execution Environment registry.redhat.io/ansible-automation-platform-26/ee-supported-rhel9:latest.

Benefits

  • Consistency: Same container locally and in AAP production
  • Red Hat support: Certified collections in tested combinations
  • Zero collection management: No ansible-galaxy install required
  • Dev-prod parity: Identical execution environment
  • Security: Red Hat scans and patches container images

Changes

New Files

  • ansible-navigator.yml — Navigator config with EE image, volume mounts, env passthrough
  • scripts/bootstrap.sh — Bootstrap wrapper with validation and token extraction

Updated Files

  • ansible.cfg — Removed collections_path, moved Automation Hub token to env var lookup
  • CLAUDE.md — Updated prerequisites and bootstrap workflow for navigator
  • .gitignore — Exclude navigator artifacts (ansible-navigator.log, playbook-artifacts/)
  • CHANGELOG.md — Documented migration

Migration Steps

# 1. Authenticate to Red Hat registry
podman login registry.redhat.io

# 2. Pull EE image
podman pull registry.redhat.io/ansible-automation-platform-26/ee-supported-rhel9:latest

# 3. Install ansible-navigator
pip install ansible-navigator

# 4. Run bootstrap
ansible-navigator run playbooks/bootstrap_dev.yml \
  -i inventories/rhdp-<customer>-<demo>/ \
  --mode stdout

# Or use wrapper script
./scripts/bootstrap.sh rhdp-<customer>-<demo>

Testing

Tested bootstrap workflow with navigator on sample inventory — all modules resolve correctly from pre-installed collections in EE image.

Follow-up

Separate PR needed for ericcames/aap-skills to update:

  • aap-first-time skill
  • aap-bootstrap skill
  • aap-setup-demo skill

)

Replace local collection installation with ansible-navigator using
registry.redhat.io/ansible-automation-platform-26/ee-supported-rhel9:latest.

Collections now pre-installed in EE image — no ansible-galaxy install required.

Benefits:
- Consistency: same container locally and in AAP
- Red Hat support: certified collections in tested combinations
- Zero collection management overhead
- Dev-prod parity: identical execution environment

Changes:
- Add ansible-navigator.yml config with volume mounts and env passthrough
- Add scripts/bootstrap.sh wrapper with validation and token extraction
- Remove collections_path from ansible.cfg
- Move Automation Hub token to env var lookup (remove hardcoded token)
- Update CLAUDE.md prerequisites and bootstrap workflow
- Update .gitignore for navigator artifacts

Migration path:
1. podman login registry.redhat.io
2. podman pull registry.redhat.io/ansible-automation-platform-26/ee-supported-rhel9:latest
3. pip install ansible-navigator
4. Run bootstrap: ansible-navigator run playbooks/bootstrap_dev.yml -i inventories/<name>/

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Migrate from ansible-galaxy to ansible-navigator with Red Hat EE

1 participant