ansible-collections / netapp.cloudmanager Goto Github PK

View Code? Open in Web Editor NEW

3.0 5.0 3.0 668 KB

Ansible collection to support NetApp Cloud Manager configuration, including CVO deployments.

Home Page: https://galaxy.ansible.com/netapp/cloudmanager

License: GNU General Public License v3.0

Python 100.00%

netapp cvo cloudmanager aws gcp azure ansible ansible-collection cloudmanager-cvo-gcp cloudmanager-cvo-aws

netapp.cloudmanager's Introduction

Ansible Collection - netapp.cloudmanager

This collection requires python 3.5 or better.

Installation

ansible-galaxy collection install netapp.cloudmanager

To use this collection, add the following to the top of your playbook:

collections:
  - netapp.cloudmanager

Requirements

ansible version >= 2.9
requests >= 2.20
python version >= '3.5'

Module documentation

https://docs.ansible.com/ansible/devel/collections/netapp/cloudmanager/

Need help

Join our Discord and look for our #ansible channel.

Code of Conduct

This collection follows the Ansible project's Code of Conduct.

Documentation

https://github.com/ansible-collections/netapp/wiki

Release Notes

21.22.0

Add svm_name option in AWS, AZURE and GCP CVO for creation and update.

21.21.0

Minor Changes

na_cloudmanager_connector_azure - expose connector managed system identity principal_id tp perform role assignment.

New Options

Add availability_zone_node1 and availability_zone_node2 options in CVO Azure HA on the location configuration.
Add new storage_type value Premium_ZRS

21.20.1

Bug Fixes

new meta/execution-environment.yml is failing ansible-builder sanitize step.

21.20.0

New Options

Add availability_zone option in CVO Azure on the location configuration.
Add cluster_key_pair_name option in CVO AWS for SSH authentication key pair method.
Add subnet_path option in CVO GCP.

Bug Fixes

Fix the machine_type default value in the connector GCP.

Minor Changes

na_cloudmanager_volume - Support AWS FsxN working environment

21.19.0

Minor Changes

Support writing_speed_state modification for AWS, AZURE and GCP CVOs.

21.18.0

na_cloudmanager_connector_azure - support full subnet_id and vnet_id
Support writing_speed_state modification for AWS, AZURE and GCP CVOs.

21.17.0

Minor Changes

na_cloudmanager_aws_fsx - Import AWS FSX to CloudManager.
Support license_type modification for AWS, AZURE and GCP CVOs.

New Options

na_cloudmanager_connector_azure - Support user defined storage_account. The storage account can be created automatically. When storage_account is not set, the name is constructed by appending 'sa' to the connector name.
na_cloudmanager_aws_fsx - Import AWS FSX to CloudManager by adding new parameters import_file_system and file_system_id.

21.16.0

Bug Fixes

na_cloudmanager_volume - Add check when volume is capacity tiered.
na_cloudmanager_connector_azure - Fix string formatting error when deleting the connector.

Minor Changes

na_cloudmanager_connector_gcp - when using the user application default credential authentication by running the command gcloud auth application-default login, gcp_service_account_path is not needed.

21.15.0

Minor Changes

Add the description of the client_id based on the cloudmanager UI.
Update license_type and capacity_package_name default values on capacity based license.

21.14.0

Minor Changes

na_cloudmanager_snapmirror - add AWS FSx to snapmirror.

Bug Fixes

CVO working environment clusterProperties is deprecated. Make changes accordingly. Add CVO update status check on instance_type change.

21.13.0

New Modules

na_cloudmanager_aws_fsx - NetApp AWS FSX

Minor Changes

na_cloudmanager_connector_aws - make the module idempotent for create and delete.
na_cloudmanager_connector_aws - automatically fetch client_id and instance_id for delete.
na_cloudmanager_connector_aws - report client_id if connector already exists.
na_cloudmanager_info - new subsets - account_info, agents_info, active_agents_info.
Add ONTAP image upgrade feature for AWS, AZURE and GCP CVOs. Add upgrade_ontap_version to indicate if upgrade ONTAP is needed. It only can be used when use_latest_version is false and ontap_version is a specific version.
Add instance_type update feature for AWS, AZURE and GCP CVOs.
na_cloudmanager_volume - Add tiering_policy and snapshot_policy_name modification, and report error if the properties cannot be changed.

Bug Fixes

na_cloudmanager_cvo_gcp - handle extra auto-gen GCP labels to fix gcp_labels update failure.
Add update_svm_password for svm_password update on AWS, AZURE and GCP CVOs. Update svm_password if update_svm_password is true.

21.12.1

Bug Fixes

na_cloudmanager_connector_aws - fix default ami not found in the region on resource file.
na_cloudmanager_snapmirror - report actual error rather than None with "Error getting destination info".

21.12.0

Minor Changes

Handle extra azure_tag on AZURE CVO and extra gcp_labels on GCP CVO HA on modification. gcp_labels modification on GCP CVO does not support remove labels.
PR1 - allow usage of Ansible module group defaults - for Ansible 2.12+.

Bug Fixes

na_cloudmanager_snapmirror - working environment get information api not working for onprem is fixed.
Fix cannot find working environment if working_environment_name is provided.

21.11.0 New Options

Adding new parameter capacity_package_name for all CVOs creation with capacity based license type capacity-paygo or ha-capacity-paygo for HA.

Minor Changes

na_cloudmanager_connector_gcp - make the module idempotent for create and delete.
na_cloudmanager_connector_gcp - automatically fetch client_id for delete.
na_cloudmanager_connector_gcp - report client_id if connector already exists.
all modules - better error reporting if refresh_token is not valid.

Bug Fixes

na_cloudmanager_connector_gcp - typeError when using proxy certificates.

21.10.0

Minor Changes

Adding support update on svm_password, tier_level, aws_tag, azure_tag and gcp_labels for all CVOs. Only these parameters will be modified on the existing CVOs.

Bug Fixes

na_cloudmanager_snapmirror - key error CloudProviderName for ONPREM operation.

New Options

Adding new parameter ha_enable_https for HA CVO to enable the HTTPS connection from CVO to storage accounts. This can impact write performance. The default is false.
Adding new parameters kms_key_id and kms_key_arn as AWS encryption parameters for AWS CVO encryption.
Adding new parameter azure_encryption_parameters for AZURE CVO encryption.
Adding new parameter gcp_encryption_parameters for GCP CVO encryption.

21.9.0

New Options

Adding selflink support on CVO GCP params: subnet_id, vpc0_node_and_data_connectivity, vpc1_cluster_connectivity, vpc2_ha_connectivity, vpc3_data_replication, subnet0_node_and_data_connectivity, subnet1_cluster_connectivity, subnet2_ha_connectivity, and subnet3_data_replication.
Adding pd-balanced support on gcp_volume_type CVO GCP and provider_volume_type for na_cloudmanager_snapmirror and na_cloudmanager_volume.

Bug Fixes

Change virtual_machine_size default value to Standard_DS3_v2.

21.8.0

New Options

Adding stage environment to all modules in cloudmanager.
Adding service account support on API operations in cloudmanager: sa_client_id and sa_secret_key. refresh_token will be ignored if service account information is provided.

Bug Fixes

Accept client_id end with or without 'clients'.

21.7.0

New Options

na_cloudmanager_cvo_aws: Support one new ebs_volume_type gp3.
Adding stage environemt to all modules in cloudmanager.
na_cloudmanager_volume: Add aggregate_name support on volume creation.
na_cloudmanager_cvo_aws: Support one new ebs_volume_type gp3.
na_cloudmanager_connector_azure: Add subnet_name as aliases of subnet_id, vnet_name as aliases of vnet_id.
na_cloudmanager_aggregate - Add provider_volume_type gp3 support.
na_cloudmanager_volume - Add provider_volume_type gp3 support.
na_cloudmanager_snapmirror - Add provider_volume_type gp3 support.

Bug Fixes

na_cloudmanager_aggregate: Improve error message.
na_cloudmanager_cvo_gcp: Apply network_project_id on vpc1_cluster_connectivity, vpc2_ha_connectivity, vpc3_data_replication, subnet1_cluster_connectivity, subnet2_ha_connectivity, subnet3_data_replication.
na_cloudmanager_connector_gcp: rename option service_account_email and service_account_path to gcp_service_account_email and gcp_service_account_path respectively.
na_cloudmanager_connector_azure: Fix KeyError client_id.
na_cloudmanager_nss_account: Improve error message.
na_cloudmanager_volume: Improve error message.

21.6.0

New Modules

na_cloudmanager_snapmirror: Create or Delete snapmirror on Cloud Manager.

Bug Fixes

na_cloudmanager_connector_gcp: Make client_id as optional.
na_cloudmanager_cvo_gcp: Change vpc_id from optional to required.

21.5.1

Bug fixes

na_cloudmanager_cifs_server: Fix incorrect API call when is_workgroup is true.
na_cloudmanager_connector_azure: Fix python error - msrest.exceptions.ValidationError. Parameter 'Deployment.properties' can not be None.
na_cloudmanager_connector_azure: Fix wrong example on the document and update account_id is required field on deletion.

21.5.0

New Options

na_cloudmanager_connector_aws: Return newly created Azure client ID in cloud manager, instance ID and account ID. New option proxy_certificates.
na_cloudmanager_cvo_aws: Return newly created AWS working_environment_id.
na_cloudmanager_cvo_azure: Return newly created AZURE working_environment_id.
na_cloudmanager_cvo_gcp: Return newly created GCP working_environment_id.

Bug Fixes

na_cloudmanager_cvo_aws: Fix incorrect placement of platformSerialNumber in the resulting json structure.

21.4.0

Module documentation changes

Remove the period at the end of the line on short_description.
Add period at the end of the names in examples.
Add notes mentioning support check_mode.

New Modules

na_cloudmanager_connector_azure: Create or delete Cloud Manager connector for Azure.
na_cloudmanager_cvo_azure: Create or delete Cloud Manager CVO for AZURE for both single and HA.
na_cloudmanager_info: Gather Cloud Manager subset information using REST APIs. Support for subsets working_environments_info, aggregates_info, accounts_info.
na_cloudmanager_connector_gcp: Create or delete Cloud Manager connector for GCP.
na_cloudmanager_cvo_gcp: Create or delete Cloud Manager CVO for GCP for both single and HA.

21.3.0

New Modules

na_cloudmanager_aggregate: Create or delete an aggregate on Cloud Volumes ONTAP, or add disks on an aggregate.
na_cloudmanager_cifs_server: Create or delete CIFS server for Cloud Volumes ONTAP.
na_cloudmanager_connector_aws: Create or delete Cloud Manager connector for AWS.
na_cloudmanager_cvo_aws: Create or delete Cloud Manager CVO for AWS for both single and HA.
na_cloudmanager_nss_account: Create or delete a nss account on Cloud Manager.
na_cloudmanager_volume: Create, modify or delete a volume on Cloud Volumes ONTAP.

netapp.cloudmanager's People

Contributors

Stargazers

Watchers

Forkers

zeten30 andersson007 bridgecrew-perf7

netapp.cloudmanager's Issues

In the netapp.cloudmanager.na_cloudmanager_info module the ontapClusterProperties is missing

Summary

When I am using the "netapp.cloudmanager.na_cloudmanager_info" module to fetch some information about the CVOs the below data is missing in the response json.
info.working_environments_info[].gcpVsaWorkingEnvironments[].ontapClusterProperties

I am basically trying to find the management IP of the CVO.

Component Name

netapp.cloudmanager.na_cloudmanager_info

Ansible Version

$ ansible --version
ansible [core 2.12.4]
  config file = /etc/ansible/ansible.cfg
  configured module search path = ['/home/xxxxxx/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
  ansible python module location = /app/awxvenv/ansible-5.6/lib/python3.8/site-packages/ansible
  ansible collection location = /home/xxxxxx/.ansible/collections:/usr/share/ansible/collections
  executable location = /app/awxvenv/ansible-5.6/bin/ansible
  python version = 3.8.13 (default, Apr  5 2022, 17:15:15) [GCC 9.1.1 20190605 (Red Hat 9.1.1-2)]
  jinja version = 3.1.1
  libyaml = True

Cloud Manager Collection Version

$ ansible-galaxy collection list
# /app/awxvenv/ansible-5.6/lib64/python3.8/site-packages/ansible_collections
Collection                    Version
----------------------------- -------
amazon.aws                    2.2.0
ansible.netcommon             2.6.1
ansible.posix                 1.3.0
ansible.utils                 2.5.2
ansible.windows               1.9.0
arista.eos                    3.1.0
awx.awx                       19.4.0
azure.azcollection            1.12.0
check_point.mgmt              2.3.0
chocolatey.chocolatey         1.2.0
cisco.aci                     2.2.0
cisco.asa                     2.1.0
cisco.intersight              1.0.18
cisco.ios                     2.8.1
cisco.iosxr                   2.9.0
cisco.ise                     1.2.1
cisco.meraki                  2.6.1
cisco.mso                     1.4.0
cisco.nso                     1.0.3
cisco.nxos                    2.9.1
cisco.ucs                     1.8.0
cloud.common                  2.1.0
cloudscale_ch.cloud           2.2.1
community.aws                 2.4.0
community.azure               1.1.0
community.ciscosmb            1.0.4
community.crypto              2.2.4
community.digitalocean        1.16.0
community.dns                 2.0.9
community.docker              2.3.0
community.fortios             1.0.0
community.general             4.7.0
community.google              1.0.0
community.grafana             1.3.3
community.hashi_vault         2.4.0
community.hrobot              1.2.3
community.kubernetes          2.0.1
community.kubevirt            1.0.0
community.libvirt             1.0.2
community.mongodb             1.3.3
community.mysql               2.3.5
community.network             3.1.0
community.okd                 2.1.0
community.postgresql          1.7.1
community.proxysql            1.3.1
community.rabbitmq            1.1.0
community.routeros            2.0.0
community.sap                 1.0.0
community.skydive             1.0.0
community.sops                1.2.1
community.vmware              1.18.0
community.windows             1.9.0
community.zabbix              1.5.1
containers.podman             1.9.3
cyberark.conjur               1.1.0
cyberark.pas                  1.0.13
dellemc.enterprise_sonic      1.1.0
dellemc.openmanage            4.4.0
dellemc.os10                  1.1.1
dellemc.os6                   1.0.7
dellemc.os9                   1.0.4
f5networks.f5_modules         1.15.0
fortinet.fortimanager         2.1.4
fortinet.fortios              2.1.4
frr.frr                       1.0.3
gluster.gluster               1.0.2
google.cloud                  1.0.2
hetzner.hcloud                1.6.0
hpe.nimble                    1.1.4
ibm.qradar                    1.0.3
infinidat.infinibox           1.3.3
infoblox.nios_modules         1.2.1
inspur.sm                     1.3.0
junipernetworks.junos         2.10.0
kubernetes.core               2.3.0
mellanox.onyx                 1.0.0
netapp.aws                    21.7.0
netapp.azure                  21.10.0
netapp.cloudmanager           21.15.0
netapp.elementsw              21.7.0
netapp.ontap                  21.17.3
netapp.storagegrid            21.10.0
netapp.um_info                21.8.0
netapp_eseries.santricity     1.3.0
netbox.netbox                 3.6.0
ngine_io.cloudstack           2.2.3
ngine_io.exoscale             1.0.0
ngine_io.vultr                1.1.1
openstack.cloud               1.7.2
openvswitch.openvswitch       2.1.0
ovirt.ovirt                   1.6.6
purestorage.flasharray        1.12.1
purestorage.flashblade        1.9.0
sensu.sensu_go                1.13.0
servicenow.servicenow         1.0.6
splunk.es                     1.0.2
t_systems_mms.icinga_director 1.28.0
theforeman.foreman            2.2.0
vyos.vyos                     2.8.0
wti.remote                    1.0.3

# /app/awxvenv/ansible-5.6/lib/python3.8/site-packages/ansible_collections
Collection                    Version
----------------------------- -------
amazon.aws                    2.2.0
ansible.netcommon             2.6.1
ansible.posix                 1.3.0
ansible.utils                 2.5.2
ansible.windows               1.9.0
arista.eos                    3.1.0
awx.awx                       19.4.0
azure.azcollection            1.12.0
check_point.mgmt              2.3.0
chocolatey.chocolatey         1.2.0
cisco.aci                     2.2.0
cisco.asa                     2.1.0
cisco.intersight              1.0.18
cisco.ios                     2.8.1
cisco.iosxr                   2.9.0
cisco.ise                     1.2.1
cisco.meraki                  2.6.1
cisco.mso                     1.4.0
cisco.nso                     1.0.3
cisco.nxos                    2.9.1
cisco.ucs                     1.8.0
cloud.common                  2.1.0
cloudscale_ch.cloud           2.2.1
community.aws                 2.4.0
community.azure               1.1.0
community.ciscosmb            1.0.4
community.crypto              2.2.4
community.digitalocean        1.16.0
community.dns                 2.0.9
community.docker              2.3.0
community.fortios             1.0.0
community.general             4.7.0
community.google              1.0.0
community.grafana             1.3.3
community.hashi_vault         2.4.0
community.hrobot              1.2.3
community.kubernetes          2.0.1
community.kubevirt            1.0.0
community.libvirt             1.0.2
community.mongodb             1.3.3
community.mysql               2.3.5
community.network             3.1.0
community.okd                 2.1.0
community.postgresql          1.7.1
community.proxysql            1.3.1
community.rabbitmq            1.1.0
community.routeros            2.0.0
community.sap                 1.0.0
community.skydive             1.0.0
community.sops                1.2.1
community.vmware              1.18.0
community.windows             1.9.0
community.zabbix              1.5.1
containers.podman             1.9.3
cyberark.conjur               1.1.0
cyberark.pas                  1.0.13
dellemc.enterprise_sonic      1.1.0
dellemc.openmanage            4.4.0
dellemc.os10                  1.1.1
dellemc.os6                   1.0.7
dellemc.os9                   1.0.4
f5networks.f5_modules         1.15.0
fortinet.fortimanager         2.1.4
fortinet.fortios              2.1.4
frr.frr                       1.0.3
gluster.gluster               1.0.2
google.cloud                  1.0.2
hetzner.hcloud                1.6.0
hpe.nimble                    1.1.4
ibm.qradar                    1.0.3
infinidat.infinibox           1.3.3
infoblox.nios_modules         1.2.1
inspur.sm                     1.3.0
junipernetworks.junos         2.10.0
kubernetes.core               2.3.0
mellanox.onyx                 1.0.0
netapp.aws                    21.7.0
netapp.azure                  21.10.0
netapp.cloudmanager           21.15.0
netapp.elementsw              21.7.0
netapp.ontap                  21.17.3
netapp.storagegrid            21.10.0
netapp.um_info                21.8.0
netapp_eseries.santricity     1.3.0
netbox.netbox                 3.6.0
ngine_io.cloudstack           2.2.3
ngine_io.exoscale             1.0.0
ngine_io.vultr                1.1.1
openstack.cloud               1.7.2
openvswitch.openvswitch       2.1.0
ovirt.ovirt                   1.6.6
purestorage.flasharray        1.12.1
purestorage.flashblade        1.9.0
sensu.sensu_go                1.13.0
servicenow.servicenow         1.0.6
splunk.es                     1.0.2
t_systems_mms.icinga_director 1.28.0
theforeman.foreman            2.2.0
vyos.vyos                     2.8.0
wti.remote                    1.0.3

Playbook

- name: Get all available subsets
      netapp.cloudmanager.na_cloudmanager_info:
        client_id: "xxxxxxxxxxxxxxxxxxxxxx"
        refresh_token: "xxxxxxxxxxxxxxxxxxxxxxxx"
        gather_subsets:
          - all

Steps to Reproduce

If we run the above playbook the issue you might notice the missing ontapClusterProperties information.

Expected Results

The ontapClusterProperties should be a json data, this data can be gathered using the http get request to the below URL.

"http:///occm/api/gcp/vsa/working-environments/vsaworkingenvironment-xxxxxx/?fields=ontapClusterProperties"

Actual Results

{
    "publicId": "vsaworkingenvironment-xxxxxxxxxxxxx",
    "name": "xxxxxxxxxxxxx",
    "tenantId": "Tenant-xxxx",
    "svmName": "xxxxxxxxxxxxx",
    "creatorUserEmail": "auth0|fwfjwefkewkfjiewfkewj",
    "status": null,
    "providerProperties": null,
    "reservedSize": null,
    "clusterProperties": null,
    "ontapClusterProperties": {
        "nodes": [
            {
                "name": "xxxxxxxxxxxxx-01",
                "lifs": [
                    {
                        "ip": "xxxxxxxxxxxxx",
                        "netmask": "255.255.255.255",
                        "lifType": "Intercluster",
                        "dataProtocols": [],
                        "nodeName": "xxxxxxxxxxxxx-01",
                        "privateIp": true
                    },
                    {
                        "ip": "xxxxxxxxxxxxx",
                        "netmask": "255.255.255.255",
                        "lifType": "Cluster Management",
                        "dataProtocols": [],
                        "nodeName": "xxxxxxxxxxxxx-01",
                        "privateIp": true
                    },
                    {
                        "ip": "xxxxxxxxxxxxx",
                        "netmask": "255.255.255.255",
                        "lifType": "Data",
                        "dataProtocols": [
                            "nfs",
                            "cifs"
                        ],
                        "nodeName": "xxxxxxxxxxxxx-01",
                        "privateIp": true
                    },
                    {
                        "ip": "xxxxxxxxxxxxx",
                        "netmask": "255.255.255.255",
                        "lifType": "Data",
                        "dataProtocols": [
                            "iscsi"
                        ],
                        "nodeName": "xxxxxxxxxxxxx-01",
                        "privateIp": true
                    },
                    {
                        "ip": "xxxxxxxxxxxxx",
                        "netmask": "255.255.255.255",
                        "lifType": "SVM Management",
                        "dataProtocols": [],
                        "nodeName": "xxxxxxxxxxxxx-01",
                        "privateIp": true
                    }
                ],
                "serialNumber": "xxxxxxxxxxxxx",
                "systemId": "xxxxxxxxxxxxx",
                "platformLicense": null,
                "platformSerialNumber": null,
                "cloudProviderId": "",
                "healthy": true,
                "inTakeover": false
            }
        ],
        "clusterName": "xxxxxxxxxxxxx",
        "clusterUuid": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "ontapVersion": "9.11.1RC1",
        "systemManagerUrl": "https://xxxxxxxxxxxxx/sysmgr/SysMgr.html",
        "creationTime": 1655958859671,
        "licenseType": {
            "name": "Cloud Volumes ONTAP Capacity Based Charging",
            "capacityLimit": {
                "size": 2000.0,
                "unit": "TB"
            }
        },
        "licensePackageName": "Essential",
        "isKeystoneSubscription": false,
        "lastModifiedOffbox": null,
        "offboxTarget": false,
        "upgradeVersions": null,
        "writingSpeedState": "NORMAL",
        "broadcastDomainInfos": [
            {
                "broadcastDomain": "Cluster",
                "ipSpace": "Cluster",
                "mtu": 9000
            },
            {
                "broadcastDomain": "Default",
                "ipSpace": "Default",
                "mtu": 1460
            }
        ],
        "evaluation": false,
        "capacityTierInfo": null,
        "canConfigureCapacityTier": false,
        "usedCapacity": {
            "size": 0.06346679687430878,
            "unit": "TB"
        },
        "userName": "admin",
        "wormEnabled": false,
        "isSpaceReportingLogical": true,
        "vscanFileOperationDefaultProfile": "standard",
        "aggregateCount": 1,
        "volumeCount": 72
    },
    "cloudProviderName": "GCP",
    "snapshotPolicies": null,
    "actionsRequired": null,
    "activeActions": null,
    "replicationProperties": null,
    "schedules": null,
    "svms": null,
    "workingEnvironmentType": "VSA",
    "supportRegistrationProperties": null,
    "supportRegistrationInformation": [],
    "capacityFeatures": null,
    "encryptionProperties": null,
    "supportedFeatures": null,
    "isHA": false,
    "haProperties": null,
    "fpolicyProperties": null,
    "saasProperties": null,
    "cbsProperties": null,
    "complianceProperties": null,
    "monitoringProperties": null,
    "licensesInformation": null
}

Important information for collection maintainers

SUMMARY

Dear maintainers,

This is important for your collections!

In accordance with the Community decision, we have created the news-for-maintainers repository for announcements of changes impacting collection maintainers (see the examples) instead of Issue 45 that will be closed soon.
- To keep yourself well-informed and, therefore, things in your collection working, please subscribe to the repository by using the Watch button in the upper right corner on the repository's home page.
- If you do not want to get notifications about related discussions, please subscribe only to Issues.
- Please read the brief guidelines on how the repository should be used.
- Please avoid unnecessary discussions in issues, use the Discussions feature. Every comment posted will notify a lot of folks!
Also we would like to remind you about the Bullhorn contributor newsletter which has recently started to be released weekly. To learn what it looks like, see the past releases. Please subscribe and talk to the Community via Bullhorn!
Join us in #ansible-social (for news reporting & chat), #ansible-community (for discussing collection & maintainer topics), and other channels on Matrix/IRC.
Help the Community and the Steering Committee to make right decisions by taking part in discussing and voting on the Community Topics that impact the whole project and the collections in particular. Your opinion there will be much appreciated!

Thank you!

Action required: Add stable-2.13 to the test matrix

Dear maintainers,

According to the Collection requirements, collections included in the ansible package MUST run the ansible-test sanity command from the latest stable ansible-core branch.

It has been recently announced via the news-for-maintainers repository that the ansible-core stable-2.13 branch is available for testing.

Please add the stable-2.13 branch to your test matrix in the .github/workflows directory, at least, in the sanity jobs section. Any questions, just mention me here.
If you have integration and/or unit tests, please consider adding the branch to the corresponding sections too.
If you're not subscribed to the news-for-maintainers repository, please do it to avoid CI related issues in the future.
If the issue is not relevant to your collection, please close it.

Thank you!

Ansible Contributor Summit. Tuesday, April 12, 2022.

Ansible Contributor Summit

We are happy to announce that the registration for the Ansible Contributor Summit is open!

Why

This is a great opportunity for interested people to meet, discuss related topics, share their stories and opinions, get the latest important updates and just to hang out together.
There will be different announcements & presentations by Community, Core, Cloud, Network, and other teams.
Current contributors will be happy to share their stories and experience with newcomers.
There will be links to interactive self-passed instruqt scenarios shared during the event that help newcomers learn different aspects of development.

Where/when

Online on Matrix and Youtube. Tuesday, April 12, 2022, 12:00 - 20:00 UTC.

How to join

Add the event to your calendar. Use the ical URL (for example, in Google Calendar "Add other calendars" > "Import from URL") instead of importing the .ics file so that any updates to the event will be reflected in your calendar.
Check out the Summit page:
- Add you name to attendees.
- Suggest summit topics that would be interesting to you to hear about.
- Vote on and propose changes to topics suggested by others.
- If you want to be a presenter, please contact the Ansible Community team via [email protected].

We are looking forward to seeing you!:)

Allow FSxN provisioning without ONTAP Cloud credentials

Summary

First of all, thank you for providing the netapp.cloudmanager.na_cloudmanager_aws_fsx module.It really looks very handy.

However it seems like this module requires that we present credentials to associate the newly created filesystem with an ONTAP Cloud account. While I understand this makes sense from a NetApp perspective, as a vendor, some people (like me) may would like to try to use this product in a test/development environment, without necessarily connecting with an account.

Would it be possible to remove the ONTAP Cloud account requirement? I know it's possible to use without it because I can create a new filesystem using the AWS web interface, but I would like to do the same via Ansible.

Thank you.

Component Name

netapp.cloudmanager.na_cloudmanager_aws_fsx

Additional Information

No playbook available at this time.

single node CVO in GCP requires subnetPath in shared VPC case

Summary

getting error message "Failed to retrieve vpc host-network"
when using shared vpc host project with network name "host-network"
and when creating single node CVO instance using netapp.cloudmanager.na_cloudmanager_cvo_gcp
Comparison of arguments of working API call vs the one that ansible collection(v21.15.0) submits shows missing
subnetPath argument.

working API call has both subnetPath and subnetId having the same value
...
"subnetPath": "projects/shared-vpc-host-project/regions/us-central1/subnetworks/cvo-subnetwork-name",
"subnetId": "projects/shared-vpc-host-project/regions/us-central1/subnetworks/cvo-subnetwork-name",
"vpcId": "host-network",
...

connector logs show that network name that connector tries to use is formed using project_id rather than network_project_id
Hard to say whose fault is that given that description of optional subnetPath argument is very vague. I guess that argument is required when network is in different project

Component Name

na_cloudmanager_cvo_gcp

Ansible Version

$ ansible --version
ansible [core 2.11.3] 
...
python version = 3.9.7 (default, Jan  1 2020, 00:00:00) [GCC 8.3.0]
jinja version = 3.0.1
libyaml = True

Cloud Manager Collection Version

$ ansible-galaxy collection list
...
Collection          Version
------------------- -------
ansible.posix       1.3.0
netapp.cloudmanager 21.15.0

Playbook

- name: test
  hosts: localhost
  connection: local
  tasks:
    - name: Create NetApp Cloud Manager cvo for GCP
      netapp.cloudmanager.na_cloudmanager_cvo_gcp:
        state: present
        name: ansible
        project_id: cvo-project
        network_project_id: shared-vpc-host
        vpc_id: host-network
        zone: us-central1-c
        subnet_id: "projects/shared-vpc-host/regions/us-central1/subnetworks/cvo-subnetwork-name"
        firewall_rule: allow-cvo-traffic
        gcp_volume_type: pd-ssd
        gcp_volume_size: 500
        gcp_volume_size_unit: GB
        gcp_service_account: "[email protected]"
        data_encryption_type: GCP
        svm_password: "password"
        ontap_version: latest
        use_latest_version: true
        capacity_package_name: Freemium
        license_type: capacity-paygo
        instance_type: n2-standard-4
        client_id: "CLIENT-ID-HERE"
        workspace_id: "WORKSPACE-ID-HERE"
        sa_client_id: "SA-CLIENT-ID-HERE"
        sa_secret_key: "SA-SECRET-KEY-HERE"
        capacity_tier: cloudStorage

Steps to Reproduce

$ ansible-playbook ./cvo.yml

Expected Results

expected CVO instance to get created

Actual Results

...
[WARNING]: Module did not set no_log for update_svm_password
fatal: [localhost]: FAILED! => {
    "changed": false
}

MSG:

Error: unexpected response on creating cvo gcp: 400, b'{"message":"Failed to retrieve vpc host-network","causeMessage":"BadRequestException: Failed to retrieve vpc host-network"}'

PLAY RECAP **************************************************************************************************************************************************
localhost                  : ok=1    changed=0    unreachable=0    failed=1    skipped=0    rescued=0    ignored=0

Consider using true/false for all booleans in docs

Based on the community decision to use true/false for boolean values in documentation and examples, we ask that you evaluate booleans in this collection and consider changing any that do not use true/false (lowercase).

See documentation block format for more info (specifically, option defaults).

If you have already implemented this or decide not to, feel free to close this issue.

P.S. This is auto-generated issue, please raise any concerns here

netapp.cloudmanager 21.22.1 is not tagged

Summary

Hi! As part of the ansible community package release process, we've determined that version 21.22.1 of netapp.cloudmanager was released to Ansible Galaxy but not properly tagged in this Git repository. This violates the repository management section of the Collection Requirements:

Every collection MUST have a public git repository. Releases of the collection MUST be tagged in said repository. This means that releases MUST be git taged and that the tag name MUST exactly match the Galaxy version number. Tag names MAY have a v prefix, but a collection's tag names MUST have a consistent format from release to release.

Additionally, collection artifacts released to Galaxy MUST be built from the sources that are tagged in the collection's git repository as that release. Any changes made during the build process MUST be clearly documented so the collection artifact can be reproduced.

If the collection maintainers do not respond to this issue within a reasonable a amount of time, the collection is subject to Removal from ansible.

Component Name

collection

Ansible Version

all

Cloud Manager Collection Version

latest

Playbook

irrelevant

Steps to Reproduce

irrelevant

Expected Results

irrelevant

Actual Results

irrelevant