Skip to navigation Skip to main content

Search

Content extracted on: 2026-06-24

Home
Product Documentation
Red Hat Ansible Automation Platform
2.7
Launch automation templates from Ansible automation portal
Launch automation templates from Ansible automation portal

What's new

Ansible Automation Platform release notes
Technology Preview

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

Extend

Deploy the MCP server on Ansible Automation Platform
Deploy the automation intelligent assistant
1. Deploy the automation intelligent assistant on OpenShift Container Platform
2. Overview
Deploy the automation intelligent assistant on containerized Ansible Automation Platform
1. Configure Red Hat Ansible Lightspeed variables
2. Red Hat Ansible Lightspeed variables
Extend the automation intelligent assistant with custom knowledge
Enable AI in the Ansible VS Code extension with the MCP server
Ansible plug-ins for Red Hat Developer Hub
Remove the Ansible sidebar navigation item

Upgrade

Plan your Ansible Automation Platform upgrade
Determine your upgrade path
Infrastructure changes by deployment type
Authentication changes in Ansible Automation Platform 2.7
Prepare platform gateway accounts for the 2.7 upgrade
Pre-upgrade migration checklist
Post-upgrade requirements
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
Upgrade additional services for Ansible Automation Platform
Upgrade the Ansible automation portal RHEL appliance

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. Prepare the OpenShift Container Platform target environment and import migration content
2. Prepare to migrate to Managed Ansible Automation Platform

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

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
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
Understand execution environment builder
1. Execution environment definition components
Execution environment builder permissions
1. Grant execution environment builder access to a role
Configure a GitHub App for content discovery
Discover and manage execution environments and collections
Create an execution environment definition using the UI wizard
This content is not included.MCP server integration
1. Integrate Model Context Protocol (MCP) servers through execution environment builder
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

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)

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

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

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 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

Discover

What is Ansible Automation Platform
Ansible components

Legal Notices

Legal notice
Additional notices for Ansible Automation Platform

Launch automation templates from Ansible automation portal

Learn how to access and authenticate to the Ansible automation portal using your Ansible Automation Platform credentials.

Sign in to Ansible automation portal
Log in to the deployed Ansible automation portal using your existing Ansible Automation Platform credentials. The portal uses these credentials for authentication.
Configure custom SSL certificates for the Ansible automation portal
If your Ansible Automation Platform instance uses custom or self-signed SSL certificates, configure the Ansible automation portal to trust those certificates to prevent authentication failures.
Set up permissions for custom self-service templates
Custom self-service templates that you set up in Ansible automation portal use a different set of RBAC rules than the RBAC rules for auto-generated self-service templates that are synchronized from Ansible Automation Platform.
Understanding auto-generated templates
Ansible automation portal automatically generates templates from Ansible Automation Platform Job Templates. Each Ansible Automation Platform Job Template with the appropriate configuration becomes a template that users can execute from Ansible automation portal.
Add and launch custom self-service templates
Custom self-service templates are stored as YAML files in repositories in GitHub or Gitlab. When a user launches a software template from Ansible automation portal, they must fill in a form with the values needed to run the associated job template in Ansible Automation Platform.
Use custom actions and UI components in Backstage Software Templates
The Ansible automation portal is built on a Red Hat Developer Hub base image. It uses Backstage Software Templates, which are YAML-based workflow definitions that provide user forms to execute automation tasks in Ansible Automation Platform.
Custom Backstage actions
The following actions enable you to manage Ansible Automation Platform resources within a software template workflow.
Custom UI components and filters
The Ansible Backstage Plugins provide custom UI components that enhance the software template experience by integrating directly with Ansible Automation Platform resource selection and authentication.
Standard UI widgets
Standard UI widgets provide enhanced components for user forms to capture various types of input.
Parameter types and field options
The parameters section in a template defines the form fields that users complete before execution. Each property in parameters.properties renders as a form field.
Dynamic fields
Dynamic fields appear or disappear based on user selections. Use the dependencies keyword with allOf and if/then to define conditional field visibility.
Configure the output section
The output section defines what users see after a template runs. You can display text messages, reference user input from parameters, show job execution data from steps, and provide external links.
View task run history
You can view a list of all the tasks that have been run from Ansible automation portal.
EE Builder custom UI components
Custom UI components are available for use in Backstage Software Templates to provide specialized form fields for creating and configuring execution environment definitions.

‹ Enforce project integrity with signing and verification
Sign in to Ansible automation portal ›

CONTENT

Product documentation
Knowledgebase
Errata
CVEs
Product life cycles
Security Data API

HELP

Contact Red Hat

APP INFO

About
Release: v1.2.6 2026-06-24

© 2026 Red Hat

End user license agreement