{"id":20588831,"url":"https://github.com/ciscodevnet/ansible-aci","last_synced_at":"2025-05-16T15:06:14.774Z","repository":{"id":37456437,"uuid":"221995650","full_name":"CiscoDevNet/ansible-aci","owner":"CiscoDevNet","description":"Cisco ACI Ansible Collection","archived":false,"fork":false,"pushed_at":"2025-04-11T00:35:44.000Z","size":3185,"stargazers_count":148,"open_issues_count":29,"forks_count":101,"subscribers_count":33,"default_branch":"master","last_synced_at":"2025-04-12T14:57:30.327Z","etag":null,"topics":["ansible-collection"],"latest_commit_sha":null,"homepage":"https://galaxy.ansible.com/cisco/aci","language":"Python","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/CiscoDevNet.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-15T20:11:09.000Z","updated_at":"2025-04-11T00:35:17.000Z","dependencies_parsed_at":"2023-10-20T18:54:05.143Z","dependency_job_id":"a91da778-dc3f-4f9c-80bf-1278e3283dcd","html_url":"https://github.com/CiscoDevNet/ansible-aci","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CiscoDevNet%2Fansible-aci","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CiscoDevNet%2Fansible-aci/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CiscoDevNet%2Fansible-aci/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CiscoDevNet%2Fansible-aci/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CiscoDevNet","download_url":"https://codeload.github.com/CiscoDevNet/ansible-aci/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248586249,"owners_count":21128997,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["ansible-collection"],"created_at":"2024-11-16T07:26:42.055Z","updated_at":"2025-04-12T14:57:45.112Z","avatar_url":"https://github.com/CiscoDevNet.png","language":"Python","readme":"# ansible-aci\n\n## Description\n\nThe `ansible-aci` project provides an Ansible collection for managing and automating your Cisco Application Centric Infrastructure (ACI) environment. It consists of a set of modules and roles for performing tasks related to ACI.\n\nSee the [cisco.aci collection index](https://galaxy.ansible.com/ui/repo/published/cisco/aci/content/) for a full list of modules and plugins.\n\n## Requirements\n\n- Ansible v2.16 or newer\n- Python v3.11 or newer\n\nFollow the [Installing Ansible](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html) guide for detailed instructions.\n\n## Installation\n\nBefore using this collection, you need to install it with the Ansible Galaxy command-line tool:\n\n```sh\nansible-galaxy collection install cisco.aci\n```\n\nYou can also include this collection in a `requirements.yml` file and install it with:\n\n```sh\nansible-galaxy collection install -r requirements.yml\n```\n\nUsing the following `requirements.yml` format:\n\n```yaml\ncollections:\n  - name: cisco.aci\n```\n\nNote that if you install any collections from Ansible Galaxy, they will not be upgraded automatically when you upgrade the Ansible package.\nTo upgrade the collection to the latest available version, run the following command:\n\n```sh\nansible-galaxy collection install cisco.aci --upgrade\n```\n\nYou can also install a specific version of the collection. For example, to install version 1.0.0, use the following syntax:\n\n```sh\nansible-galaxy collection install cisco.aci:==1.0.0\n```\n\nSee [using Ansible collections](https://docs.ansible.com/ansible/devel/user_guide/collections_using.html) for more details.\n\n### Latest Build\n\nFollow these instructions to get the latest collection.\n\n#### First Approach - Build From Source Code\n\nClone the ansible-aci repository.\n\n```sh\ngit clone https://github.com/CiscoDevNet/ansible-aci.git\n```\n\nGo to the ansible-aci directory\n\n```sh\ncd ansible-aci\n```\n\nPull the latest master on your aci\n\n```sh\ngit pull origin master\n```\n\nBuild and Install a collection from source\n\n```sh\nansible-galaxy collection build --force\nansible-galaxy collection install cisco-aci-* --force\n```\n\n#### Second Approach - Download From Latest CI Build\n\nGo to [ansible-aci Actions](https://github.com/CiscoDevNet/ansible-aci/actions/workflows/ansible-test.yml?query=branch%3Amaster) and select the latest CI build.\n\nUnder Artifacts download collection suffixed with the latest version of Ansible (eg. `collection-stable-2.17`) and unzip it using Terminal or Console.\n\n*Note: The collection file is a zip file containing a tar.gz file. We recommend using CLI because some GUI-based unarchiver might unarchive both nested archives in one go.*\n\nInstall the unarchived tar.gz file\n\n```sh\nansible-galaxy collection install cisco-aci-1.0.0.tar.gz —-force\n```\n\n## Use Cases\n\nOnce the collection is installed, you can use it in a playbook by specifying the full namespace path to the module, plugin and/or role.\n\n### Adding a new EPG\n\n```yml\n- hosts: aci\n  gather_facts: no\n\n  tasks:\n  - name: Add a new EPG\n    cisco.aci.aci_epg:\n      hostname: apic\n      username: admin\n      password: SomeSecretPassword\n      tenant: production\n      ap: intranet\n      epg: web_epg\n      description: Web Intranet EPG\n      bd: prod_bd\n    delegate_to: localhost\n```\n\n## Optimizing Playbooks\n\nThere are two main methods to optimize the execution of ACI modules in your playbooks.\n\n1. Using the ACI HTTPAPI plugin\n1. Using the `suppress_` options\n\nTo find out more about optimizing playbook execution, please refer to the [Optimizing Playbooks](docs/optimizing.md) documentation.\n\n## Testing\n\nIntegration tests for each module in the `cisco.aci` collection are executed on the following ACI versions:\n\n- 4.2\n- 5.2\n- 6.0\n\n## Contributing\n\nOngoing development efforts and contributions to this collection are tracked as issues in this repository.\n\nWe welcome community contributions to this collection. If you find problems, need an enhancement or need a new module, please open an issue or create a PR against the [Cisco ACI collection repository](https://github.com/CiscoDevNet/ansible-aci/issues).\n\n## Support\n\nThis collection supports any ACI version within the Last Day of Support (LDOS) date.\n\nCertain modules and options in the collection are only available from specific versions of ACI. The versions that a module or option supports are documented in the individual module documentation.\n\nTo find EOL announcements for ACI versions, refer to the [End-of-Life and End-of-Sale Notices](https://www.cisco.com/c/en/us/products/cloud-systems-management/application-policy-infrastructure-controller-apic/eos-eol-notice-listing.html) page.\n\n## Release Notes\n\nSee the [Changelog](CHANGELOG.rst) for full release notes.\n\n## Related Information\n\nFor further information and guides, refer to the following:\n\n- [Cisco ACI DevNet Documentation](https://developer.cisco.com/docs/aci/ansible/#cisco-aci-ansible-modules)\n- [Automating ACI using Ansible](https://developer.cisco.com/docs/nexus-as-code/aci-with-ansible/#automating-aci-using-ansible)\n- [ACI Programmability Learning Lab](https://developer.cisco.com/learning/tracks/aci-programmability/)\n\n## License Information\n\nThis collection is licensed under the [GNU General Public License v3.0](LICENSE)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fciscodevnet%2Fansible-aci","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fciscodevnet%2Fansible-aci","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fciscodevnet%2Fansible-aci/lists"}