AnsiblePilot — Master Ansible Automation

AnsiblePilot is the leading resource for learning Ansible automation, DevOps, and infrastructure as code. Browse over 1,400 tutorials covering Ansible modules, playbooks, roles, collections, and real-world examples. Whether you are a beginner or an experienced engineer, our step-by-step guides help you automate Linux, Windows, cloud, containers, and network infrastructure.

Popular Topics

About Luca Berton

Luca Berton is an Ansible automation expert, author of 8 Ansible books published by Apress and Leanpub including "Ansible for VMware by Examples" and "Ansible for Kubernetes by Example", and creator of the Ansible Pilot YouTube channel. He shares practical automation knowledge through tutorials, books, and video courses to help IT professionals and DevOps engineers master infrastructure automation.

AAP 2.6 Tested Deployment Models: Growth & Enterprise Topologies Guide

By Luca Berton · Published 2024-01-01 · Category: installation

Complete guide to AAP 2.6 tested deployment models and reference architectures. Covers container growth and enterprise topologies, OpenShift operator.

Red Hat tests Ansible Automation Platform 2.6 against specific deployment topologies — use these reference architectures for supported, production-ready deployments. Choose between growth topologies (single-node, resource-efficient) and enterprise topologies (multi-node, redundant).

Deployment Models Overview

ModeInfrastructureTopologies
ContainersVMs / Bare metal (Podman)Growth, Enterprise
OperatorRed Hat OpenShiftGrowth, Enterprise
RPM (deprecated)VMs / Bare metalGrowth, Enterprise

Container Growth Topology

Best for: Organizations getting started, development environments, or resource-constrained deployments.

All AAP components run on a single VM:

┌─────────────────────────────┐
│        Single RHEL Host     │
│                             │
│  ┌──────────────────────┐   │
│  │  Platform Gateway    │   │
│  ├──────────────────────┤   │
│  │  Automation Controller│  │
│  ├──────────────────────┤   │
│  │  Automation Hub      │   │
│  ├──────────────────────┤   │
│  │  Event-Driven Ansible│   │
│  ├──────────────────────┤   │
│  │  PostgreSQL Database │   │
│  ├──────────────────────┤   │
│  │  Redis (standalone)  │   │
│  └──────────────────────┘   │
└─────────────────────────────┘

System Requirements

ResourceMinimum
RAM16 GB (32 GB with hub_seed_collections=true)
CPUs4
Disk60 GB total (15 GB install dir, 1-3 GB /var/tmp, 10 GB temp for bundled)
Disk IOPS3000
OSRHEL 9.4+ or RHEL 10+

Inventory Groups

PurposeGroup Names
All componentsautomationgateway, automationcontroller, automationhub, automationeda, database
All groups point to the same host.

See also: AAP 2.6 Install Guide: Containerized, RPM & OpenShift Methods (2026)

Container Enterprise Topology

Best for: Production deployments requiring high availability, redundancy, and scalability.

Components distributed across multiple VMs:

┌──────────────┐  ┌──────────────┐
│  Gateway 1   │  │  Gateway 2   │
└──────┬───────┘  └──────┬───────┘
       │                 │
┌──────┴─────────────────┴───────┐
│         Load Balancer          │
└──────┬─────────────────┬───────┘
       │                 │
┌──────┴───────┐  ┌──────┴───────┐
│ Controller 1 │  │ Controller 2 │
└──────────────┘  └──────────────┘
       │                 │
┌──────┴───────┐  ┌──────┴───────┐
│  Hub Node    │  │  EDA Node    │
└──────────────┘  └──────────────┘
       │                 │
┌──────┴─────────────────┴───────┐
│       PostgreSQL Database      │
│    (external or dedicated)     │
└────────────────────────────────┘

Additional Requirements

  • Multiple VMs for redundancy
  • External load balancer
  • Redis in cluster mode
  • Dedicated database server recommended
  • Receptor mesh for execution nodes

OpenShift Operator Topologies

Operator Growth Topology

Single namespace deployment on OpenShift — suitable for development and small teams.

Operator Enterprise Topology

Multi-namespace or multi-cluster deployment with:

  • Separate namespaces for controller, hub, and EDA
  • Horizontal pod autoscaling
  • External PostgreSQL for data durability
  • Multi-AZ deployment for HA

RPM Topologies (Deprecated)

⚠️ Only for RHEL 9 during AAP 2.6 lifecycle to support migrations. Will be removed in AAP 2.7.

Same growth/enterprise patterns as containerized, but installed directly via RPM packages instead of Podman containers.

Network Port Requirements

All topologies require these ports:

Platform Communication

PortProtocolFrom → ToPurpose
80/443TCPGateway → ControllerPlatform API
80/443TCPGateway → HubCollection/image access
80/443TCPGateway → EDAEvent routing
80/443TCPEDA → ControllerLaunch jobs
80/443TCPEDA → HubPull decision environments
80/443TCPController → HubPull collections & EEs

Database & Infrastructure

PortProtocolFrom → ToPurpose
5432TCPAll components → DatabasePostgreSQL
6379TCPEDA/Gateway → RedisData storage
27199TCPController → Execution nodesReceptor mesh

Component NGINX Ports

PortComponentConfigurable Via
8080/8443Controllercontroller_nginx_http_port, controller_nginx_https_port
8081/8444Hubhub_nginx_http_port, hub_nginx_https_port
8082/8445EDAeda_nginx_http_port, eda_nginx_https_port
8083/8446Gatewaygateway_nginx_http_port, gateway_nginx_https_port

Supported Configurations

SettingSupported Options
OSRHEL 9.4+, RHEL 10+
CPU Architecturex86_64, AArch64, s390x, ppc64le
ansible-core2.14 (RHEL 9), 2.16 (RHEL 10)
DatabasePostgreSQL 15 (managed), 15/16/17 (external)
IP VersionIPv4, IPv6 (single-stack and dual-stack)
BrowserCurrent Firefox or Chrome

Choosing Your Topology

Use Growth When:

  • Evaluating or testing AAP
  • Small team (< 20 users)
  • Budget-constrained
  • Development/staging environment
  • < 100 managed hosts

Use Enterprise When:

  • Production workloads
  • High availability required
  • Multiple teams sharing the platform
  • Compliance requirements (audit trails, separation)
  • 100+ managed hosts
  • 24/7 uptime expectations

Database Considerations

Managed (Installer-Controlled)

  • PostgreSQL 15 installed and managed by the AAP installer
  • Backup/restore handled by AAP tools
  • Simplest option for growth topology

External (Customer-Provided)

  • PostgreSQL 15, 16, or 17
  • ICU support must be enabled (not default on AWS RDS, Azure SQL, EDB)
  • PostgreSQL 16/17 must handle backup/restore independently
  • Required for enterprise topology with dedicated DB servers

FAQ

Can I use a topology not listed by Red Hat?

Yes, but Red Hat only provides "commercially reasonable support" for non-tested topologies. Stick to tested topologies for production environments to ensure full support coverage.

Can I start with growth and migrate to enterprise later?

Yes. Start with the growth topology and scale to enterprise as your needs grow. The migration involves adding nodes and redistributing components — the AAP installer handles this.

Do I need a load balancer for growth topology?

No. Growth topology runs everything on a single host. A load balancer is only needed for enterprise topology with multiple gateway or controller nodes.

What's the minimum for a production deployment?

Red Hat recommends the enterprise topology for production. At minimum: 2 gateway nodes (HA), 2 controller nodes, 1 hub, 1 EDA controller, 1 dedicated database server. Total: 7 VMs.

See also: Deploy and Configure the MCP Server for Ansible Automation Platform: Complete Guide (Containerized and OpenShift)

Conclusion

Use the container growth topology for getting started and development. Deploy the container enterprise topology for production. OpenShift operator for cloud-native organizations. Avoid new RPM installations — they're deprecated and will be removed in AAP 2.7.

Category: installation

Browse all Ansible tutorials · AnsiblePilot Home