netapp.cloudmanager.na_cloudmanager_cvo_gcp – NetApp Cloud Manager CVO for GCP

Note

This plugin is part of the netapp.cloudmanager collection (version 21.12.1).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install netapp.cloudmanager.

To use it in a playbook, specify: netapp.cloudmanager.na_cloudmanager_cvo_gcp.

New in version 21.4.0: of netapp.cloudmanager

Synopsis

  • Create, delete, or manage Cloud Manager CVO for GCP.

Parameters

Parameter Choices/Defaults Comments
backup_volumes_to_cbs
boolean
    Choices:
  • no ←
  • yes
Automatically backup all volumes to cloud.
capacity_package_name
string
added in 21.12.0 of netapp.cloudmanager
    Choices:
  • Professional
  • Essential
  • Freemium
Capacity package name is required when selecting a capacity based license.
Essential only available with Bring Your Own License Capacity-Based.
Professional available as an annual contract from a cloud provider or Bring Your Own License Capacity-Based.
capacity_tier
string
    Choices:
  • cloudStorage
Whether to enable data tiering for the first data aggregate.
client_id
string / required
The client ID of the Cloud Manager Connector.
You can find the ID from the Connector tab on https://cloudmanager.netapp.com.
data_encryption_type
string
    Choices:
  • GCP
Type of encryption to use for this working environment.
enable_compliance
boolean
    Choices:
  • no ←
  • yes
Enable the Cloud Compliance service on the working environment.
environment
string
added in 21.8.0 of netapp.cloudmanager
    Choices:
  • prod ←
  • stage
The environment for NetApp Cloud Manager API operations.
feature_flags
dictionary
added in 21.11.0 of netapp.cloudmanager
Enable or disable a new feature.
This can be used to enable an experimental feature or disable a new feature that breaks backward compatibility.
Supported keys and values are subject to change without notice. Unknown keys are ignored.
firewall_rule
string
Firewall name for a single node cluster.
gcp_encryption_parameters
string
added in 21.10.0 of netapp.cloudmanager
The GCP encryption parameters.
gcp_labels
list / elements=dictionary
Optionally provide up to four key-value pairs with which to all GCP entities created by Cloud Manager.
label_key
string
The key of the label.
label_value
string
The label value.
gcp_service_account
string / required
The gcp_service_account email in order to enable tiering of cold data to Google Cloud Storage.
gcp_volume_size
integer
GCP volume size.
gcp_volume_size_unit
string
    Choices:
  • GB
  • TB
GCP volume size unit.
gcp_volume_type
string
    Choices:
  • pd-balanced
  • pd-standard
  • pd-ssd
GCP volume type.
instance_type
string
Default:
"n1-standard-8"
The type of instance to use, which depends on the license type you choose.
Explore ['custom-4-16384'].
Standard ['n1-standard-8'].
Premium ['n1-standard-32'].
BYOL all instance types defined for PayGo.
For more supported instance types, refer to Cloud Volumes ONTAP Release Notes.
is_ha
boolean
    Choices:
  • no ←
  • yes
Indicate whether the working environment is an HA pair or not.
license_type
string
    Choices:
  • gcp-cot-standard-paygo ←
  • gcp-cot-explore-paygo
  • gcp-cot-premium-paygo
  • gcp-cot-premium-byol
  • gcp-ha-cot-standard-paygo
  • gcp-ha-cot-premium-paygo
  • gcp-ha-cot-explore-paygo
  • gcp-ha-cot-premium-byol
  • capacity-paygo
  • ha-capacity-paygo
The type of license to use.
Single node ['gcp-cot-explore-paygo', 'gcp-cot-standard-paygo', 'gcp-cot-premium-paygo', 'gcp-cot-premium-byol', 'capacity-paygo'].
HA ['gcp-ha-cot-explore-paygo', 'gcp-ha-cot-standard-paygo', 'gcp-ha-cot-premium-paygo', 'gcp-cot-premium-byol', 'ha-capacity-paygo'].
Use capacity-paygo or ha-capacity-paygo for HA on selecting Bring Your Own License type Capacity-Based or Freemium.
Use gcp-cot-premium-boyl or gcp-ha-cot-permium-boyl for HA on selecting Bring Your Own License type Node-Based.
mediator_zone
string
The zone for mediator.
Option for HA pair only.
name
string / required
The name of the Cloud Manager CVO for GCP to manage.
network_project_id
string
The project id in GCP associated with the Subnet.
If not provided, it is assumed that the Subnet is within the previously specified project id.
node1_zone
string
Zone for node 1.
Option for HA pair only.
node2_zone
string
Zone for node 2.
Option for HA pair only.
nss_account
string
The NetApp Support Site account ID to use with this Cloud Volumes ONTAP system.
If the license type is BYOL and an NSS account isn't provided, Cloud Manager tries to use the first existing NSS account.
ontap_version
string
Default:
"latest"
The required ONTAP version. Ignored if 'use_latest_version' is set to true.
platform_serial_number
string
The serial number for the system. Required when using 'gcp-cot-premium-byol'.
platform_serial_number_node1
string
For HA BYOL, the serial number for the first node.
Option for HA pair only.
platform_serial_number_node2
string
For HA BYOL, the serial number for the second node.
Option for HA pair only.
project_id
string / required
The ID of the GCP project.
provided_license
string
Using a NLF license file for BYOL deployment
refresh_token
string
The refresh token for NetApp Cloud Manager API operations.
sa_client_id
string
The service account secret client ID for NetApp Cloud Manager API operations.
sa_secret_key
string
The service account secret key for NetApp Cloud Manager API operations.
state
string
    Choices:
  • present ←
  • absent
Whether the specified Cloud Manager CVO for GCP should exist or not.
subnet0_node_and_data_connectivity
string
Subnet path for nic1, required for node and data connectivity.
If using shared VPC, network_project_id must be provided.
Option for HA pair only.
subnet1_cluster_connectivity
string
Subnet path for nic2, required for cluster connectivity.
Option for HA pair only.
subnet2_ha_connectivity
string
Subnet path for nic3, required for HA connectivity.
Option for HA pair only.
subnet3_data_replication
string
Subnet path for nic4, required for HA connectivity.
Option for HA pair only.
subnet_id
string
The name of the subnet for Cloud Volumes ONTAP.
svm_password
string
The admin password for Cloud Volumes ONTAP.
It will be updated on each run.
tier_level
string
    Choices:
  • standard ←
  • nearline
  • coldline
The tiering level when 'capacity_tier' is set to 'cloudStorage'.
use_latest_version
boolean
    Choices:
  • no
  • yes ←
Indicates whether to use the latest available ONTAP version.
vpc0_firewall_rule_name
string
Firewall rule name for vpc1.
Option for HA pair only.
vpc0_node_and_data_connectivity
string
VPC path for nic1, required for node and data connectivity.
If using shared VPC, network_project_id must be provided.
Option for HA pair only.
vpc1_cluster_connectivity
string
VPC path for nic2, required for cluster connectivity.
Option for HA pair only.
vpc1_firewall_rule_name
string
Firewall rule name for vpc2.
Option for HA pair only.
vpc2_firewall_rule_name
string
Firewall rule name for vpc3.
Option for HA pair only.
vpc2_ha_connectivity
string
VPC path for nic3, required for HA connectivity.
Option for HA pair only.
vpc3_data_replication
string
VPC path for nic4, required for data replication.
Option for HA pair only.
vpc3_firewall_rule_name
string
Firewall rule name for vpc4.
Option for HA pair only.
vpc_id
string / required
The name of the VPC.
workspace_id
string
The ID of the Cloud Manager workspace where you want to deploy Cloud Volumes ONTAP.
If not provided, Cloud Manager uses the first workspace.
You can find the ID from the Workspace tab on [https://cloudmanager.netapp.com].
writing_speed_state
string
The write speed setting for Cloud Volumes ONTAP ['NORMAL','HIGH'].
Default value is 'NORMAL' for non-HA GCP CVO
This argument is not relevant for HA pairs.
zone
string / required
The zone of the region where the working environment will be created.

Notes

Note

  • Support check_mode.

  • The modules prefixed with na_cloudmanager are built to manage CloudManager and CVO deployments in AWS/GCP/Azure clouds.

  • If sa_client_id and sa_secret_key are provided, service account will be used in operations. refresh_token will be ignored.

Examples

- name: Create NetApp Cloud Manager cvo for GCP
  netapp.cloudmanager.na_cloudmanager_cvo_gcp:
    state: present
    name: ansiblecvogcp
    project_id: default-project
    zone: us-east4-b
    subnet_id: default
    gcp_volume_type: pd-ssd
    gcp_volume_size: 500
    gcp_volume_size_unit: GB
    gcp_service_account: "{{ xxxxxxxxxxxxxxx }}"
    data_encryption_type: GCP
    svm_password: "{{ xxxxxxxxxxxxxxx }}"
    ontap_version: latest
    use_latest_version: true
    license_type: gcp-cot-standard-paygo
    instance_type: n1-standard-8
    client_id: "{{ xxxxxxxxxxxxxxx }}"
    workspace_id: "{{ xxxxxxxxxxxxxxx }}"
    capacity_tier: cloudStorage
    writing_speed_state: NORMAL
    refresh_token: "{{ xxxxxxxxxxxxxxx }}"
    vpc_id: default
    gcp_labels:
      - label_key: key1
        label_value: value1
      - label_key: key2
        label_value: value2

- name: Create NetApp Cloud Manager cvo ha for GCP
  netapp.cloudmanager.na_cloudmanager_cvo_gcp:
    state: present
    name: ansiblecvogcpha
    project_id: "default-project"
    zone: us-east1-b
    gcp_volume_type: pd-ssd
    gcp_volume_size: 500
    gcp_volume_size_unit: GB
    gcp_service_account: "{{ xxxxxxxxxxxxxxx }}"
    data_encryption_type: GCP
    svm_password: "{{ xxxxxxxxxxxxxxx }}"
    ontap_version: ONTAP-9.9.0.T1.gcpha
    use_latest_version: false
    license_type: gcp-ha-cot-explore-paygo
    instance_type: custom-4-16384
    client_id: "{{ xxxxxxxxxxxxxxx }}"
    workspace_id:  "{{ xxxxxxxxxxxxxxx }}"
    capacity_tier: cloudStorage
    writing_speed_state: NORMAL
    refresh_token: "{{ xxxxxxxxxxxxxxx }}"
    is_ha: true
    mediator_zone: us-east1-b
    node1_zone: us-east1-b
    node2_zone: us-east1-b
    subnet0_node_and_data_connectivity: default
    subnet1_cluster_connectivity: subnet2
    subnet2_ha_connectivity: subnet3
    subnet3_data_replication: subnet1
    vpc0_node_and_data_connectivity: default
    vpc1_cluster_connectivity: vpc2
    vpc2_ha_connectivity: vpc3
    vpc3_data_replication: vpc1
    vpc_id: default
    subnet_id: default

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
working_environment_id
string
success
Newly created GCP CVO working_environment_id.



Authors