-
Notifications
You must be signed in to change notification settings - Fork 41
Description
Is your feature request related to a problem? Please describe.
I'm always frustrated when I must refactor example Ansible content provided in repositories to work within an Ansible Automation Platform (AAP) 2.x environment. The current examples are heavily focused on the Ansible command-line interface (CLI) and do not provide clear guidance on how to properly set up and run these plays within AWX or AAP. This makes it difficult for less experienced users to transition from CLI-based Ansible to the automation controller model. Additionally, I must manually update the Ansible execution environments (EEs) within AAP to include the necessary collections for these examples, a process which lacks centralized, professional documentation.
Describe the solution you'd like
I would like to see a centralized, deeply technical article that provides clear instructions and best practices for converting CLI-based Ansible examples to be compatible with AAP 2.x. This documentation should cover how to set up projects, define job templates, and, most importantly, how to create and configure custom execution environments to include required collections.
Furthermore, I propose that this documentation be linked directly from console.redhat.com within relevant role descriptions. Providing an example of this process within each role's documentation would be ideal, but I understand the potential burden of this. The core need is a single, authoritative source for this information.
Describe alternatives you've considered
There are no viable alternatives to this solution as the problem is unique to the Red Hat ecosystem and the specific features of Ansible Automation Platform. The documentation needs to be created by Red Hat to be considered authoritative and to address the specific nuances of their product.
Additional context
No additional context is required at this time.