Red Hat Ansible Automation Platform 2.7
このコンテンツは選択した言語では利用できません。
What's new
Release notes
Review new features, deprecated and removed features, known issues, and bug fixes in Ansible Automation Platform 2.7.
Patch releases
Find incremental bug fixes, CVE patches, and component updates for each Ansible Automation Platform 2.7 patch release.
Discover
What is Ansible Automation Platform
Learn what Ansible Automation Platform is and how it automates infrastructure provisioning, configuration management, application deployment, and security.
Technology preview
Analyze automation usage with automation dashboard
Understand the automation dashboard architecture in Ansible Automation Platform 2.7, including how metrics service serves as the unified data collection backend, REST API endpoints, and integration with the platform UI.
Bring your own knowledge to the automation intelligent assistant
Learn how to extend the automation intelligent assistant with your organization's internal knowledge using the bring-your-own-knowledge capability, enabling customized responses based on your own policies, procedures, and documentation.
OIDC credential types for HashiCorp Vault
Learn how Ansible Automation Platform 2.7 acts as a native OIDC identity provider for HashiCorp Vault, enabling automation jobs to authenticate with short-lived, job-scoped JSON web tokens instead of stored credentials.
Get started
Get started automating with playbooks
Write and run your first Ansible playbooks to automate tasks across your infrastructure.
Get started as an Ansible Automation Platform administrator
Set up Ansible Automation Platform as an administrator, from first login and subscriptions to authentication, RBAC, and user management.
Get started as an automation developer
Set up your development environment and create your first playbooks, rulebooks, roles, collections, and execution environments.
Get started as an automation operator
Launch and monitor automation jobs, manage inventories, and view job output as an automation operator.
Plan
Choose a deployment method and topology
Select a deployment model (containerized or Operator) and topology (growth or enterprise) based on your infrastructure requirements.
Attach your Ansible Automation Platform subscription
Attach your Red Hat subscription to Ansible Automation Platform and choose the subscription type that fits your deployment.
Plan infrastructure requirements for event persistence with Event-Driven Ansible
Plan infrastructure requirements for event persistence in Event-Driven Ansible rulebook activations, including storage, database sizing, and resource allocation needed to retain and query event data.
Install
Install containerized Ansible Automation Platform
Install Ansible Automation Platform using containers on RHEL, from host preparation and inventory configuration through disconnected installs and post-install maintenance.
Inventory file variables
Look up inventory file variables for all Ansible Automation Platform components, including automation controller, automation hub, Event-Driven Ansible, and platform gateway.
Install on OpenShift Container Platform
Install Ansible Automation Platform on OpenShift Container Platform using the Operator, with options for OperatorHub or CLI installation and component customization.
Activate your subscription
Activate your Ansible Automation Platform subscription using your Red Hat credentials or a manifest file.
Understand and install metrics service
Understand the metrics service architecture in Ansible Automation Platform 2.7, including how it collects and stores automation usage data, its database configuration, and its role as the backend for the automation dashboard.
Install Ansible development tools (ansible-dev-tools)
Install and configure Ansible development tools, including the VS Code extension, Dev Containers, and container-based or RPM-based dev tool packages.
Deploy Ansible automation portal RHEL appliance
Deploy the automation portal as a pre-built RHEL 9 virtual machine appliance.
Install automation portal on OpenShift Container Platform
Install the automation portal on OpenShift Container Platform using Helm, including OAuth configuration, RBAC setup, and disconnected installs.
Install automation dashboard to calculate savings (RHEL only)
Install the automation dashboard on RHEL to track and visualize your automation savings metrics.
Install Ansible Builder to create or edit execution environments
Install Ansible Builder to create and customize execution environments for your automation workloads.
Extend
Deploy an MCP server on Ansible Automation Platform
Deploy the Model Context Protocol (MCP) server to connect AI agents with your Ansible Automation Platform for AI-assisted automation development.
Deploy the automation intelligent assistant on OpenShift Container Platform
Deploy the automation intelligent assistant on OpenShift by creating configuration secrets, updating the Operator YAML, and configuring your LLM model.
Deploy the automation intelligent assistant on containerized Ansible Automation Platform
Deploy the automation intelligent assistant on a containerized installation and configure LLM model and Lightspeed variables.
Configure the Ansible VS Code extension
Configure the Ansible VS Code extension to connect to your containerized Ansible Automation Platform installation.
Enable the VS Code extension AI assistant
Configure the Ansible VS Code extension to connect to your containerized Ansible Automation Platform installation.
Ansible plug-ins for Red Hat Developer Hub
Install the Ansible plug-ins for Red Hat Developer Hub using Helm charts or the Operator and configure required integrations.
Upgrade
Plan your upgrade to Ansible Automation Platform 2.7
Review upgrade improvements and frequently asked questions to plan your move to Ansible Automation Platform 2.7.
Determine your upgrade path
Determine your upgrade path to Ansible Automation Platform 2.7 based on your current version, deployment method, and whether you need to migrate from RPM to containerized installation before upgrading.
Authentication changes in Ansible Automation Platform 2.7
Understand the authentication changes in Ansible Automation Platform 2.7, including the requirement to route all authentication through platform gateway and the removal of direct component-level token support.
Third-party authentication provider migration
Migrate third-party authentication configurations to Ansible Automation Platform 2.7 by moving external identity provider integrations such as LDAP, SAML, and OAuth to the platform gateway.
API changes in Ansible Automation Platform 2.7
Review the API changes in Ansible Automation Platform 2.7, including the removal of the backward compatibility layer and the requirement to route all API access through the platform gateway.
Containerized upgrade on RHEL
Upgrade your containerized Ansible Automation Platform deployment to version 2.7.
Upgrade on OpenShift Container Platform
Upgrade your Operator-based Ansible Automation Platform deployment on OpenShift, including in-channel and cross-channel Operator upgrades.
Validating gateway authentication after the 2.7 upgrade
Validate your Ansible Automation Platform 2.7 upgrade by verifying that all platform services are running, authentication is functioning, and automation jobs execute successfully.
Upgrade metrics service
Upgrade the metrics service component to ensure compatibility with Ansible Automation Platform 2.7 and maintain automation dashboard data collection and reporting capabilities.
Upgrade Ansible automation portal
Upgrade the Ansible automation portal to the latest version compatible with Ansible Automation Platform 2.7, including updates for OpenShift and RHEL appliance deployments.
Upgrade the Ansible automation portal RHEL appliance
Upgrade the Ansible automation portal RHEL appliance to the latest version using the built-in bootc atomic upgrade and rollback capabilities.
Upgrade Ansible plug-ins for Red Hat Developer Hub
Upgrade the Ansible plug-ins for Red Hat Developer Hub using Helm or the Operator.
Upgrade automation dashboard
Upgrade the automation dashboard to the latest version and troubleshoot synchronization issues.
Migrate
Migrate from existing deployment topologies
Migrate your Ansible Automation Platform deployment from containerized topologies to container-based, OpenShift, or Managed environments.
Administer
Define automation target hosts in your inventory files
Create and manage inventories for your automation targets, including smart inventories, constructed inventories, inventory plugins, and source control imports.
Define where automation runs with host and node groupings
Control where automation jobs run by configuring hosts, instance groups, and container groups.
Understand how to scale automation across your infrastructure with automation mesh
Plan your automation mesh topology by designing node relationships, connection patterns, and network routing to distribute automation workloads across on-premises, cloud, and edge environments.
Scale with automation mesh in an Operator environment
Add execution and hop nodes to your Operator-based deployment to extend automation mesh and run jobs on remote infrastructure.
Scale with automation mesh in a containerized or VM environment
Plan and deploy automation mesh to distribute automation workloads across your infrastructure using control, execution, and hop nodes.
Backup and restore your containerized deployment
Back up and restore your containerized Ansible Automation Platform deployment to protect against data loss.
Back up and restore in an OpenShift environment
Back up and restore your Operator-based Ansible Automation Platform deployment on OpenShift, including custom PVC and external database options.
Define, create, and build execution environments
Build custom execution environments with definition files, manage container repositories, and sign container images for secure distribution.
Manage your organization's automation content
Sync, manage, and sign automation content collections in private automation hub, including Red Hat Certified, validated, and community content.
Manage collection access and permissions with namespaces
Organize automation content with namespaces, configure approval pipelines, and manage access to collections in private automation hub.
Manage containers in your private automation hub
Manage container images and registries in private automation hub, including pulling, tagging, syncing, and configuring team permissions.
Trigger automation from events with Event-Driven Ansible
Set up Event-Driven Ansible to trigger automation in response to events, including projects, decision environments, and rulebook activations.
User scenario: Automate actions by routing external event streams
Follow step-by-step scenarios to route events from external systems like GitHub to Event-Driven Ansible rulebook activations.
Filter events before triggering automation with Event-Driven Ansible
Write and apply event filter plugins to transform or discard events before they trigger Event-Driven Ansible actions.
Use awx-manage to access automation controller information
Use the awx-manage command-line utility to query and manage automation controller data and settings.
Develop
Get started automating with playbooks
Learn playbook fundamentals, build your first inventory, and run practical automation examples including network device management.
Create, test, and deploy automation content with ansible-dev-tools
Use Ansible development tools to scaffold projects, write and test playbooks in VS Code, develop collections, and integrate with MCP servers.
Emulate a platform environment locally with automation content navigator
Run playbooks, browse collections, and troubleshoot automation locally using automation content navigator without a full platform deployment.
Search and filter resources
Use search, filter, and sort tools in Red Hat Ansible Automation Platform to quickly locate and manage resources across your environment.
Use jobs to run playbooks against an inventory of hosts
Run and monitor playbook jobs, sync inventories from external sources, and configure advanced source control branching options.
Logically group playbooks with projects
Organize playbooks into projects, connect to source control repositories, configure collections, and enforce project signing.
Standardize and streamline automation with automation job templates
Create and configure job templates with variables, cloud credentials, provisioning callbacks, and job slicing to standardize your automation.
Orchestrate complex automation with workflow job templates
Build multi-step automation workflows using workflow job templates and the visual workflow editor to orchestrate complex processes.
Schedule recurring automation
Schedule automation jobs and workflows to run on a recurring basis with rules and exceptions.
Launch automation templates from Ansible automation portal
Use the automation portal to launch automation templates, configure RBAC permissions, and build custom self-service templates.
Streamline development by integrating Red Hat Developer Hub plug-ins
Use the Ansible plug-ins in Red Hat Developer Hub for dashboard navigation, learning resources, and Dev Spaces integration.
Trigger automation with webhooks
Configure webhooks to automatically trigger automation jobs from external services and events.
Best practices for automation execution
Apply recommended practices for running automation efficiently and reliably at scale with automation controller.
Build execution environments with automation portal
Use execution environment builder in Ansible automation portal to create, configure, and build custom execution environments for your automation workloads.
Access preconfigured development tools with Ansible development workspaces
Create and launch browser-based development workspaces with preconfigured Ansible tools on Red Hat OpenShift Dev Spaces to write, test, and share automation content.
Build automation faster with Red Hat Ansible Lightspeed
Get started with Ansible Lightspeed to generate Ansible tasks and playbooks from natural language prompts using AI-powered code recommendations directly in your editor.
Configure
Configure Ansible Automation Platform
Configure platform-wide settings including subscriptions, platform gateway, OAuth2 tokens, and user preferences.
Distribute workloads with clustering
Plan and configure a clustered environment to distribute automation workloads across multiple nodes for higher availability.
Configure supported inventory plugin templates
Set up inventory plugin templates for AWS, Azure, Google Cloud, VMware, Red Hat Satellite, and OpenStack to manage dynamic inventories.
Configure static storage for Ansible Automation Platform
Configure static storage backends for your Ansible Automation Platform deployment.
Configuration as Code with the ansible.platform collection
Learn about Configuration as Code for Ansible Automation Platform to manage and version-control your platform configuration, including organizations, credentials, job templates, and workflows using Ansible playbooks.
Set up your automation environment for Configuration as Code
Set up your automation environment for Configuration as Code by configuring the required collections, credentials, and project structure to manage Ansible Automation Platform resources as code.
Modules in the ansible.platform collection
Reference the Ansible platform collection modules available for programmatically managing Ansible Automation Platform resources, including automation controller, automation hub, and Event-Driven Ansible components.
Configuration as Code migration guide for Ansible Automation Platform 2.7
Migrate your Configuration as Code playbooks to Ansible Automation Platform 2.7 by updating module parameters, authentication settings, and API endpoints to route through the platform gateway.
Configure a proxy to communicate with external systems
Configure a proxy server for Ansible Automation Platform to route outbound traffic through your organization's proxy when communicating with external systems such as source control, cloud providers, and APIs.
Secure
Configure central authentication for Ansible Automation Platform
Configure authentication providers (LDAP, SAML, OIDC, Keycloak, GitHub, Azure AD, RADIUS, TACACS+) and map external users to platform roles and teams.
Manage access with role-based access control
Manage organizations, teams, users, and roles to control who can access and modify resources across your platform.
Understand secret handling
Understand how Ansible Automation Platform encrypts, stores, and manages secrets for user passwords, credentials, and managed node connections.
Configure automation hub tokens
Create and manage offline tokens and API tokens for authenticating to automation hub.
Configure credentials to authenticate remote systems and services
Create and manage credentials for cloud providers, source control, vaults, and other services, or define custom credential types for your automation.
Configure credentials for Event-Driven Ansible
Set up built-in and custom credential types for Event-Driven Ansible, including the Rule Engine credential type and external secret management.
Authenticate through the API
Authenticate API requests using session authentication, basic authentication, OAuth 2 tokens, or single sign-on.
Renew and change SSL/TLS certificates
Renew or replace SSL/TLS certificates for containerized and Operator-based deployments, and configure custom CA files.
Harden the platform security posture
Strengthen your Ansible Automation Platform security with hardening practices for topology, credentials, authentication, logging, RBAC, and RHEL host security.
Manage firewall policies and rules with security automation
Automate firewall policy and rule management across your infrastructure using Ansible security automation.
Automate network intrusion detection and prevention systems
Automate the configuration and management of intrusion detection and prevention systems (IDPS) using Ansible.
Security automation use cases
Explore real-world security automation scenarios including SOC integration, patch automation, and Event-Driven Ansible security reactions.
Configure role-based access control for Ansible automation portal
Configure role-based access control for the Ansible automation portal to manage which users and teams can view, launch, and administer self-service automation templates.
Observe
Metrics for monitoring automation controller application
Monitor platform health and performance using application-level metrics and system-level monitoring for automation controller.
Generate consumption-based billing reports with the metrics utility
Configure and run the metrics-utility to generate consumption-based billing reports for CCSP, CCSPv2, and subscription renewal purposes.
View activity streams for all resources
View audit trails of changes and actions performed across all platform resources.
Understand and configure notifications
Create notification templates for Email, Slack, PagerDuty, webhooks, and other services to alert on automation job events.
Access log information
Locate and read automation controller log files for containerized deployments.
Send log files to third-party aggregation services
Forward automation controller logs to third-party aggregation services like Splunk, Elastic, or Loggly for centralized log management.
Send metrics to system monitoring software
Export platform metrics to monitoring systems like Prometheus for external system monitoring.
Configure logging for Event-Driven Ansible
Configure and manage logging for Event-Driven Ansible components.
Capture telemetry data for Ansible plug-ins for Red Hat Developer Hub
Configure telemetry data collection for the Ansible plug-ins running in Red Hat Developer Hub.
Capture telemetry data for the Ansible self-service portal
Configure or disable telemetry data collection for the Ansible self-service portal.
Integrate
Integrate with HashiCorp Terraform
Use the hashicorp.terraform and cloud.terraform collections to integrate Ansible with Terraform for infrastructure provisioning, including TF Actions with Event-Driven Ansible.
Integrate with HashiCorp Vault
Integrate with HashiCorp Vault for secrets management using the hashicorp.vault collection, including KV1/KV2 modules and database secrets.
Integrate with Open Policy Agent (OPA) to implement policy enforcement
Enforce policies on automation runs using Open Policy Agent (OPA) by configuring enforcement points on organizations, inventories, and job templates.
Integrate with Red Hat Lightspeed
Connect Ansible Automation Platform with Red Hat Lightspeed (formerly Insights) to create remediation projects and run automated fixes.
Optimize
Optimize platform performance
Review performance optimization strategies and automation execution settings for your Ansible Automation Platform deployment.
Workload types and access methods
Understand the different workload types and how UI authentication and REST API access affect platform load.
Vertically scale tested deployment models to improve performance
Add CPU and memory to existing nodes to improve throughput within your tested deployment model.
Horizontally scale tested deployment models to improve performance
Add nodes to your deployment to distribute automation workloads and increase platform capacity.
Horizontally scale in Event-Driven Ansible
Scale Event-Driven Ansible horizontally by adding controller instances to handle higher event throughput.
Performance tuning for operator environments
Tune Operator-based deployments by customizing pod specifications, managing resources, adjusting control planes, and assigning dedicated nodes.
Scale up to an enterprise topology
Evaluate when to migrate from a growth topology to an enterprise topology and plan the scaling of individual platform components.
Tune automation controller to improve performance
Plan capacity for automation controller node types, tune WebSocket and web server settings, and manage live event streams for optimal performance.
Tune the PostgreSQL database for optimal performance
Tune your PostgreSQL database settings and encrypt sensitive configuration data for optimal platform performance.
Tune performance for Event-Driven Ansible
Characterize your Event-Driven Ansible workload, adjust memory limits for rulebook activations, and configure system-level monitoring.
Get insights on automation across your environment with Automation Analytics
Use Automation Analytics to plan savings, explore job data, generate reports, and view automation dashboard metrics across your environment.
Manage analytics and data collection in Ansible Automation Platform
Control what usage and analytics data your Ansible Automation Platform deployment collects and sends to Red Hat.
Optimize request timeouts
Configure cascading client timeouts and OpenShift Route timeouts to prevent failed or hung automation requests.
Troubleshoot
Access troubleshooting information in Ansible Automation Platform UI
Access built-in troubleshooting tools in the platform UI, including debug settings for web requests and receptor work.
Collect configuration and diagnostic information
Gather diagnostic data using must-gather on OpenShift or sos reports on VM-based installations to support troubleshooting.
Troubleshoot your containerized deployment
Diagnose and resolve issues with your containerized Ansible Automation Platform installation, including log collection and architecture review.
Troubleshoot your Operator-based deployment of Ansible Automation Platform
Diagnose issues with Operator-based deployments by reviewing Operator logs, OpenShift events, and collecting diagnostic data.
Troubleshoot automation controller
Resolve common automation controller issues including login failures, stuck jobs, missing playbooks, and external database errors.
Troubleshoot Kerberos
Diagnose and resolve Kerberos authentication issues when connecting to managed nodes.
Troubleshoot metrics service
Troubleshoot metrics service issues in Ansible Automation Platform, including data collection failures, database connectivity problems, and service health check errors.
Troubleshoot automation portal RHEL appliance
Troubleshoot Ansible automation portal RHEL appliance issues, including first-boot configuration failures, connectivity problems, and virtual machine deployment errors.
Troubleshoot automation portal authentication
Troubleshoot authentication issues with the Ansible automation portal, including OAuth token errors, platform gateway connectivity problems, and user login failures.
Troubleshoot execution environment builder
Troubleshoot execution environment builder issues, including build failures, dependency resolution errors, and container image creation problems when using Ansible Builder.
Reference
Custom resources for Ansible Automation Platform
Look up specifications and examples for all Kubernetes custom resource definitions (CRDs) used by the Ansible Automation Platform Operator.