{"id":18151035,"url":"https://github.com/redhat-cop/aap_configuration_extended","last_synced_at":"2026-02-15T04:05:19.057Z","repository":{"id":258481554,"uuid":"867884624","full_name":"redhat-cop/aap_configuration_extended","owner":"redhat-cop","description":"providing extended functionality that is not in aap_configuration","archived":false,"fork":false,"pushed_at":"2026-01-27T09:34:28.000Z","size":2048,"stargazers_count":13,"open_issues_count":13,"forks_count":31,"subscribers_count":14,"default_branch":"devel","last_synced_at":"2026-01-27T22:09:51.893Z","etag":null,"topics":["aap","ansible","hacktoberfest"],"latest_commit_sha":null,"homepage":"","language":"YAML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/redhat-cop.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.rst","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-10-04T23:31:26.000Z","updated_at":"2026-01-21T09:26:20.000Z","dependencies_parsed_at":"2024-10-24T19:30:41.563Z","dependency_job_id":"d4354cbb-26d3-40a0-acc4-463d30b6bc49","html_url":"https://github.com/redhat-cop/aap_configuration_extended","commit_stats":null,"previous_names":["redhat-cop/aap_configuration_extended"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/redhat-cop/aap_configuration_extended","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-cop%2Faap_configuration_extended","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-cop%2Faap_configuration_extended/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-cop%2Faap_configuration_extended/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-cop%2Faap_configuration_extended/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/redhat-cop","download_url":"https://codeload.github.com/redhat-cop/aap_configuration_extended/tar.gz/refs/heads/devel","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-cop%2Faap_configuration_extended/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29468393,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T01:01:38.065Z","status":"online","status_checked_at":"2026-02-15T02:00:07.449Z","response_time":118,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aap","ansible","hacktoberfest"],"created_at":"2024-11-02T01:06:12.469Z","updated_at":"2026-02-15T04:05:19.034Z","avatar_url":"https://github.com/redhat-cop.png","language":"YAML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Red Hat Communities of Practice AAP Configuration Extended Collection\n\n![pre-commit tests](https://github.com/redhat-cop/aap_configuration_extended/actions/workflows/pre-commit.yml/badge.svg)\n![Release](https://github.com/redhat-cop/aap_configuration_extended/actions/workflows/release.yml/badge.svg)\n\u003c!-- Further CI badges go here as above --\u003e\n\nThis Ansible collection extends the `infra.aap_configuration` collection by providing extra functionalities that allows advanced operations on the Ansible Automation Platform Configuration as Code.\n\n## Getting Help\n\nWe are on the Ansible Forums and Matrix, if you want to discuss something, ask for help, or participate in the community, please use the #infra-config-as-code tag on the form, or post to the chat in Matrix.\n\n[Ansible Forums](https://forum.ansible.com/tag/infra-config-as-code)\n\n[Matrix Chat Room](https://matrix.to/#/#aap_config_as_code:ansible.com)\n\n## Requirements\n\nThe only one collection required by `infra.aap_configuration_extended` is the `infra.aap_configuration` (and that one is requiring other collections: ansible.platform, ansible.hub, ansible.controller and ansible.eda). You can copy this `requirements.yaml` file example:\n\n```yaml\n---\ncollections:\n  - name: ansible.controller\n  - name: ansible.hub\n  - name: ansible.platform\n  - name: infra.aap_configuration\n...\n```\n\n## Links to Ansible Automation Platform Collections\n\n|                                      Collection Name                                |            Purpose            |\n|:-----------------------------------------------------------------------------------:|:-----------------------------:|\n| [ansible.platform repo](https://github.com/ansible/ansible.platform)                | gateway/platform modules      |\n| [ansible.hub repo](https://github.com/ansible-collections/ansible_hub)              | Automation hub modules        |\n| [ansible.controller repo](https://github.com/ansible/awx/tree/devel/awx_collection) | Automation controller modules |\n| [ansible.eda repo](https://github.com/ansible/event-driven-ansible)                 | Event Driven Ansible modules  |\n\n## Links to other Validated Configuration Collections for Ansible Automation Platform\n\n|                                      Collection Name                                   |                      Purpose                                        |\n| :------------------------------------------------------------------------------------: | :-----------------------------------------------------------------: |\n| [AAP Configuration](https://github.com/redhat-cop/infra.aap_configuration)             | Easy interaction with Ansible Automation Platform via Ansible roles |\n| [EE Utilities](https://github.com/redhat-cop/ee_utilities)                             | Execution Environment creation utilities                            |\n| [AAP installation Utilities](https://github.com/redhat-cop/aap_utilities)              | Ansible Automation Platform Utilities                               |\n| [AAP Configuration Template](https://github.com/redhat-cop/aap_configuration_template) | Configuration Template for this suite                               |\n\n## Included content\n\nClick the `Content` button to see the list of content included in this collection.\n\n## Installing this collection\n\nYou can install the infra.aap_configuration_extended.collection with the Ansible Galaxy CLI:\n\n```console\nansible-galaxy collection install infra.aap_configuration_extended\n```\n\nYou can also include it in a `requirements.yml` file and install it with `ansible-galaxy collection install -r requirements.yml`, using the format:\n\n```yaml\n---\ncollections:\n  - name: infra.aap_configuration_extended\n    # If you need a specific version of the collection, you can specify like this:\n    # version: ...\n```\n\n## Using this collection\n\nThe awx.awx or ansible.controller collection must be invoked in the playbook in order for Ansible to pick up the correct modules to use.\n\nThe following command will invoke the collection playbook. This is considered a starting point for the collection.\n\n```console\nansible-playbook infra.aap_configuration_extended.configure_controller.yml\n```\n\nOtherwise it will look for the modules only in your base installation. If there are errors complaining about \"couldn't resolve module/action\" this is the most likely cause.\n\n```yaml\n- name: Playbook to configure ansible controller post installation\n  hosts: localhost\n  connection: local\n  vars:\n    controller_validate_certs: true\n  collections:\n    - awx.awx\n```\n\nDefine following vars here, or in `controller_configs/controller_auth.yml`\n`aap_hostname: ansible-controller-web-svc-test-project.example.com`\n\nYou can also specify authentication by a combination of either:\n\n- `aap_hostname`, `aap_username`, `aap_password`\n- `aap_hostname`, `aap_oauthtoken`\n\nThe OAuth2 token is the preferred method. You can obtain the token through the preferred `controller_token` module, or through the\nAWX CLI [login](https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.5/html/automation_execution_api_overview/controller-api-auth-methods)\ncommand.\n\nThese can be specified via (from highest to lowest precedence):\n\n- direct role variables as mentioned above\n- environment variables (most useful when running against localhost)\n- a config file path specified by the `controller_config_file` parameter\n- a config file at `~/.controller_cli.cfg`\n- a config file at `/etc/controller/controller_cli.cfg`\n\nConfig file syntax looks like this:\n\n```ini\n[general]\nhost = https://localhost:8043\nverify_ssl = true\noauth_token = LEdCpKVKc4znzffcpQL5vLG8oyeku6\n```\n\nController token module would be invoked with this code:\n\n```yaml\n    - name: Create a new token using controller username/password\n      awx.awx.token:\n        description: 'Creating token to test controller jobs'\n        scope: \"write\"\n        state: present\n        controller_host: \"{{ aap_hostname }}\"\n        aap_username: \"{{ aap_username }}\"\n        aap_password: \"{{ aap_password }}\"\n\n```\n\n### Automate the Automation\n\nEvery Ansible Controller instance has it's own particularities and needs. Every administrator team has it's own practices and customs. This collection allows adaptation to every need, from small to large scale, having the objects distributed across multiple environments and leveraging Automation Webhook that can be used to link a Git repository and Ansible automation natively.\n\nA complete example of how to use all of the roles present in the collection is available at the following [README.md](https://github.com/redhat-cop/aap_configuration_extended/blob/devel/roles/filetree_create/automatetheautomation.md), where all the phases to allow CI/CD for the Controller Configuration are provided.\n\n#### Scale at your needs\n\nThe input data can be organized in a very flexible way, letting the user use anything from a single file to an entire file tree to store the controller objects definitions, which could be used as a logical segregation of different applications, as needed in real scenarios.\n\n### Controller Export\n\nThe awx command line can export json that is compatible with this collection.\nIn addition there is an awx.awx/ansible.controller export module that use the awx command line to export.\nSee [the export guide](https://github.com/redhat-cop/aap_configuration_extended/blob/devel/EXPORT_README.md) for more details\n\n### Template Example\n\nSee [our template](https://github.com/redhat-cop/aap_configuration_template) to use in order to start using the collections can be found\n\n### See Also\n\n- [Ansible Using collections](https://docs.ansible.com/ansible/latest/user_guide/collections_using.html) for more details.\n\n## Release and Upgrade Notes\n\nFor details on changes between versions, please see [the changelog for this collection](https://github.com/redhat-cop/aap_configuration_extended/blob/devel/CHANGELOG.rst).\n\n## Releasing, Versioning and Deprecation\n\nThis collection follows [Semantic Versioning](https://semver.org/). More details on versioning can be found [in the Ansible docs](https://docs.ansible.com/ansible/latest/dev_guide/developing_collections.html#collection-versions).\n\nWe plan to regularly release new minor or bugfix versions once new features or bugfixes have been implemented.\n\nReleasing the current major version happens from the `devel` branch.\n\n## Roadmap\n\nAdding the ability to use direct output from the awx export command in the roles along with the current data model.\n\n## Contributing to this collection\n\nWe welcome community contributions to this collection. If you find problems, please open an issue or create a PR against the [Controller Configuration collection repository](https://github.com/redhat-cop/aap_configuration_extended).\nMore information about contributing can be found in our [Contribution Guidelines.](https://github.com/redhat-cop/aap_configuration_extended/blob/devel/.github/CONTRIBUTING.md)\n\nWe have a community meeting every 4 weeks. Find the agenda in the [issues](https://github.com/redhat-cop/aap_configuration_extended/issues) and the calendar invitation below:\n\n## Code of Conduct\n\nThis collection follows the Ansible project's\n[Code of Conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html).\nPlease read and familiarize yourself with this document.\n\n## Licensing\n\nGNU General Public License v3.0 or later.\n\nSee [LICENSE](https://github.com/redhat-cop/aap_configuration_extended/blob/devel/LICENSE) to see the full text.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredhat-cop%2Faap_configuration_extended","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fredhat-cop%2Faap_configuration_extended","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredhat-cop%2Faap_configuration_extended/lists"}