netapp.cloudmanager.na_cloudmanager_cvo_azure 模块 – NetApp Cloud Manager CVO/工作环境在 Azure 中的单节点或高可用性模式。

注意

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

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

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

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

netapp.cloudmanager 21.4.0 中的新增功能

概要

  • 创建、删除或管理 Azure 中的单节点或高可用性模式下的 Cloud Manager CVO/工作环境。

参数

参数

注释

allow_deploy_in_existing_rg

布尔值

指示是否允许在现有资源组中创建。

选项

  • false ← (默认)

  • true

availability_zone

整数

netapp.cloudmanager 21.20.0 中新增

位置配置上的可用区。

availability_zone_node1

整数

netapp.cloudmanager 21.21.0 中新增

高可用性配置中节点 1 的可用区。

availability_zone_node2

整数

netapp.cloudmanager 21.21.0 中新增

高可用性配置中节点 2 的可用区。

azure_encryption_parameters

字符串

netapp.cloudmanager 21.10.0 中新增

Azure 加密参数。如果使用 Azure 加密,则需要此参数。

azure_tag

列表 / 元素=字典

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

tag_key

字符串

标签的键。

tag_value

字符串

标签的值。

backup_volumes_to_cbs

布尔值

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

选项

  • false ← (默认)

  • true

capacity_package_name

字符串

netapp.cloudmanager 21.12.0 中新增

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

仅当自带许可证基于容量时才可用“Essential”。

“Professional”可作为云提供商的年度合同或自带许可证基于容量获得。

选项

  • “Professional”

  • "Essential" ← (默认)

  • “Freemium”

capacity_tier

字符串

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

选项

  • "Blob" ← (默认)

  • “NONE”

cidr

字符串 / 必需

VNET 的 CIDR。如果未提供,资源需要 az 登录以授权并从 Azure 获取 cidr 详情。

client_id

字符串 / 必需

Cloud Manager 连接器的连接器 ID。

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

cloud_provider_account

字符串

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

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

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

data_encryption_type

字符串

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

选项

  • "AZURE" ← (默认)

  • “NONE”

disk_size

整数

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

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

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

默认值: 1

disk_size_unit

字符串

磁盘大小的单位。

选项

  • “GB”

  • "TB" ← (默认)

enable_compliance

布尔值

在工作环境上启用 Cloud Compliance 服务。

选项

  • false ← (默认)

  • true

enable_monitoring

布尔值

在工作环境上启用监控服务。

选项

  • false ← (默认)

  • true

environment

字符串

netapp.cloudmanager 21.8.0 中新增

NetApp Cloud Manager API 操作的环境。

选项

  • "prod" ← (默认)

  • “stage”

feature_flags

字典

netapp.cloudmanager 21.11.0 中新增

启用或禁用新功能。

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

支持的键和值可能会在未经通知的情况下发生更改。未知键将被忽略。

ha_enable_https

布尔值

netapp.cloudmanager 21.10.0 中新增

对于高可用性 (HA),请启用从 CVO 到存储帐户的 HTTPS 连接。这可能会影响写入性能。默认值为 false。

选项

  • false

  • true

instance_type

字符串

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

探索 [‘Standard_DS3_v2’]。

标准 [‘Standard_DS4_v2’, ‘Standard_DS13_v2’, ‘Standard_L8s_v2’]。

高级 [‘Standard_DS5_v2’, ‘Standard_DS14_v2’]。

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

默认值: "Standard_DS4_v2"

is_ha

布尔值

指示工作环境是否为高可用性 (HA) 对。

选项

  • false ← (默认)

  • true

license_type

字符串

要使用的许可证类型。

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

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

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

对于高可用性 (HA) 按容量付费 [‘ha-capacity-paygo’]。

对于高可用性 (HA) 按节点付费 [‘azure-ha-cot-standard-paygo’, ‘azure-ha-cot-premium-paygo’]。

对于高可用性 (HA) 按节点自带许可证 [‘azure-ha-cot-premium-byol’]。

选项

  • "azure-cot-standard-paygo"

  • "azure-cot-premium-paygo"

  • "azure-cot-premium-byol"

  • "azure-cot-explore-paygo"

  • "azure-ha-cot-standard-paygo"

  • "azure-ha-cot-premium-paygo"

  • "azure-ha-cot-premium-byol"

  • "capacity-paygo" ← (默认)

  • "ha-capacity-paygo"

location

字符串 / 必需

将创建工作环境的位置。

name

字符串 / 必需

用于管理的 AZURE Cloud Manager CVO 的名称。

nss_account

字符串

要与此 Cloud Volumes ONTAP 系统一起使用的 NetApp 支持站点帐户 ID。

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

ontap_version

字符串

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

默认值: "latest"

platform_serial_number_node1

字符串

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

platform_serial_number_node2

字符串

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

provided_license

字符串

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

refresh_token

字符串

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

resource_group

字符串

将创建 Cloud Volumes ONTAP 的资源组。

如果未提供,Cloud Manager 将生成资源组名称(工作环境/CVO 的名称,后缀为 ‘-rg’)。

如果资源组不存在,则会创建它。

sa_client_id

字符串

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

sa_secret_key

字符串

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

security_group_id

字符串

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

serial_number

字符串

集群的序列号。

使用 ‘azure-cot-premium-byol’ 或 ‘azure-ha-cot-premium-byol’ 中的一种时需要。

state

字符串

指定的 AZURE Cloud Manager CVO 是否应该存在。

选项

  • "present" ← (默认)

  • "absent"

storage_type

字符串

第一个数据聚合的存储类型。

选项

  • "Premium_LRS" ← (默认)

  • "Standard_LRS"

  • "StandardSSD_LRS"

  • "Premium_ZRS"

subnet_id

字符串 / 必需

Cloud Volumes ONTAP 系统的子网名称。

subscription_id

字符串 / 必需

Azure 订阅的 ID。

svm_name

字符串

在 netapp.cloudmanager 21.22.0 中添加

SVM 的名称。

svm_password

字符串 / 必需

Cloud Volumes ONTAP 的管理员密码。

每次运行时都会更新。

tier_level

字符串

如果 capacity_tier 为 Blob,则此参数指示分层级别。

选项

  • "normal" ← (默认)

  • "cool"

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

vnet_id

字符串 / 必需

虚拟网络的名称。

vnet_resource_group

字符串

与虚拟网络关联的 Azure 资源组。

workspace_id

字符串

要在其中部署 Cloud Volumes ONTAP 的 Cloud Manager 工作区的 ID。

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

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

writing_speed_state

字符串

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

此参数与 HA 对无关。

注释

注意

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

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

示例

- name: create NetApp Cloud Manager CVO for Azure single
  netapp.cloudmanager.na_cloudmanager_cvo_azure:
    state: present
    refresh_token: "{{ xxxxxxxxxxxxxxx }}"
    name: AnsibleCVO
    location: westus
    subnet_id: subnet-xxxxxxx
    vnet_id: vnetxxxxxxxx
    svm_password: P@assword!
    client_id: "{{ xxxxxxxxxxxxxxx }}"
    writing_speed_state: NORMAL
    azure_tag: [
        {tag_key: abc,
        tag_value: a123}]

- name: create NetApp Cloud Manager CVO for Azure HA
  netapp.cloudmanager.na_cloudmanager_cvo_azure:
    state: present
    refresh_token: "{{ xxxxxxxxxxxxxxx }}"
    name: AnsibleCVO
    location: westus
    subnet_id: subnet-xxxxxxx
    vnet_id: vnetxxxxxxxx
    svm_password: P@assword!
    client_id: "{{ xxxxxxxxxxxxxxx }}"
    writing_speed_state: NORMAL
    azure_tag: [
        {tag_key: abc,
        tag_value: a123}]
    is_ha: true

- name: delete NetApp Cloud Manager cvo for Azure
  netapp.cloudmanager.na_cloudmanager_cvo_azure:
    state: absent
    name: ansible
    refresh_token: "{{ xxxxxxxxxxxxxxx }}"
    location: westus
    subnet_id: subnet-xxxxxxx
    vnet_id: vnetxxxxxxxx
    svm_password: P@assword!
    client_id: "{{ xxxxxxxxxxxxxxx }}"

返回值

常见的返回值已在此处记录 此处,以下是此模块特有的字段

描述

working_environment_id

字符串

新创建的 AZURE CVO working_environment_id。

返回:成功

作者

  • NetApp Ansible 团队 (@carchi8py)