NetApp ONTAP Ansible Collection installing from GitHub

We recommend to use Ansible Galaxy see NetApp ONTAP Ansible Collection

But if there is a need to get the latest features or bug fixes from main, read on.

RISK: if you use our GitHub main branch, the version will show as the next version to be released. If we commit additional changes, your local copy will be different from what is released, but with the same version number.

Installation directly from GitHub

ansible-galaxy collection install git+https://github.com/ansible-collections/netapp.ontap.git,main

Note: this may require Ansible 2.10 or later

Installation in a closed environment

If you do not have connectivity to GitHub in your production environment, you will need to:

1. download the code and create a collection tarball in an environment with access to internet,
2. move the tarball from the public environment to your private environment. The specifics depends on your company,
3. use galaxy collection install with the tarball file in your private environment.

Example

Download the code from GitHub and create a tarball

ansible-galaxy collection download git+https://github.com/ansible-collections/netapp.ontap.git,main

Transfer file, then install it:

ansible-galaxy collection install collections/netapp-ontap-21.8.0.tar.gz

If a collection is already installed, use the --force option to force an update if needed.

Additional information

Detailed example of building a collection

ansible-galaxy collection download git+https://github.com/ansible-collections/netapp.ontap.git,main

[DEPRECATION WARNING]: Ansible will require Python 3.8 or newer on the controller starting with Ansible 2.12. Current version: 3.7.5 (default, Oct 17 2019, 12:25:15) [GCC 8.3.0]. This feature will be removed from ansible-core in version 2.12. 
Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg.
Cloning into '/home/laurentn/.ansible/tmp/ansible-local-3067la5htn59/tmplx4kssk9/netapp.ontaphvmaha9d'...
remote: Enumerating objects: 5565, done.
remote: Counting objects: 100% (5565/5565), done.
remote: Compressing objects: 100% (1814/1814), done.
remote: Total 5565 (delta 3767), reused 5439 (delta 3646), pack-reused 0
Receiving objects: 100% (5565/5565), 2.13 MiB | 454.00 KiB/s, done.
Resolving deltas: 100% (3767/3767), done.
Already on 'main'
Your branch is up to date with 'origin/main'.
Process download dependency map
Starting collection download process to '/home/laurentn/atelier/ansible_wsl/ansible-playbooks/collections'
Virtual collection "virtual collection Git repo" is not downloadable
Downloading collection 'netapp.ontap:21.8.0' to '/home/laurentn/atelier/ansible_wsl/ansible-playbooks/collections'
Created collection for netapp.ontap at /home/laurentn/atelier/ansible_wsl/ansible-playbooks/collections/netapp-ontap-21.8.0.tar.gz
Collection 'netapp.ontap:21.8.0' was downloaded successfully
Writing requirements.yml file of downloaded collections to '/home/laurentn/atelier/ansible_wsl/ansible-playbooks/collections/requirements.yml'