Git installation¶
Using Git as the source of collections in Ansible provides an easy way to implement all the changes once they’re part of the development branch without waiting for a new tagged version shipped to Ansible Galaxy.
Use Git as the source of collection¶
In this setup, the Git repository will be used by Ansible as a collection. It’s useful when working on feature development as we can change the Git branch and test code live.
Clone the remote repository¶
# Clone repository
git clone https://github.com/aristanetworks/ansible-avd.git
# Move to git folder
cd ansible-avd
Update your ansible.cfg¶
In your project, update your ansible.cfg file to point collection_paths to your local version of ansible-avd
- Get the full path to your newly cloned AVD repository.
- Configure your project to use the AVD repository as a source of collections:
# Update your ansible.cfg in your playbook project
# $ vim ansible.cfg
[default]
...
collections_paths = /path/to/ansible/avd/collection_repository
...
Build & install collection from Git¶
This approach uses an Ansible collection package built from the current Git version and installed locally.
Clone repository¶
Build and install collection¶
This section should be used only to test collection packaging and to create an offline package to ship on your internal resources if required.
ansible-galaxy collection build --force ansible_collections/arista/avd
ansible-galaxy collection install arista-avd-<VERSION>.tar.gz
Last update:
June 12, 2023