Skip to navigation Skip to main content
Red Hat Offline Knowledge Portal
Search Content extracted on: 2026-06-24
  1. Home
  2. Product Documentation
  3. Red Hat Ansible Automation Platform
  4. 2.7
  5. Install containerized Ansible Automation Platform
  6. Node counting in subscriptions
What's new
  1. Ansible Automation Platform release notes
    1. New features and enhancements
    2. Deprecated features
    3. Removed features
    4. Changed features
    5. Known issues
    6. CVE - Bug Fixes
    7. Patch releases
      1. Ansible Automation Platform patch release June 4, 2026
      2. Ansible Automation Platform 2.7 patch release June 17, 2026
  2. Technology Preview
    1. Understand automation dashboard architecture
      1. Enable automation dashboard during containerized installation
      2. Enable automation dashboard during operator installation
      3. Enable automation dashboard post-installation
      4. Troubleshoot automation dashboard configuration and deployment
    2. Bring your own knowledge to the automation intelligent assistant
    3. OIDC authentication for HashiCorp Vault
      1. Configure the HashiCorp Vault server
      2. OIDC credential types for HashiCorp Vault
      3. Claims for workload identity
      4. Example HashiCorp Vault Policy
Get started
  1. Get started automating with playbooks
  2. Get started as a platform administrator
  3. Get started as an automation developer
    1. Set up your development environment
    2. Create automation content with playbooks
    3. Write a playbook
    4. Define events with rulebooks
    5. Package and reuse content with roles
    6. Package and distribute automation content with collections
    7. Create automation runtimes with execution and decision environments
    8. Organize and define automation sources and targets
    9. Reliably run playbooks with job templates
    10. Configure rulebooks to take action in response to events or conditions
  4. Get started as an automation operator
Plan
  1. Choose a deployment method and topology
    1. Installation and deployment models
    2. Container growth topology
    3. Container enterprise topology
    4. Operator growth topology
    5. Operator enterprise topology
      1. Configure external database for metrics service
    6. Network ports and protocols
  2. Attach your Ansible Automation Platform subscription
    1. Subscription Types
  3. Plan infrastructure requirements for event persistence
    1. Event persistence in rulebook activations
Install
  1. Install containerized Ansible Automation Platform
    1. Choose an installation type
    2. Set up your subscription
      1. Trial and evaluation
      2. Node counting in subscriptions
      3. Subscription Types
      4. Attach your Ansible Automation Platform subscription
    3. Activate your subscription
    4. System requirements
    5. Prepare the Red Hat Enterprise Linux host
    6. Prepare the managed nodes
    7. Configure an external database for event streams
      1. Set up event streams database user with PostgreSQL admin credentials
      2. Set up event streams database user without PostgreSQL admin credentials
    8. Configure mutual TLS certificate authentication for event streams database
    9. Download Ansible Automation Platform
    10. Configure the inventory file
    11. Create a registry service account
    12. Advanced configuration options
      1. Add a safe plugin variable to Event-Driven Ansible controller
      2. Add execution nodes
      3. Configure storage for automation hub
      4. Configure a HAProxy load balancer
      5. Enable automation content collection and container signing
      6. Configure an external (customer provided) PostgreSQL database
      7. Configure custom TLS certificates
      8. Configure feature flags for a containerized installation
    13. Install containerized Ansible Automation Platform
    14. Install in a disconnected environment
    15. Maintain containerized Ansible Automation Platform
  2. Inventory file variables
    1. Ansible variables
    2. Automation hub variables
    3. Automation controller variables
    4. Event-Driven Ansible controller variables
    5. Database variables
    6. General variables
    7. Image variables
    8. MCP server variables
    9. Platform gateway variables
    10. Receptor variables
    11. Redis variables
    12. Red Hat Ansible Lightspeed variables
  3. Install on OpenShift Container Platform
    1. Plan your installation of Ansible Automation Platform on Red Hat OpenShift Container Platform
    2. Install the Ansible Automation Platform Operator through OperatorHub
    3. Install Ansible Automation Platform Operator from the CLI
    4. Deploy Ansible Automation Platform
      1. Deploy a new Ansible Automation Platform instance with components
      2. Add components to an existing deployment
      3. Access Ansible Automation Platform through the UI
      4. Access Ansible Automation Platform through the CLI
    5. Manage Ansible Automation Platform subscriptions, updates, and support
      1. Trial and evaluation
      2. Node counting in subscriptions
      3. Subscription Types
      4. Obtain a manifest file
    6. Activate your subscription
    7. Customize your Red Hat Ansible Automation Platform Operator
    8. Configure your Ansible Automation Platform deployment
      1. Enable feature flags in your CR
    9. Configure automation controller
    10. Configure automation hub
      1. Storage options for automation hub
      2. Provision OpenShift Container Platform storage with ReadWriteMany access mode
      3. Configure object storage on Amazon S3
      4. Configure object storage on Azure Blob
      5. Configure automation hub route options
      6. Configure ingress options for automation hub
      7. Finding the automation hub route
    11. Configure custom PostgreSQL settings
    12. Configure custom MCP server settings
    13. Configure an external database for Ansible Automation Platform
      1. Configure an external database for metrics service on Red Hat Ansible Automation Platform Operator
    14. Configure an external database for event streams in Operator on OpenShift Container Platform
    15. Configure Redis
    16. Scale down your Ansible Automation Platform Operator deployment
    17. Ansible Automation Platform Resource Operator
    18. Create a custom resource for Resource Operator
    19. Red Hat Ansible Automation Platform custom resources
  4. Activate your subscription
    1. Activate with credentials
    2. Activate with a manifest file
    3. Keep subscriptions for managed hosts in compliance
  5. Understand metrics service architecture
    1. Metrics service deployment requirements
    2. Install metrics service with containerized installer
    3. Enable metrics service in operator deployments
    4. Configure external PostgreSQL database for metrics service with containerized installer
    5. Configure external PostgreSQL database for metrics service with OpenShift operator
    6. Metrics service configuration variables
    7. Configure TLS/SSL for metrics service databases
    8. Uninstall metrics service
  6. Install Ansible development tools
    1. Requirements
    2. Install and configure VS Code
    3. Install and configure the Dev Containers extension
    4. Set the language for the VS Code extension
    5. Install Ansible development tools on a container inside VS Code
    6. Install Ansible development tools from an RPM package
    7. Configure Red Hat AI providers in the Ansible VS Code extension
  7. Deploy Ansible automation portal RHEL appliance
    1. Prerequisites for deploying Ansible automation portal on RHEL
    2. Install Ansible automation portal on RHEL with KVM
    3. Install Ansible automation portal on Red Hat OpenShift Virtualization
    4. Install Ansible automation portal on VMware vSphere
    5. Configure the appliance at first boot
    6. Connect and verify Ansible automation portal
    7. Deploy a RHEL appliance in a disconnected environment
    8. Replace self-signed SSL certificates
    9. Set a custom user-accessible URL or port
    10. Configure an external database
    11. Cloud-init reference
    12. Portal CLI commands reference
  8. Install Ansible automation portal (OpenShift Container Platform only)
    1. Architecture and licensing
    2. Supported platforms
    3. Select an organization
    4. Create an OAuth application
    5. Generate Git personal access tokens
    6. Set up a project for Ansible automation portal in OpenShift
    7. Create secrets in OpenShift for Ansible automation portal
    8. Plug-in delivery method
      1. OCI container delivery
      2. Migrate from HTTP plug-in registry to OCI container delivery
    9. Install the Ansible automation portal Helm chart
    10. Install Ansible automation portal in air-gapped OpenShift Container Platform environments
    11. Verify the configuration
    12. Update the deployment URL
    13. Set up initial RBAC rules in Ansible automation portal
    14. Understanding Ansible Automation Platform synchronization
    15. Configure an external PostgreSQL database for Ansible automation portal
    16. Configure custom SSL certificates for the Ansible automation portal
  9. Install automation dashboard to calculate savings (RHEL only)
  10. Install Ansible Builder to create or edit execution environments
Extend
  1. Deploy the MCP server on Ansible Automation Platform
  2. Deploy the automation intelligent assistant
    1. Deploy the automation intelligent assistant on OpenShift Container Platform
    2. Overview
  3. Deploy the automation intelligent assistant on containerized Ansible Automation Platform
    1. Configure Red Hat Ansible Lightspeed variables
    2. Red Hat Ansible Lightspeed variables
  4. Extend the automation intelligent assistant with custom knowledge
    1. Prepare your documentation
    2. Build a searchable knowledge base image from your documentation
    3. Verify the vector database
    4. Publish your image to a container registry
    5. Deploy your custom image to a container-based installation
    6. Deploy your custom image to an operator-based installation
    7. Get organization-specific answers from the intelligent assistant
    8. Keep your custom knowledge current
    9. Troubleshooting BYOK for the intelligent assistant
      1. Bring your own knowledge frequently asked questions
  5. Enable AI in the Ansible VS Code extension with the MCP server
    1. Set up your development environment to use the MCP server
    2. Install Ansible Development Tools with the AI assistant
    3. Configure Ansible DevTools and the development environment
    4. Manage your Ansible dev environment
    5. Scaffold an Ansible project with the AI assistant
    6. Validate and debug with the AI assistant
    7. Create and validate an execution environment with the assistant
    8. Run playbooks with ansible-navigator using the assistant
  6. Ansible plug-ins for Red Hat Developer Hub
    1. About Red Hat Developer Hub
    2. Ansible plug-ins for Red Hat Developer Hub
    3. Prerequisites
    4. Install the Ansible plug-ins
    5. Configure the Ansible plug-ins
    6. Optional configuration
    7. Uninstall the Ansible plug-ins
    8. Full configuration examples
    9. Install Ansible plug-ins using an HTTP plug-in registry (deprecated)
    10. Migrate from HTTP plug-in registry to OCI container delivery
    11. Upgrade the Ansible plug-ins
  7. Remove the Ansible sidebar navigation item
Upgrade
  1. Plan your Ansible Automation Platform upgrade
  2. Determine your upgrade path
  3. Infrastructure changes by deployment type
  4. Authentication changes in Ansible Automation Platform 2.7
  5. Prepare platform gateway accounts for the 2.7 upgrade
  6. Pre-upgrade migration checklist
  7. Post-upgrade requirements
  8. Third-party authentication provider migration
    1. Verify your authentication configuration after upgrade
  9. API changes in Ansible Automation Platform 2.7
    1. General API changes
    2. Specific API changes
    3. Update collection versions
    4. Migrate playbook connection values to platform gateway
  10. Upgrade your containerized deployment of Ansible Automation Platform
  11. Upgrade your Operator-based deployment of Ansible Automation Platform
    1. Overview
    2. Upgrade considerations
    3. Prerequisites and channel upgrades
    4. Upgrade the Ansible Automation Platform Operator
    5. Patch update for Operator-based Ansible Automation Platform
  12. Upgrade additional services for Ansible Automation Platform
    1. Upgrade the Ansible plug-ins with Helm
    2. Upgrade the Ansible plug-ins for an Operator environment
    3. Upgrade Ansible automation portal
      1. Ansible automation portal version compatibility
      2. Troubleshoot Ansible automation portal upgrades
    4. Upgrade automation dashboard
    5. Upgrade metrics service
    6. Validating gateway authentication after the 2.7 upgrade
  13. Upgrade the Ansible automation portal RHEL appliance
Migrate
  1. Migrate from existing deployment topologies
  2. Out of scope
  3. Migration process overview
  4. Migration prerequisites
  5. Contents of the migration artifact
  6. Prepare and export data from the source environment
    1. Prepare and export data from a container-based environment
  7. 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
  1. Configure central authentication for Ansible Automation Platform
    1. Mandatory platform gateway authentication in Ansible Automation Platform 2.7
    2. Pluggable authentication
    3. Configuration notes for all authentication types
    4. Configure an authentication type to simplify user logins
      1. Configure local authentication
    5. User and external authentication mapping
      1. Email address modification restrictions
      2. Override email modification restrictions
      3. Audit email address modifications
    6. Map external authenticators to Ansible Automation Platform
    7. Locate and manage authentication configurations
    8. Configure Google Cloud for increased authentication performance
    9. Configure access to external applications with tokens
      1. Create a new application
      2. Create, revoke, or clear tokens
      3. Personal Access Token removal in Ansible Automation Platform 2.7
      4. Security settings for OAuth2 tokens and external users
    10. Configure platform gateway route timeouts
  2. Manage access with role-based access control
    1. Structure groups and resources with organizations
      1. Create an organization
      2. Manage access to organizations
    2. Assign notifiers and execution environments to organizations
    3. Bulk-assign roles to users with teams
    4. View, create, or assign roles to users
    5. Manage user access to resources
    6. View, create, and assign roles to grant user access to resources
    7. Configure an external secret management system for automation
      1. Configuring and linking secret lookups
      2. Metadata for credential input sources
      3. Integrate third-party secret management systems
  3. Understand secret handling
  4. Configure automation hub tokens
  5. Configure credentials to authenticate remote systems and services
    1. How credentials work
      1. Create new credentials
      2. Add new users and job templates to existing credentials
    2. Credential types
      1. Amazon Web Services credential type
      2. Ansible Galaxy or automation hub API token credential type
      3. AWS secrets manager lookup
      4. BitBucket data center HTTP access token
      5. Centrify Vault Credential Provider Lookup credential type
      6. Container registry credential type
      7. CyberArk Central Credential Provider Lookup credential type
      8. CyberArk Conjur Secrets Manager Lookup credential type
      9. GitHub Personal Access Token credential type
      10. GitLab Personal Access Token credential type
      11. Google Compute Engine credential type
      12. GPG Public Key credential type
      13. HashiCorp Vault Secret Lookup credential type
      14. HashiCorp Vault Signed SSH credential type
      15. Red Hat Lightspeed credential type
      16. Access machine credentials in an ansible playbook
      17. Microsoft Azure Key Vault credential type
      18. Microsoft Azure Resource Manager credential type
      19. Network credential type
      20. OpenShift or Kubernetes API Bearer Token credential type
      21. OpenStack credential type
      22. Red Hat Ansible Automation Platform credential type
      23. Red Hat Satellite 6 credential type
      24. Red Hat Virtualization credential type
      25. Source Control credential type
      26. Terraform: Backend configuration
      27. Terraform: HCP Terraform credential type
      28. Thycotic DevOps Secrets Vault credential type
      29. Thycotic secret server credential type
      30. Ansible Vault credential type
      31. VMware vCenter credential type
    3. Use automation controller credentials in a playbook
    4. Custom credential types
    5. Add new users and job templates to existing credentials
    6. Getting started with credential types
  6. Configure credentials for Event-Driven Ansible
    1. Set up credentials
    2. Connect to external secret management systems with built-in credentials
    3. Create custom credentials for Event-Driven Ansible
      1. Event-Driven Ansible Rule Engine credential type
  7. Authenticate through the API
    1. Use session authentication
    2. Basic authentication removal
    3. OAuth 2 token authentication
    4. Single sign-on authentication
  8. Renew and change SSL/TLS certificates
    1. Container-based installations
    2. Operator-based installations
    3. Configure a CA file
  9. Harden the platform security posture
    1. Plan your topology and networking configuration
    2. Manage platform credentials
    3. Understand how Ansible Automation Platform manages secrets
    4. Best practices for securing user accounts
    5. Best practices for setting up secure logging
    6. Apply the NIST Cybersecurity Framework
    7. Secure your Red Hat Enterprise Linux hosts
    8. Installation settings to secure your platform
    9. Ensure compliance with host-level security controls
    10. Recommended security practices for access controls
    11. RBAC security considerations for day two operations
    12. Disaster recovery and operational continuity
    13. Integrate with HashiCorp to secure sensitive data
    14. Improve the security of nodes managed by Ansible Automation Platform
    15. Automate nodes that comply with security profiles
  10. Manage firewall policies and rules with security automation
  11. Automate network intrusion detection and prevention systems
  12. Security automation use cases
    1. Red Hat Ansible Automation Platform as part of a Security Operations Center
    2. Automate software patching
    3. Configure automatic security reactions with Event-Driven Ansible
    4. Case study with F5 example
    5. Example: Use F5 with Event-Driven Ansible
Administer
  1. Define automation target hosts in your inventory files
    1. Define a collection of hosts with Smart Inventories
    2. Configure supported inventory plugin templates
    3. Create dynamic groups with constructed inventories
    4. Generate dynamic data from external sources with inventory plugins
    5. Add a source to an inventory
    6. Run ad hoc commands against a host in an inventory
    7. Import your inventory file from source control
  2. Define where automation runs with host and node groupings
    1. Add new hosts as automation targets
    2. Determine where automation runs with instance groups
    3. Configure instance groups from the API
    4. Control where automation runs with container groups
  3. Scale automation across your infrastructure with automation mesh
  4. Scale with automation mesh in an operator environment
    1. Set up VMs for use in mesh
    2. Run jobs on execution nodes
    3. View details about mesh nodes with topology viewer
  5. Scale with automation mesh in a containerized or VM environment
    1. Edit the inventory file
    2. Design patterns for mesh
  6. Back up and restore your containerized deployment
    1. Back up and restore metrics service
  7. Back up and restore in an OpenShift environment
    1. About backup and recovery
    2. Back up your Ansible Automation Platform deployment
    3. Restore your Ansible Automation Platform deplopyment
  8. Define, create, and build execution environments
    1. Create and integrate custom MCP Servers in execution environments
    2. Build a definition file
    3. Disconnected environment customizations
    4. Execution environment setup reference
    5. Set up your container repository
    6. Pull execution environments for use in automation hub
    7. Secure your automation with container signing
  9. Manage your organization's automation content
    1. Sync automation content from remote repositories
      1. Red Hat Certified, validated, and Ansible Galaxy content in automation hub
      2. Configure automation hub tokens
      3. Configure the rh-certified remote repository
      4. Configure the private automation hub community remote
      5. Configure proxy settings
      6. Create a requirements file
      7. Sync content collections
      8. Configure content signing on private automation hub
  10. Manage collection access and permissions with namespaces
    1. Upload, group, and approve your organization’s content collections
    2. Approve content for custom repositories in automation hub
    3. Create a remote configuration in automation hub
      1. Assign access to a remote configuration
      2. Synchronize repositories in automation hub
  11. Manage containers in your private automation hub
  12. Trigger automation from events with Event-Driven Ansible
    1. Background task processing for Event-Driven Ansible
    2. Organize rulebooks for event-driven automation
      1. Set up a new project
      2. Update revision on launch for projects
      3. Project and rulebook activation settings interdependencies
    3. Create runtime environments for event-driven automation
    4. Define rules that trigger automation from events
    5. Manage active event-driven automation integrations
    6. Reuse event-driven automation configurations
    7. Activate webhook-based automation in Openshift
    8. Audit pipeline-triggered automation activity
    9. Troubleshoot failed event-driven automation triggers
      1. Resolve event processing failures in rulebook activations
      2. Troubleshoot actions that fail to trigger after receiving events
    10. Respond to events from external systems
    11. Automate actions by routing external event streams: User scenarios
      1. Route GitHub event streams to rulebook activations
    12. Filter events before triggering automation
      1. Author event filters
  13. Use awx-manage to access automation controller information
Develop
  1. Get started automating with playbooks
    1. How do Ansible Playbooks work
    2. Define which hosts to manage in an inventory file
    3. Create a simple playbook to connect to managed hosts
    4. Gather and display network device info with a playbook
    5. Example: automate software updates
  2. Create, test, and deploy automation content with ansible-dev-tools
    1. Ansible development tools components and workflow
    2. Auto-generate the structure and files for your automation project
    3. Write your first automation task using the VS Code extension
    4. Run your playbook automation to test behavior
    5. Package and distribute automation content with collections
    6. This content is not included.MCP server integration
      1. Implement automation content for ephemeral MCP agents
  3. Emulate a platform environment locally with automation content navigator
    1. What is automation content navigator?
    2. Run a playbook to display execution environment contents
    3. Browse collections in a text-based format
    4. View groups and hosts in your inventory
    5. Run playbooks locally with automation content navigator
    6. Troubleshoot collections, execution environments, and playbooks
    7. Automation content navigator command reference
  4. Use jobs to run playbooks against an inventory of hosts
    1. Sync inventory data with external sources
    2. View output for your playbook job runs
    3. Advanced configuration for jobs tied to source control management systems
  5. Standardize and streamline automation with automation job templates
    1. Create repeatable, shareable job templates to standardize automation runs
    2. Set extra variables in job templates
    3. Launch a job template
    4. Associate cloud credentials with a job template
    5. Increase capacity through cloud bursting by provisioning callbacks
    6. Distribute automation across a large number of hosts with job slicing
  6. Orchestrate complex automation with workflow job templates
    1. Role-based access controls
    2. Understand how to configure workflows
    3. Create a workflow job template
    4. Build a graphical workflow representation with workflow visualizer
    5. Configure nodes in workflow visualizer
  7. Schedule recurring automation
  8. Logically group playbooks with projects
    1. Add a new project
    2. Manage playbooks manually
    3. Configure playbooks to use source control management (SCM) systems
    4. Configure collections from source management to run in a project
    5. Configure project permissions
    6. Enforce project integrity with signing and verification
  9. Launch automation templates from Ansible automation portal
    1. Sign in to Ansible automation portal
    2. Configure custom SSL certificates for the Ansible automation portal
    3. Set up permissions for custom self-service templates
    4. Understanding auto-generated templates
      1. What users see
      2. Auto-generated template example
      3. How templates are generated
    5. Add and launch custom self-service templates
    6. Use custom actions and UI components in Backstage Software Templates
    7. Custom Backstage actions
    8. Custom UI components and filters
    9. Standard UI widgets
    10. Parameter types and field options
      1. Supported parameter types
      2. AAP resource picker fields
    11. Dynamic fields
      1. Show or hide fields based on a toggle
      2. Show different fields based on a selection
      3. Chain multiple dynamic dependencies
    12. Configure the output section
      1. Output text
      2. Output links
      3. Reference parameters in output
      4. Reference step output in output
    13. View task run history
    14. EE Builder custom UI components
  10. Streamline development by integrating Red Hat Developer Hub plug-ins
    1. Streamline development by integrating Red Hat Developer Hub plug-ins
    2. Dashboard navigation
    3. Access learning paths, labs, and collections
    4. Develop and execute projects in Dev Spaces
      1. Discover existing Ansible content for RHEL system roles
  11. Use the REST API to browse, query, filter, and authenticate
    1. Browse the REST API
    2. Authenticate through the API
    3. Access metrics service API
  12. Trigger automation with webhooks
  13. Best practices for automation execution
  14. Understand execution environment builder
    1. Execution environment definition components
  15. Execution environment builder permissions
    1. Grant execution environment builder access to a role
  16. Configure a GitHub App for content discovery
    1. Configure a Personal Access Token for GitHub content discovery
    2. Save definition files to a GitHub repository
    3. Set up GitLab integration for execution environment builder
    4. Configure collection discovery sources
    5. Host execution environment wizard templates in a private Git repository
    6. Apply configuration changes
    7. Synchronize content sources
    8. Create standardized execution environment templates for teams
    9. Complete Helm chart values reference for execution environment builder
    10. Complete execution environment template reference
  17. Discover and manage execution environments and collections
    1. Browse the execution environment catalog
    2. Execution environment definition detail page
    3. Build an execution environment image from the catalog
    4. Delete or unregister an execution environment definition
    5. Browse and view collections
  18. Create an execution environment definition using the UI wizard
  19. This content is not included.MCP server integration
    1. Integrate Model Context Protocol (MCP) servers through execution environment builder
  20. Access preconfigured development tools with Ansible development workspaces
  21. Create and launch an Ansible development workspace
  22. Develop automation content in your workspace
  23. Delete an Ansible development workspace
  24. Build automation faster with Red Hat Ansible Lightspeed
    1. Red Hat Ansible Lightspeed Overview
    2. Quick start for administrators
    3. Quick start for developers
    4. Start a trial of Red Hat Ansible Lightspeed
    5. Set up Red Hat Ansible Lightspeed for your organization
    6. Set up Red Hat Ansible Lightspeed cloud service
    7. Set up Red Hat Ansible Lightspeed on-premise deployment
    8. Install the Red Hat Ansible Automation Platform operator
    9. Develop Ansible content
    10. Install and configure the Ansible VS Code extension
    11. Create task recommendations
    12. Create playbooks and view playbook explanations
    13. Create roles and view roles explanations
    14. View the audit logs
    15. Provide feedback on the Ansible Lightspeed service
    16. Administer the Ansible Lightspeed Service
    17. View and manage Admin dashboard telemetry
    18. Install and configure the Ansible code bot
    19. Configure the Ansible code bot to scan your repository at regular intervals
    20. Troubleshoot Red Hat Ansible Lightspeed configuration errors
Configure
  1. Configure Ansible Automation Platform
    1. Configure subscriptions
    2. Platform gateway
    3. Enable OAuth2 token creation for external users
    4. Configure miscellaneous options
    5. Understanding the platform gateway OpenAPI specification
    6. Access the interactive documentation (Rendered access)
    7. Manage feature flags
    8. View feature flags in your user interface
    9. User preferences
  2. Distribute workloads with clustering
    1. Planning your cluster environment
  3. Configure supported inventory plugin templates
  4. Configure static storage for Ansible Automation Platform
  5. Configuration as Code with the ansible.platform collection
  6. Set up your automation environment for Configuration as Code
  7. Modules in the ansible.platform collection
  8. Configuration as Code migration guide for Ansible Automation Platform 2.7
  9. Configure a proxy to communicate with external systems
    1. Configure proxy support to manage network configuration
    2. Configure proxy servers for egress traffic
    3. Configure proxy settings for Event-Driven Ansible
    4. Configure proxy settings for automation mesh
    5. Configure operator-based Ansible Automation Platform to use egress proxy
Integrate
  1. Integrate with IBM HashiCorp Terraform
    1. About the Terraform integration
    2. Use hashicorp.terraform
    3. Integrate with the cloud.terraform collection
    4. Migrate from cloud.terraform to hashicorp.terraform
    5. Migrate from the Terraform community edition
    6. Integrate from Terraform
      1. Configure the provider
      2. Dynamically override execution settings
      3. Use TF Actions and Ansible Automation Platform
  2. Integrate with IBM HashiCorp Vault
    1. Authenticate to hashicorp.vault
    2. Migrate from community.hashi_vault
      1. Configure KV1 modules
      2. Configure KV2 modules
    3. Manage database secrets with hashicorp.vault
      1. Configure the hashicorp.vault.database_connection module
  3. Integrate with the external policy engine Open Policy Agent (OPA)
    1. Implement policy enforcement
    2. Configure enforcement points
    3. Policy enforcement input and output options
  4. Integrate with Red Hat Lightspeed (formerly Insights)
Observe
  1. Ensure system health and efficiency through monitoring
  2. Generate consumption-based billing reports with the metrics-utility
    1. Configure the metrics-utility
    2. Configure a monthly usage report
    3. Configure the metrics-utility to run at specific times
    4. Specify where to store consumption-based reports
    5. Configure options for the Certified Cloud and Service Provider report (CCSPv2)
    6. Configure options in the RENEWAL_GUIDANCE report
    7. Original Certified Cloud and Service Provider (CCSP) report
    8. How to deduplicate host data in reports
  3. View activity streams for all resources
  4. Understand and configure notifications
    1. Create a notification template
    2. Advanced notification settings
  5. Access log information
  6. Send log files to third-party aggregation services
    1. Configure logging components
    2. Configure third-party services
  7. Send metrics to system monitoring software
  8. Configure logging for Event-Driven Ansible
  9. Capture telemetry data for Ansible plug-ins for Red Hat Developer Hub
  10. Capture telemetry data for the Ansible self-service portal
Optimize
  1. Optimize platform performance
  2. Workload types and access methods
  3. Vertically scale tested deployment models to improve performance
  4. Horizontally scale tested deployment models to improve performance
  5. Horizontally scale in Event-Driven Ansible
  6. Performance tuning for operator environments
    1. Introduction
    2. Customize pod specifications to improve performance
    3. Manage resources for pods and containers
    4. Adjust the control plane to tune performance
    5. Specify dedicated nodes for pods and job execution
    6. How job capacity is determined and impacts job runs
    7. Job type impact on capacity
    8. Fine-tune Receptor worker backoff strategies for API reliability
  7. Scale up to an enterprise topology
  8. Tune automation controller to improve performance
    1. Capacity plan for node types and workload characteristics
    2. Example capacity planning exercise
    3. Understand primary workloads for automation controller
    4. Manage live event streams to the UI
    5. Capacity settings for each node type
  9. Tune the PostgreSQL database for optimal performance
  10. Tune performance for Event-Driven Ansible
  11. Get insights on automation across your environment with Automation Analytics
    1. Plan, track, and analyze returns with automation savings planner
    2. Get a comprehensive visual overview of automation with reports
    3. View data about automation jobs across your organization
    4. Change your Automation Analytics settings
    5. Details about data collected for Automation Analytics
    6. View automation job metrics with automation dashboard
    7. Inventory file variables for automation dashboard
  12. Manage analytics and data collection in Ansible Automation Platform
  13. Optimize request timeouts
Troubleshoot
  1. Access troubleshooting information in the UI
  2. Collect configuration and diagnostic information
  3. Troubleshoot your containerized deployment
  4. Troubleshoot your Operator-based deployment of Ansible Automation Platform
  5. Troubleshoot automation controller
  6. Troubleshoot metrics service
    1. Recover metrics service after reinstallation
  7. Troubleshooting RHEL appliances
  8. Troubleshoot Ansible automation portal authentication
  9. Troubleshoot execution environment builder
    1. View Ansible automation portal logs for execution environment builder
Reference
  1. Ansible Automation Platform custom resources
    1. AnsibleAutomationPlatform [aap.ansible.com/v1alpha1]
    2. AnsibleAutomationPlatformBackup and AnsibleAutomationPlatformRestore [aap.ansible.com/v1alpha1]
    3. Automation controller custom resources
    4. Automation hub custom resources
    5. Ansible Lightspeed custom resources
    6. Event-Driven Ansible custom resources
    7. Resource Operator custom resources
Download PDF
  1. Ansible Automation Platform 2.7 PDF Reference
Discover
  1. What is Ansible Automation Platform
  2. Ansible components
Legal Notices
  1. Legal notice
  2. Additional notices for Ansible Automation Platform

Node counting in subscriptions

The Ansible Automation Platform subscription defines the number of Managed Nodes that can be managed as part of your subscription.

For more information about managed node requirements for subscriptions, see How are "managed nodes" defined as part of the Red Hat Ansible Automation Platform offering.

Note:

Ansible does not recycle node counts or reset automated hosts.

  • ‹ Trial and evaluation
  • Subscription Types ›
Red Hat

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