netapp.cloudmanager.na_cloudmanager_cvo_azure 模块 – 用于 Azure 的 NetApp Cloud Manager CVO/工作环境,支持单机或 HA 模式。

注意

此模块是 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/工作环境,支持单机或 HA 模式。

参数

参数

注释

allow_deploy_in_existing_rg

布尔值

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

选项

  • false ←(默认)

  • true

availability_zone

整数

在 netapp.cloudmanager 21.20.0 中添加

位置配置中的可用区。

availability_zone_node1

整数

在 netapp.cloudmanager 21.21.0 中添加

用于 HA 的位置配置中的 node1 可用区。

availability_zone_node2

整数

在 netapp.cloudmanager 21.21.0 中添加

用于 HA 的位置配置中的 node2 可用区。

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

布尔值

在工作环境中启用 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)