There are currently 7 NetApp Collections
- ONTAP
- over 100 modules to support ONTAP configuration.
- CloudManager
- new modules to create a connector, single or HA CVO instances, aggregates, volumes, CIFS server, NSS accounts, iSCSI igroups/initiators.
- new info module to gather information about accounts, working_environments, aggregates.
- modules for connector and CVO support AWS, Azure, and GCP. Modules are specialized for each cloud provider.
- modules for aggregates and volumes support AWS, Azure, and GCP.
- In addition, a Terraform provider for CloudManager already supports all of the above on the 3 clouds.
- ANF for Azure
- Azure NetApp Files on Azure - accounts, resource pools, volumes, snapshots.
- CVS for AWS
- Cloud Volumes Service on AWS - AD, pools, volumes (filesystems), snapshots.
- UM info for ONTAP
- Retrieve information about ONTAP systems from Unified Manager - clusters, nodes, aggregates, svms, volumes.
- ElementSW (SolidFire)
- modules to support ElementSW configuration on SolidFire and HCI systems.
- StorageGRID
- modules to support StorageGRID configuration.
Releasing, Versioning and Deprecation
- ansible version >= 2.9
- requests >= 2.20
- only for ONTAP
- netapp-lib version >= 2018.11.13
- six
- only for ElementSW, or when using ONTAP SnapMirror with ElementSW
- solidfire-sdk-python >= 1.5.0.87
- check the
requirements.txtfile provided with the collection as of 21.3.0 for a detailed list.
ansible-galaxy collection install netapp.ontapansible-galaxy collection install netapp.cloudmanageransible-galaxy collection install netapp.azureansible-galaxy collection install netapp.awsansible-galaxy collection install netapp.um_infoansible-galaxy collection install netapp.elementswansible-galaxy collection install netapp.storagegridIf you do not have connectivity to Galaxy in your production environment, you will need to:
- download a collection tarball in an environment with access to internet,
- move the tarball from the public environment to your private environment. The specifics depends on your company,
- use
galaxy collection installwith the tarball file in your private environment.
There are two ways to download the collection tarball:
- CLI:
galaxy collection download <collection_path> - GUI: using the Ansible Galaxy web site, locate the collection of interest and click the
Download tarballbutton.
ansible-galaxy collection download netapp.cloudmanagerTransfer file, then install it:
ansible-galaxy collection install collections/netapp-cloudmanager-21.3.0.tar.gzIf you see a certificate issue when accessing galaxy, you can update your certificate, or disable the security check (at your own risk!):
-c, --ignore-certs Ignore SSL certificate validation errors.
If a collection is already installed, use the --force option to force an update if needed.
https://docs.ansible.com/ansible/latest/cli/ansible-galaxy.html
The collections that are certified are also available in Red Hat Automation Hub if you have a subscription.
See https://docs.ansible.com/ansible/latest/collections/ for documentation.
The documentation generation may lag, in the meantime use ansible-doc for the latest updates. For instance:
ansible-doc netapp.ontap.na_ontap_svm
ansible-doc netapp.cloudmanager.na_cloudmanager_aggregate
New collections which are not yet visible on Ansible docs site are documented at: https://github.com/ansible-collections/netapp/wiki
Join our Slack Channel at Netapp.io