Skip to navigation Skip to main content

Search

Content extracted on: 2026-09-15

Home
Product Documentation
Red Hat Ansible Automation Platform
2.6
Plan your migration
Plan your migration

What's new

Release notes
Patch releases
Technology Preview

Discover

What is Ansible Automation Platform
Ansible components
Automate Microsoft Windows with Ansible Automation Platform

Get started

Get started automating with playbooks
Get started as a platform administrator
Get started as an automation developer
Get started as an automation operator

Plan

Choose a deployment method and topology
Overview of the Redis cache and queueing system
Establish a well architected environment
Plan your deployment using Ansible on Clouds

Install

Install containerized Ansible Automation Platform
Install on OpenShift Container Platform
Install RPM-based Ansible Automation Platform
Activate your subscription
Set up your development environment
Install Ansible plug-ins for Red Hat Developer Hub
Deploy Ansible automation portal RHEL appliance
Install automation portal on OpenShift Container Platform
1. Install Ansible automation portal (OpenShift Container Platform only)
Automation dashboard deployment options
1. Install the standalone automation dashboard utility to calculate savings (RHEL only)
Install Ansible Builder to create or edit execution environments
Install with Ansible on Clouds

Upgrade

Plan your upgrade to Ansible Automation Platform 2.6
Supported upgrade and migration scenarios
Infrastructure changes for container-based deployments
Infrastructure changes for Operator-based deployments
Infrastructure changes for RPM deployments
Identity and access management migration during upgrade
Authentication provider migration behavior
API changes for automation platform
Upgrade your containerized deployment of Ansible Automation Platform
Upgrade your Operator-based deployment of Ansible Automation Platform
Upgrade your RPM deployment of Ansible Automation Platform
1. Upgrade Ansible Automation Platform
2. Mixed-version upgrades with pre-gateway components
Upgrade Ansible automation portal
Upgrade Ansible plug-ins for Red Hat Developer Hub
Upgrade the standalone automation dashboard utility

Migrate

Migrate from existing deployment topologies
Out of scope
Migration approaches and workflow
Plan your migration
1. Plan your migration from RPM-based Ansible Automation Platform
2. Plan your migration from containerized Ansible Automation Platform
Migration prerequisites
What the aap_snapshot migration artifact contains
Prepare and export data from the source environment
Prepare, configure, and validate the target environment

Administer

Define automation target hosts in your inventory files
Define where automation runs with host and node groupings
Scale automation across your infrastructure with automation mesh
1. Deprovision individual nodes or groups
Scale with automation mesh in an operator environment
Scale with automation mesh in a containerized or VM environment
1. Edit the inventory file
2. Design patterns for mesh
Back up and restore your containerized deployment
Back up and restore in an OpenShift environment
Back up and restore your RPM deployment
Define, create, and build execution environments
Manage your organization's automation content
1. Sync automation content from remote repositories
Manage collection access and permissions with namespaces
Manage containers in your private automation hub
Trigger automation from events with Event-Driven Ansible
Automate actions by routing external event streams: User scenarios
1. Route GitHub event streams to rulebook activations
Filter events before triggering automation
1. Author event filters
Use awx-manage to access automation controller information

Develop

Get started automating with playbooks
Create, test, and deploy automation content with ansible-dev-tools
Emulate a platform environment locally with automation content navigator
Search and filter resources
Use jobs to run playbooks against an inventory of hosts
Standardize and streamline automation with automation job templates
Orchestrate complex automation with workflow job templates
Schedule recurring automation
Logically group playbooks with projects
Launch automation templates from Ansible automation portal
Streamline development by integrating Red Hat Developer Hub plug-ins
Use the REST API to browse, query, filter, and authenticate
1. Browse the REST API
2. Authenticate through the API
Trigger automation with webhooks
Best practices for automation execution
Build automation faster with Red Hat Ansible Lightspeed

Configure

Configure Ansible Automation Platform
Distribute workloads with clustering
1. Planning your cluster environment
Configure supported inventory plugin templates
Configure static storage for Ansible Automation Platform
Configure a proxy to communicate with external systems
Connect securely to Windows hosts

Secure

Configure central authentication for Ansible Automation Platform
Manage access with role-based access control
Understand secret handling
Configure automation hub tokens
Configure credentials to authenticate remote systems and services
Configure credentials for Event-Driven Ansible
Authenticate through the API
Renew and change SSL/TLS certificates
Harden the platform security posture
Manage firewall policies and rules with security automation
Automate network intrusion detection and prevention systems
Security automation use cases
Authenticate the Windows user

Observe

Ensure system health and efficiency through monitoring
Generate consumption-based billing reports with the metrics-utility
View activity streams for all resources
Understand and configure notifications
1. Create a notification template
2. Advanced notification settings
Access log information
Send log files to third-party aggregation services
1. Configure logging components
2. Configure third-party services
Send metrics to system monitoring software
Configure logging for Event-Driven Ansible
Capture telemetry data for Ansible plug-ins for Red Hat Developer Hub
Capture telemetry data for the Ansible self-service portal

Integrate

Integrate with IBM HashiCorp Terraform
Integrate with IBM HashiCorp Vault
Integrate with the external policy engine Open Policy Agent (OPA)
Integrate with Red Hat Lightspeed (formerly Insights)

Optimize

Optimize platform performance
Workload types and access methods
Vertically scale tested deployment models to improve performance
Horizontally scale tested deployment models to improve performance
Horizontally scale in Event-Driven Ansible
Performance tuning for operator environments
Scale up to an enterprise topology
Tune automation controller to improve performance
Tune the PostgreSQL database for optimal performance
Tune performance for Event-Driven Ansible
Get insights on automation across your environment with Automation Analytics
Manage analytics and data collection in Ansible Automation Platform
Optimize request timeouts

Extend

Deploy the MCP server on Ansible Automation Platform
1. Authenticate with the MCP server
  1. Authenticate with OAuth
Deploy the automation intelligent assistant
Deploy the automation intelligent assistant on OpenShift Container Platform
Deploy the automation intelligent assistant on containerized Ansible Automation Platform
Use the automation intelligent assistant
Disable or remove the automation intelligent assistant
Configure the Ansible VS Code extension
Enable the VS Code extension AI assistant

Reference

Ansible Automation Platform custom resources

Troubleshoot

Access troubleshooting information in the UI
Collect configuration and diagnostic information
Troubleshoot your containerized deployment
Troubleshoot your Operator-based deployment of Ansible Automation Platform
Troubleshoot your RPM-based deployment of Ansible Automation Platform
Troubleshoot automation controller
1. External system interference and job failures
2. External system interference and job failures: mitigation
Troubleshoot Kerberos

Download PDF

Ansible Automation Platform 2.6 PDF Reference

Legal Notices

Legal notice
Additional notices for Ansible Automation Platform

Plan your migration

Before beginning a migration, review the planning guidance for your deployment type and infrastructure requirements.

Plan your migration from RPM-based Ansible Automation Platform
Migrate your Ansible Automation Platform RPM 2.6 deployment to an operator-managed deployment on OpenShift Container Platform using the ansible.aap_snapshot collection.
Plan your migration from containerized Ansible Automation Platform
Use the ansible.aap_snapshot collection to migrate your Ansible Automation Platform containerized deployment to an operator-managed deployment on OpenShift Container Platform.

‹ Migration approaches and workflow
Plan your migration from RPM-based Ansible Automation Platform ›

CONTENT

Product documentation
Knowledgebase
Errata
CVEs
Product life cycles
Security Data API

HELP

Contact Red Hat

APP INFO

About
Release: v1.2.13 2026-09-15

© 2026 Red Hat

End user license agreement