dellemc.powerflex.resource_group 模块 – 在 Dell PowerFlex 上管理资源组部署。

注意

此模块是 dellemc.powerflex 集合 (版本 2.5.0) 的一部分。

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

要安装它，请使用： ansible-galaxy collection install dellemc.powerflex。您需要其他要求才能使用此模块，有关详细信息，请参阅要求。

要在 playbook 中使用它，请指定： dellemc.powerflex.resource_group。

dellemc.powerflex 2.3.0 中的新增功能

概要 

在 PowerFlex 存储系统上管理资源组部署包括部署、编辑、添加节点和删除资源组部署。

要求 

执行此模块的主机需要以下要求。

Dell PowerFlex 存储系统版本 3.6 或更高版本。
PyPowerFlex 1.12.0。

参数 

参数	注释
clone_node 字符串	如果资源组中有多个节点可用，则在扩展时要复制的资源。
description 字符串	资源组的描述。
firmware_repository_id 字符串	如果未使用设备默认目录，则为固件存储库的 ID。与 firmware_repository_name 互斥。
firmware_repository_name 字符串	如果未使用设备默认目录，则为固件存储库的名称。与 firmware_repository_id 互斥。
hostname 别名：gateway_host 字符串 / 必需	PowerFlex 主机的 IP 或 FQDN。
new_resource_group_name 字符串	要重命名到的资源组的新名称。
node_count 整数	扩展时要克隆的节点数。默认值： `1`
password 字符串 / 必需	PowerFlex 主机的密码。
port 整数	与 PowerFlex 主机通信的端口号。默认值： `443`
resource_group_id 字符串	资源组的 ID。必须指定 resource_group_id 或 resource_group_name 才能执行资源组操作。与 resource_group_name 互斥。
resource_group_name 字符串	资源组的名称。这是部署资源组的必填字段。必须指定 resource_group_id 或 resource_group_name 才能执行资源组操作。与 resource_group_id 互斥。
scaleup 布尔值	是否要扩展资源组。指定为 true 以向资源组添加节点。选项 `false` ← (默认) `true`
schedule_date 字符串	资源组部署的计划日期。以 YYYY-MM-DD HH:MM:SS.sss 或 YYYY-MM-DD 格式指定。
state 字符串	资源组的状态。选项 `"absent"` `"present"` ← (默认)
template_id 字符串	已发布模板的 ID。必须指定 template_id 或 template_name 才能部署资源组。与 template_name 互斥。
template_name 字符串	已发布模板的名称。必须指定 template_id 或 template_name 才能部署资源组。与 template_id 互斥。
timeout 整数	连接将终止后的时间。以秒为单位。默认值： `120`
username 字符串 / 必需	PowerFlex 主机的用户名。
validate 布尔值	指定为 true 以验证资源组的部署。选项 `false` ← (默认) `true`
validate_certs 别名：verifycert 布尔值	布尔变量，用于指定是否验证 SSL 证书。 `true` - 表示应验证 SSL 证书。 `false` - 表示不应验证 SSL 证书。选项 `false` `true` ← (默认)

注释 

注意

支持 *check_mode*。
只有在部署完成后才能扩展资源组。
名为“dellemc.powerflex”的集合中存在的模块旨在支持 Dell PowerFlex 存储平台。

示例 

- name: Validate deployment of a resource group
  dellemc.powerflex.resource_group:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    port: "{{ port }}"
    resource_group_name: "{{ resource_group_name_1 }}"
    description: ans_rg
    template_id: c65d0172-8666-48ab-935e-9a0bf69ed66d
    firmware_repository_id: 8aaa80788b5755d1018b576126d51ba3
    validate: true

- name: Deploy a resource group
  dellemc.powerflex.resource_group:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    port: "{{ port }}"
    resource_group_name: "{{ resource_group_name_1 }}"
    description: ans_rg
    template_id: c65d0172-8666-48ab-935e-9a0bf69ed66d
    firmware_repository_id: 8aaa80788b5755d1018b576126d51ba3

- name: Add a node to a resource group
  dellemc.powerflex.resource_group:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    resource_group_name: "{{ resource_group_name_1 }}"
    scaleup: true
    clone_node: "{{ node_1 }}"
    node_count: "{{ node_count }}"

- name: Modify a resource group
  dellemc.powerflex.resource_group:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    resource_group_name: "{{ resource_group_name_1 }}"
    new_resource_group_name: "{{ new_resource_group_name }}"
    description: "description new"

- name: Delete a resource group
  dellemc.powerflex.resource_group:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    port: "{{ port }}"
    resource_group_name: ans_rg
    state: "absent"

返回值 

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

键	描述
changed 布尔值	资源是否已更改。返回：始终示例： `false`
resource_group_details 字典	资源组部署的详细信息。返回：当资源组存在时。示例： {"allUsersAllowed": false, "brownfield": false, "compliant": true, "configurationChange": false, "deploymentDescription": "ans test rg", "deploymentDevice": [{"brownfield": false, "compliantState": "COMPLIANT", "componentId": "910bf934-d45a-4fe3-8ea2-dc481e063a81", "currentIpAddress": "1.3.9.2", "deviceHealth": "GREEN", "deviceType": "scaleio", "model": "PowerFlex Gateway", "refId": "scaleio-block-legacy-gateway", "refType": "SCALEIO", "statusMessage": "The processing of PowerFlex is unsuccessful."}], "deploymentHealthStatusType": "red", "deploymentName": "dep-ans-test-rg1", "firmwareRepository": {"id": "8aaa80788b5755d1018b576126d51ba3", "name": "PowerFlex 4.5.0.0", "rcmapproved": false}, "firmwareRepositoryId": "8aaa80788b5755d1018b576126d51ba3", "id": "8aaa03a88de961fa018de96a88d80008", "lifecycleMode": false, "numberOfDeployments": 0, "owner": "admin", "retry": true, "scaleUp": false, "scheduleDate": null, "serviceTemplate": {"id": "8aaa03a88de961fa018de96a88d80008", "templateName": "update-template (8aaa03a88de961fa018de96a88d80008)"}, "status": "error", "teardown": false, "templateValid": true, "updateServerFirmware": true, "useDefaultCatalog": true, "vds": false}
deploymentDescription 字符串	资源组部署的描述。返回：成功
deploymentName 字符串	资源组部署的名称。返回：成功
firmwareRepositoryId 字符串	资源组的固件库ID。返回：成功
id 字符串	已部署资源组的ID。返回：成功
serviceTemplate 字典	资源组的服务模板。返回：成功
id 字符串	服务模板的ID。返回：成功
templateName 字符串	服务模板的名称。返回：成功
status 字符串	资源组部署的状态。返回：成功

作者

Jennifer John (@johnj9)
Trisha Datta (@trisha-dell)