Skip to navigation Skip to main content

Search

Content extracted on: 2026-07-28

Home
Product Documentation
Red Hat Ansible Automation Platform
2.7
Build execution environments with automation portal
Connect to GitHub

What's new

Ansible Automation Platform release notes
Technology Preview

Discover

What is Ansible Automation Platform
Ansible components

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
Attach your Ansible Automation Platform subscription
1. Subscription Types
Plan infrastructure requirements for event persistence
1. Event persistence in rulebook activations

Install

Install containerized Ansible Automation Platform
Inventory file variables
Install on OpenShift Container Platform
Activate your subscription
Understand metrics service architecture
Install Ansible development tools
Deploy Ansible automation portal RHEL appliance
Install Ansible automation portal (OpenShift Container Platform only)
Install automation dashboard to calculate savings (RHEL only)
Install Ansible Builder to create or edit execution environments

Upgrade

Plan your Ansible Automation Platform upgrade
Determine your upgrade path
Infrastructure changes by deployment type
Authentication changes in Ansible Automation Platform 2.7
Third-party authentication provider migration
1. Verify your authentication configuration after upgrade
API changes in Ansible Automation Platform 2.7
Upgrade your containerized deployment of Ansible Automation Platform
Upgrade your Operator-based deployment of Ansible Automation Platform
Validating gateway authentication after the 2.7 upgrade
Upgrade metrics service
Upgrade Ansible automation portal
Upgrade the Ansible automation portal RHEL appliance
Upgrade Ansible plug-ins for Red Hat Developer Hub
Upgrade automation dashboard

Migrate

Migrate from existing deployment topologies
Out of scope
Migration process overview
Migration prerequisites
Contents of the migration artifact
Prepare and export data from the source environment
1. Prepare and export data from a container-based environment
Prepare, configure, and validate the target environment
1. Import migration content to OCP manually
2. Prepare to migrate to Managed Ansible Automation Platform

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
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
1. Back up and restore metrics service
Back up and restore in an OpenShift environment
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
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
Trigger automation with webhooks
Best practices for automation execution
Build execution environments with automation portal
Access preconfigured development tools with Ansible development workspaces
Create and launch an Ansible development workspace
Develop automation content in your workspace
Delete an Ansible development workspace
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
Configuration as Code with the ansible.platform collection
Set up your automation environment for Configuration as Code
Modules in the ansible.platform collection
Configuration as Code migration guide for Ansible Automation Platform 2.7
Configure a proxy to communicate with external systems

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
Configure role-based access control for Ansible automation portal

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
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
Extend the automation intelligent assistant with custom knowledge
Enable the VS Code extension AI assistant
Ansible plug-ins for Red Hat Developer Hub

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 automation controller
Troubleshoot Kerberos
Troubleshoot metrics service
1. Recover metrics service after reinstallation
Troubleshooting RHEL appliances
Troubleshoot Ansible automation portal authentication
Troubleshoot execution environment builder
1. View Ansible automation portal logs for execution environment builder

Reference

Ansible Automation Platform custom resources

Download PDF

Ansible Automation Platform 2.7 PDF Reference

Legal Notices

Legal notice
Additional notices for Ansible Automation Platform

Connect to GitHub

Configure a GitHub App, personal access token, or OAuth App to enable content discovery and definition saving from GitHub repositories.

Configure a GitHub App for content discovery
Create and install a GitHub App so that execution environment builder can scan your organization's repositories for Ansible collections.
Configure a Personal Access Token for GitHub content discovery
Create and store a GitHub Personal Access Token (PAT) so that execution environment builder can scan repositories for Ansible collections.
Configure a GitHub OAuth App for saving definitions
Configure a GitHub OAuth App so that users can save execution environment definition files to a GitHub repository and trigger automated image builds.

‹ Configure collection discovery sources
Connect to GitLab ›

CONTENT

Product documentation
Knowledgebase
Errata
CVEs
Product life cycles
Security Data API

HELP

Contact Red Hat

APP INFO

About
Release: v1.2.9 2026-07-28

© 2026 Red Hat

End user license agreement