Skip to content

Add comprehensive AAP 2.6 components reference and advanced configuration#36

Merged
chadmf merged 3 commits into
mainfrom
components-update
Apr 3, 2026
Merged

Add comprehensive AAP 2.6 components reference and advanced configuration#36
chadmf merged 3 commits into
mainfrom
components-update

Conversation

@chadmf

@chadmf chadmf commented Apr 3, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Adds comprehensive deployment reference for all AAP 2.6 components
  • Clarifies that default deployment includes Gateway, Controller, Hub, and EDA
  • Provides advanced HA configuration example
  • Documents database architecture, requirements, and troubleshooting

New Documentation

📚 AAP Components Reference (19KB)

File: docs/aap-components-reference.md

Complete deployment guide covering:

  • Database Architecture: 4 databases on 1 PostgreSQL instance architecture
  • Component Overview: Gateway, Controller, Hub, EDA deployment patterns
  • Critical Requirements: Hub RWX storage, hstore extension, resource limits
  • Verification Procedures: Commands to verify all components are running
  • Troubleshooting: Common deployment issues and solutions
  • Scaling Guidance: Resource sizing and replica configuration

⚙️ Advanced Configuration Example (8.3KB)

File: aap-deploy/openshift/ansibleautomationplatform-advanced.yaml

Production-ready HA configuration including:

  • Replica counts for all components (Gateway: 2, Controller web: 3, etc.)
  • Resource requests and limits for all pods
  • Worker scaling examples
  • S3 storage alternative for Hub (instead of RWX PVC)
  • Node affinity and tolerations for pod placement
  • Platform-wide idle mode for DR scenarios
  • Comprehensive inline documentation

Documentation Updates

Clarified Default Deployment

Files: aap-deploy/README.md, aap-deploy/openshift/README.md

Added "What gets deployed" sections explaining:

  • Default configuration deploys the complete AAP 2.6 platform
  • Includes all four components: Gateway, Controller, Hub, EDA
  • References deployment guide for configuration details
  • Links to Red Hat docs for component capabilities

Documentation Index

File: docs/INDEX.md

  • Added to "Deployment Guides" section
  • Added to "Operations & Management" section
  • Listed in "Recent Additions"

Key Improvements

Clarifies Scope: Default deployment is the full platform, not minimal installation
Database Architecture: Documents 4-database-on-1-instance pattern
Critical Requirements: Hub needs RWX storage and hstore extension
Verification: Commands to check each component's status
Troubleshooting: Common issues with solutions
HA Configuration: Production-ready example with replicas and resources

What's Already Working

The infrastructure already supports all four components:

  • ✅ Database script creates all 4 databases (platform_gateway, automation_controller, automation_hub, automation_eda)
  • ✅ Secret generation creates all 4 secrets
  • ✅ hstore extension already in SQL bootstrap script
  • ✅ Parent CR already references all components

This PR documents the complete platform deployment that was already supported.

File Changes

5 files changed, 876 insertions(+), 5 deletions(-)
  • New: docs/aap-components-reference.md (628 lines)
  • New: aap-deploy/openshift/ansibleautomationplatform-advanced.yaml (248 lines)
  • Updated: aap-deploy/README.md (+2 lines)
  • Updated: aap-deploy/openshift/README.md (+19 lines)
  • Updated: docs/INDEX.md (+12 lines)

References

🤖 Generated with Claude Code

chadmf and others added 3 commits April 3, 2026 16:40
- Add comprehensive AAP 2.6 deployment documentation with external PostgreSQL
- Document troubleshooting steps for namespace, database, and encryption issues
- Create symlink from .claude/skills to .cursor/skills for skill sharing
- Update reports README with new deployment report entry

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Improves AAP 2.6 deployment documentation to explicitly reference the
AnsibleAutomationPlatform parent CR pattern required in 2.6, replacing
outdated references to individual component CRs.

Changes:
- Update aap-deploy/README.md to show all four component secret paths
- Update postgres-configuration-secret.example.yaml with parent CR references
- Add inline comment explaining target_session_attrs parameter
- Add comprehensive AAP 2.6 deployment validation report
- Add executive summary validation report

All changes ensure 100% compliance with Red Hat AAP 2.6 documentation
and improve clarity for users deploying with external PostgreSQL.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
…figuration

Adds complete deployment documentation for all AAP 2.6 components (Gateway,
Controller, Hub, EDA) with external PostgreSQL configuration. Clarifies that
the default deployment includes the full platform, not just minimal components.

New files:
- docs/aap-components-reference.md: Comprehensive deployment guide covering
  database architecture, critical requirements, verification procedures,
  troubleshooting, and scaling guidance (19KB)
- aap-deploy/openshift/ansibleautomationplatform-advanced.yaml: HA
  configuration example with replicas, resource limits, S3 storage,
  node affinity, and DR idle mode (8.3KB)

Updated files:
- aap-deploy/README.md: Added "What gets deployed" section clarifying
  complete platform deployment
- aap-deploy/openshift/README.md: Added component overview and reference
  to deployment guide
- docs/INDEX.md: Added new guide to deployment and operations sections

Key documentation improvements:
- Database architecture: 4 databases on 1 PostgreSQL instance
- Hub requirements: RWX storage class and hstore extension
- Component verification: Commands to check all components
- Troubleshooting: Common deployment issues and solutions
- Advanced configuration: HA setup, resource sizing, S3 storage

All documentation focuses on deployment-specific configuration and
references Red Hat docs for component capabilities and usage.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@chadmf chadmf merged commit 36329e2 into main Apr 3, 2026
18 checks passed
@chadmf chadmf deleted the components-update branch April 3, 2026 23:21
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.

1 participant