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

注意

此模块是 netapp.cloudmanager 集合(版本 21.24.0)的一部分。

如果您正在使用 ansible 包,您可能已经安装了这个集合。它不包含在 ansible-core 中。要检查是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用:ansible-galaxy collection install netapp.cloudmanager

要在剧本中使用它,请指定:netapp.cloudmanager.na_cloudmanager_cvo_gcp

netapp.cloudmanager 21.4.0 中的新功能

概要

  • 创建、删除或管理适用于 GCP 的 Cloud Manager CVO。

参数

参数

注释

backup_volumes_to_cbs

布尔值

自动将所有卷备份到云。

选项

  • false ←(默认)

  • true

capacity_package_name

字符串

在 netapp.cloudmanager 21.12.0 中添加

当选择基于容量的许可证时,需要容量包名称。

选项

  • "Professional"

  • "Essential" ←(默认)

  • "Freemium"

capacity_tier

字符串

是否为第一个数据聚合启用数据分层。

选项

  • "cloudStorage"

client_id

字符串 / 必需

Cloud Manager 连接器的连接器 ID。

您可以在 https://cloudmanager.netapp.com 上的“连接器”选项卡中找到该 ID。

data_encryption_type

字符串

用于此工作环境的加密类型。

选项

  • "GCP"

enable_compliance

布尔值

在工作环境上启用云合规服务。

选项

  • false ←(默认)

  • true

environment

字符串

在 netapp.cloudmanager 21.8.0 中添加

NetApp Cloud Manager API 操作的环境。

选项

  • "prod" ←(默认)

  • "stage"

feature_flags

字典

在 netapp.cloudmanager 21.11.0 中添加

启用或禁用新功能。

这可以用来启用实验性功能或禁用破坏向后兼容性的新功能。

支持的键和值如有更改,恕不另行通知。 未知键将被忽略。

firewall_rule

字符串

单节点集群的防火墙名称。

gcp_encryption_parameters

字符串

在 netapp.cloudmanager 21.10.0 中添加

GCP 加密参数。

gcp_labels

列表 / 元素=字典

可以选择提供最多四个键值对,用于标记 Cloud Manager 创建的所有 GCP 实体。

label_key

字符串

标签的键。

label_value

字符串

标签值。

gcp_service_account

字符串 / 必需

gcp_service_account 电子邮件,以便启用将冷数据分层到 Google Cloud Storage。

gcp_volume_size

整数

GCP 卷大小。

gcp_volume_size_unit

字符串

GCP 卷大小单位。

选项

  • "GB"

  • "TB"

gcp_volume_type

字符串

GCP 卷类型。

选项

  • "pd-balanced"

  • "pd-standard"

  • "pd-ssd"

instance_type

字符串

要使用的实例类型,这取决于您选择的许可证类型。

探索 [‘custom-4-16384’]。

标准 [‘n1-standard-8’]。

高级 [‘n1-standard-32’]。

BYOL 定义用于 PayGo 的所有实例类型。

有关更多支持的实例类型,请参阅 Cloud Volumes ONTAP 发行说明。

默认值: "n1-standard-8"

is_ha

布尔值

指示工作环境是否为 HA 对。

选项

  • false ←(默认)

  • true

license_type

字符串

要使用的许可证类型。

对于单节点按容量 [‘capacity-paygo’]。

对于单节点按节点即用即付 [‘gcp-cot-explore-paygo’, ‘gcp-cot-standard-paygo’, ‘gcp-cot-premium-paygo’]。

对于单节点按节点自带许可 [‘gcp-cot-premium-byol’]。

对于 HA 按容量 [‘ha-capacity-paygo’]。

对于 HA 按节点即用即付 [‘gcp-ha-cot-explore-paygo’, ‘gcp-ha-cot-standard-paygo’, ‘gcp-ha-cot-premium-paygo’]。

对于 HA 按节点自带许可 [‘gcp-cot-premium-byol’]。

选项

  • "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"

mediator_zone

字符串

中间器的区域。

仅适用于 HA 对的选项。

name

字符串 / 必需

要管理的 GCP 的 Cloud Manager CVO 的名称。

network_project_id

字符串

与子网关联的 GCP 中的项目 ID。

如果未提供,则假定子网位于先前指定的项目 ID 中。

node1_zone

字符串

节点 1 的区域。

仅适用于 HA 对的选项。

node2_zone

字符串

节点 2 的区域。

仅适用于 HA 对的选项。

nss_account

字符串

用于此 Cloud Volumes ONTAP 系统的 NetApp 支持站点帐户 ID。

如果许可证类型是 BYOL 且未提供 NSS 帐户,Cloud Manager 将尝试使用第一个现有的 NSS 帐户。

ontap_version

字符串

所需的 ONTAP 版本。如果 ‘use_latest_version’ 设置为 true,则忽略此项。

默认值: "latest"

platform_serial_number

字符串

系统的序列号。使用 ‘gcp-cot-premium-byol’ 时是必需的。

platform_serial_number_node1

字符串

对于 HA BYOL,第一个节点的序列号。

仅适用于 HA 对的选项。

platform_serial_number_node2

字符串

对于 HA BYOL,第二个节点的序列号。

仅适用于 HA 对的选项。

project_id

字符串 / 必需

GCP 项目的 ID。

provided_license

字符串

使用 NLF 许可证文件进行 BYOL 部署

refresh_token

字符串

用于 NetApp Cloud Manager API 操作的刷新令牌。

sa_client_id

字符串

用于 NetApp Cloud Manager API 操作的服务帐户客户端 ID。

sa_secret_key

字符串

用于 NetApp Cloud Manager API 操作的服务帐户密钥。

state

字符串

指定的用于 GCP 的 Cloud Manager CVO 是否应该存在。

选项

  • "present" ← (默认)

  • "absent"

subnet0_node_and_data_connectivity

字符串

nic1 的子网路径,节点和数据连接需要此项。

如果使用共享 VPC,则必须提供 network_project_id。

仅适用于 HA 对的选项。

subnet1_cluster_connectivity

字符串

nic2 的子网路径,集群连接需要此项。

仅适用于 HA 对的选项。

subnet2_ha_connectivity

字符串

nic3 的子网路径,HA 连接需要此项。

仅适用于 HA 对的选项。

subnet3_data_replication

字符串

nic4 的子网路径,HA 连接需要此项。

仅适用于 HA 对的选项。

subnet_id

字符串

Cloud Volumes ONTAP 的子网名称。

subnet_path

字符串

在 netapp.cloudmanager 21.20.0 中添加

单节点集群的子网路径。

svm_name

字符串

在 netapp.cloudmanager 21.22.0 中添加

SVM 的名称。

svm_password

字符串

Cloud Volumes ONTAP 的管理员密码。

它将在每次运行时更新。

tier_level

字符串

当 ‘capacity_tier’ 设置为 ‘cloudStorage’ 时的分层级别。

选项

  • "standard" ← (默认)

  • "nearline"

  • "coldline"

update_svm_password

布尔值

在 netapp.cloudmanager 21.13.0 中添加

指示是否更新 CVO 上的 svm_password。

当设置为 true 时,该模块不是幂等的,因为我们无法读取当前密码。

选项

  • false ←(默认)

  • true

upgrade_ontap_version

布尔值

在 netapp.cloudmanager 21.13.0 中添加

指示是否升级 CVO 上的 ONTAP 映像。

如果当前版本已与所需版本匹配,则不执行任何操作。

选项

  • false ←(默认)

  • true

use_latest_version

布尔值

指示是否使用最新的可用 ONTAP 版本。

选项

  • false

  • true ← (默认)

vpc0_firewall_rule_name

字符串

vpc1 的防火墙规则名称。

仅适用于 HA 对的选项。

vpc0_node_and_data_connectivity

字符串

nic1 的 VPC 路径,节点和数据连接需要此项。

如果使用共享 VPC,则必须提供 network_project_id。

仅适用于 HA 对的选项。

vpc1_cluster_connectivity

字符串

nic2 的 VPC 路径,集群连接需要此项。

仅适用于 HA 对的选项。

vpc1_firewall_rule_name

字符串

vpc2 的防火墙规则名称。

仅适用于 HA 对的选项。

vpc2_firewall_rule_name

字符串

vpc3 的防火墙规则名称。

仅适用于 HA 对的选项。

vpc2_ha_connectivity

字符串

nic3 的 VPC 路径,HA 连接需要此项。

仅适用于 HA 对的选项。

vpc3_data_replication

字符串

nic4 的 VPC 路径,数据复制需要此项。

仅适用于 HA 对的选项。

vpc3_firewall_rule_name

字符串

vpc4 的防火墙规则名称。

仅适用于 HA 对的选项。

vpc_id

字符串 / 必需

VPC 的名称。

workspace_id

字符串

您要部署 Cloud Volumes ONTAP 的 Cloud Manager 工作区的 ID。

如果未提供,Cloud Manager 将使用第一个工作区。

您可以从 [https://cloudmanager.netapp.com] 上的“工作区”选项卡中找到 ID。

writing_speed_state

字符串

Cloud Volumes ONTAP 的写入速度设置 [‘NORMAL’,’HIGH’]。

对于非 HA GCP CVO,默认值为 ‘NORMAL’

此参数与 HA 对无关。

zone

字符串 / 必需

将在其中创建工作环境的区域的区域。

备注

注意

  • 支持 check_mode。

  • 前缀为 na_cloudmanager 的模块旨在管理 AWS/GCP/Azure 云中的 CloudManager 和 CVO 部署。

  • 如果提供了 sa_client_id 和 sa_secret_key,则操作将使用服务帐户。refresh_token 将被忽略。

示例

- 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_path: projects/<project>/regions/<region>/subnetworks/<subnetwork>
    subnet_id: projects/<project>/regions/<region>/subnetworks/<subnetwork>
    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: capacity-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: ha-capacity-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

返回值

通用返回值记录在这里,以下是此模块独有的字段

描述

working_environment_id

字符串

新创建的 GCP CVO working_environment_id。

返回:成功

作者

  • NetApp Ansible 团队 (@carchi8py)