netapp.cloudmanager.na_cloudmanager_cvo_aws 模块 – 用于 AWS 的 NetApp Cloud Manager CVO

注意

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

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

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

要在 playbook 中使用它,请指定:netapp.cloudmanager.na_cloudmanager_cvo_aws

netapp.cloudmanager 21.3.0 中的新增功能

概要

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

参数

参数

注释

aws_tag

列表 / 元素=字典

AWS CVO 工作环境的其他标签。

tag_key

字符串

标签的键。

tag_value

字符串

标签值。

backup_volumes_to_cbs

布尔值

自动启用将所有卷备份到 S3。

选择

  • false ← (默认)

  • true

capacity_package_name

字符串

在 netapp.cloudmanager 21.12.0 中添加

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

仅在自带许可证容量型时可用 Essential。

Professional 可作为 AWS 市场或自带许可证容量型的年度合同提供。

选择

  • "Professional"

  • "Essential" ← (默认)

  • "Freemium"

capacity_tier

字符串

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

选择

  • "S3" ← (默认)

  • "NONE"

client_id

字符串 / 必需

Cloud Manager 连接器的连接器 ID。

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

cloud_provider_account

字符串

部署 Cloud Volumes ONTAP 系统时使用的云提供商凭证 ID。

您可以在 Cloud Manager 的“设置”>“凭据”页面中找到 ID。

如果未指定,Cloud Manager 将使用连接器的实例配置文件。

cluster_floating_ip

字符串

对于 HA 浮动 IP,集群管理浮动 IP 地址。

cluster_key_pair_name

字符串

在 netapp.cloudmanager 21.20.0 中添加

SSH 身份验证密钥对名称

data_encryption_type

字符串

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

选择

  • "AWS" ← (默认)

  • "NONE"

data_floating_ip

字符串

对于 HA 浮动 IP,数据浮动 IP 地址。

data_floating_ip2

字符串

对于 HA 浮动 IP,数据浮动 IP 地址。

ebs_volume_size

整数

第一个数据聚合的 EBS 卷大小。

对于 GB,该值可以是 [100 或 500]。

对于 TB,该值可以是 [1,2,4,8,16]。

默认值: 1

ebs_volume_size_unit

字符串

ebs 卷大小的单位。

选择

  • "GB"

  • "TB" ← (默认)

ebs_volume_type

字符串

第一个数据聚合的 EBS 卷类型。

选择

  • "gp3"

  • "gp2" ← (默认)

  • "io1"

  • "sc1"

  • "st1"

enable_compliance

布尔值

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

选择

  • false ← (默认)

  • true

enable_monitoring

布尔值

在工作环境中启用监视服务。

选择

  • false ← (默认)

  • true

environment

字符串

在 netapp.cloudmanager 21.8.0 中添加

用于 NetApp Cloud Manager API 操作的环境。

选择

  • "prod" ← (默认)

  • "stage"

failover_mode

字符串

对于 HA,HA 对的故障转移模式。“PrivateIP”用于单个可用区,“FloatingIP”用于多个可用区。

选择

  • "PrivateIP"

  • "FloatingIP"

feature_flags

字典

在 netapp.cloudmanager 21.11.0 中添加

启用或禁用新功能。

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

支持的键和值可能会更改,恕不另行通知。 将忽略未知键。

instance_profile_name

字符串

工作环境的实例配置文件名称。 如果未提供,Cloud Manager 将创建实例配置文件。

instance_tenancy

字符串

EC2 实例租户。

选择

  • "default" ← (默认)

  • "dedicated"

instance_type

字符串

要使用的实例类型,它取决于许可证类型。

探索 [‘m5.xlarge’]。

标准 [‘m5.2xlarge’,’r5.xlarge’]。

高级 [‘m5.4xlarge’,’r5.2xlarge’,’c4.8xlarge’]。

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

默认值: "m5.2xlarge"

iops

整数

预配置的 IOPS。 仅当 provider_volume_type 为 ‘io1’ 或 ‘gp3’ 时才需要。

is_ha

布尔值

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

选择

  • false ← (默认)

  • true

kms_key_arn

字符串

在 netapp.cloudmanager 21.10.0 中添加

AWS 加密参数。 如果使用 aws 加密,则需要它。 只能指定 KMS 密钥 ID 或 KMS arn 中的一个。

kms_key_id

字符串

Aws 加密参数。 如果使用 aws 加密,则需要它。 只能指定 KMS 密钥 ID 或 KMS arn 中的一个。

license_type

字符串

要使用的许可证类型。

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

对于按节点付费的单节点 [‘cot-explore-paygo’、‘cot-standard-paygo’、‘cot-premium-paygo’]。

单节点,按节点购买 [‘cot-premium-byol’]。

高可用性 (HA),按容量购买 [‘ha-capacity-paygo’]

高可用性 (HA),按节点即用即付 [‘ha-cot-explore-paygo’,’ha-cot-standard-paygo’,’ha-cot-premium-paygo’]。

高可用性 (HA),按节点购买 [‘ha-cot-premium-byol’]。

选择

  • "capacity-paygo" ← (默认)

  • "cot-standard-paygo"

  • "cot-premium-paygo"

  • "cot-explore-paygo"

  • "cot-premium-byol"

  • "ha-cot-standard-paygo"

  • "ha-cot-premium-paygo"

  • "ha-cot-premium-byol"

  • "ha-cot-explore-paygo"

  • "ha-capacity-paygo"

mediator_assign_public_ip

布尔值

用于分配公有 IP 的布尔选项。

选择

  • false

  • true ← (默认)

mediator_key_pair_name

字符串

对于高可用性 (HA),仲裁器实例的密钥对名称。

mediator_subnet_id

字符串

对于高可用性 (HA),仲裁器的子网 ID。

name

字符串 / 必需

要管理的 AWS 云管理器 CVO 的名称。

node1_subnet_id

字符串

对于高可用性 (HA),第一个节点的子网 ID。

node2_subnet_id

字符串

对于高可用性 (HA),第二个节点的子网 ID。

nss_account

字符串

要在此 Cloud Volumes ONTAP 系统中使用的 NetApp 支持站点帐户 ID。

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

ontap_version

字符串

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

默认值: "latest"

optimized_network_utilization

布尔值

使用优化的网络利用率。

选择

  • false

  • true ← (默认)

platform_serial_number

字符串

集群的序列号。使用 ‘cot-premium-byol’ 时需要此项。

platform_serial_number_node1

字符串

对于高可用性 (HA) BYOL,第一个节点的序列号。使用 ‘ha-cot-premium-byol’ 时需要此项。

platform_serial_number_node2

字符串

对于高可用性 (HA) BYOL,第二个节点的序列号。使用 ‘ha-cot-premium-byol’ 时需要此项。

provided_license

字符串

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

refresh_token

字符串

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

region

字符串 / 必需

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

route_table_ids

列表 / 元素=字符串

对于高可用性 (HA) 浮动 IP,将使用浮动 IP 更新的路由表 ID 列表。

sa_client_id

字符串

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

sa_secret_key

字符串

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

security_group_id

字符串

工作环境的安全组 ID。如果未提供,Cloud Manager 将创建安全组。

state

字符串

指定的 AWS 云管理器 CVO 是否应该存在。

选择

  • "present" ← (默认)

  • "absent"

subnet_id

字符串

将在其中创建工作环境的子网 ID。仅在单节点时需要。

svm_floating_ip

字符串

对于高可用性 (HA) 浮动 IP,SVM 管理浮动 IP 地址。

svm_name

字符串

已在 netapp.cloudmanager 21.22.0 中添加

SVM 的名称。

svm_password

字符串 / 必需

Cloud Volumes ONTAP 的管理员密码。

它将在每次运行时更新。

throughput

整数

单位为 Mb/s。有效范围为 125-1000。

仅当 provider_volume_type 为 ‘gp3’ 时才需要。

tier_level

字符串

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

选择

  • "normal" ← (默认)

  • "ia"

  • "ia-single"

  • "intelligent"

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 ← (默认)

vpc_id

字符串

将在其中创建工作环境的 VPC ID。

如果未提供此参数,将通过使用提供的子网 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) 对无关。

注释

注意

  • 支持 check_mode。

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

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

示例

- name: Create NetApp Cloud Manager CVO for AWS single
  netapp.cloudmanager.na_cloudmanager_cvo_aws:
    state: present
    refresh_token: "{{ xxxxxxxxxxxxxxx }}"
    name: AnsibleCVO
    region: us-west-1
    subnet_id: subnet-xxxxxxx
    vpc_id: vpc-xxxxxxxx
    svm_password: P@assword!
    client_id: "{{ xxxxxxxxxxxxxxx }}"
    writing_speed_state: NORMAL
    aws_tag: [
        {tag_key: abc,
        tag_value: a123}]

- name: Create NetApp Cloud Manager CVO for AWS HA
  netapp.cloudmanager.na_cloudmanager_cvo_aws:
    state: present
    refresh_token: "{{ xxxxxxxxxxxxxxx }}"
    name: AnsibleCVO
    region: us-west-1
    subnet_id: subnet-xxxxxxx
    vpc_id: vpc-xxxxxxxx
    svm_password: P@assword!
    client_id: "{{ xxxxxxxxxxxxxxx }}"
    writing_speed_state: NORMAL
    aws_tag: [
        {tag_key: abc,
        tag_value: a123}]
    is_ha: true
    failover_mode: FloatingIP
    node1_subnet_id: subnet-1
    node2_subnet_id: subnet-1
    mediator_subnet_id: subnet-1
    mediator_key_pair_name: key1
    cluster_floating_ip: 2.1.1.1
    data_floating_ip: 2.1.1.2
    data_floating_ip2: 2.1.1.3
    svm_floating_ip: 2.1.1.4
    route_table_ids: [rt-1,rt-2]

- name: Delete NetApp Cloud Manager cvo for AWS
  netapp.cloudmanager.na_cloudmanager_cvo_aws:
    state: absent
    name: ansible
    region: us-west-1
    refresh_token: "{{ xxxxxxxxxxxxxxx }}"
    subnet_id: subnet-xxxxxxx
    vpc_id: vpc-xxxxxxxx
    svm_password: P@assword!
    client_id: "{{ xxxxxxxxxxxxxxx }}"

返回值

常用返回值在此处 记录,以下是此模块独有的字段

描述

working_environment_id

字符串

新创建的 AWS CVO working_environment_id。

返回: 成功

作者

  • NetApp Ansible 团队 (@carchi8py)