Collection Installation
Collection installation¶
These instructions are for regular users to install via Ansible Galaxy. To setup a development environment use these instructions.
arista.avd can also be consumed using the “AVD All-in-one” container.
Install from Ansible Galaxy¶
arista.avd collection is available on Ansible Galaxy server and can be automatically installed on your system.
Make sure to install Python requirements afterwards.
Latest version¶
$ ansible-galaxy collection install arista.avd
Warning
If you have an ansible.cfg
file in the directory where you run ansible-galaxy
, it may affect the directory under which the collection and dependencies will be installed.
Install a specific version¶
$ ansible-galaxy collection install arista.avd:==3.0.0
You can specify multiple range identifiers which are split by ,. You can use the following range identifiers:
*
: Any version, this is the default used when no range specified is set.!=
: Version is not equal to the one specified.==
: Version must be the one specified.>=
: Version is greater than or equal to the one specified.>
: Version is greater than the one specified.<=
: Version is less than or equal to the one specified.<
: Version is less than the one specified.
Install latest devel
version from AVD GitHub¶
$ ansible-galaxy collection install git+https://github.com/aristanetworks/ansible-avd.git#/ansible_collections/arista/avd/,devel
Note
Collection dependencies like ansible-cvp
will be installed from ansible-galaxy unless installed first using similar github source.
Install in a specific directory¶
If you want to install collection in a specific directory part of your project, you can call ansible-galaxy
and update your ansible.cfg
# Install collection under ${PWD/collections/}
$ ansible-galaxy collection install arista.avd -p collections/
# Update ansible.cfg file
$ vim ansible.cfg
collections_paths = ${PWD}/collections:~/.ansible/collections:/usr/share/ansible/collections
Upgrade installed AVD collection¶
You can use -U
to upgrade to a new version for any installed collection:
$ ansible-galaxy collection install -U arista.avd
Process install dependency map
Starting collection install process
Installing 'arista.avd:3.0.0' to '/root/.ansible/collections/ansible_collections/arista/avd'
Ansible resources¶
You can find some additional information about how to use ansible’s collections on the following Ansible pages: