purestorage.flasharray.purefa_pod 模块 – 管理 Pure Storage FlashArrays 中的 AC pod

注意

此模块是 purestorage.flasharray 集合（版本 1.32.0）的一部分。

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

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

要在 playbook 中使用它，请指定：purestorage.flasharray.purefa_pod。

purestorage.flasharray 1.0.0 中的新增功能

概要

  • 管理 Pure Storage FlashArray 中的 AC pod。

要求

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

  • python >= 3.3

  • purestorage >= 1.19

  • py-pure-client >= 1.26.0

  • netaddr

  • requests

  • pycountry

  • urllib3

参数

参数

注释

api_token

字符串

具有管理员权限的用户的 FlashArray API 令牌。

delete_contents

布尔值

在 purestorage.flasharray 1.29.0 中添加

这使您可以清除包含内容的 pod。

选择

  • false ← (默认)

  • true

disable_warnings

布尔值

在 purestorage.flasharray 1.29.0 中添加

在调试日志中禁用不安全的证书警告

选择

  • false ← (默认)

  • true

eradicate

布尔值

定义是否在删除时清除 pod 或将其留在回收站中。

选择

  • false ← (默认)

  • true

fa_url

字符串

FlashArray 管理 IPv4 地址或主机名。

failover

列表 / 元素=字符串

如果阵列彼此失去联系，则优先保持在线的阵列名称。

选项是集群中的阵列或 *auto*

ignore_usage

布尔值

在 purestorage.flasharray 1.18.0 中添加

用于覆盖配额管理操作检查的标志。

如果设置为 true，则不会根据设置的 quota_limits 检查 pod 使用情况。

如果设置为 false，则会阻止使用的实际逻辑字节超过 pod 上设置的限制。

客户端操作可能会受到影响。

如果限制超过配额，则不允许该操作。

选择

  • false ← (默认)

  • true

mediator

字符串

用于 pod 的调解器名称

默认值： "purestorage"

name

字符串 / 必需

pod 的名称。

promote

布尔值

提升/降级任何未处于扩展关系的 pod。

降级 pod 会使其变为只读。

选择

  • false

  • true

quiesce

布尔值

当 *promote* 为 false 且降级 ActiveDR pod 时，静默/跳过静默。

静默将确保在降级之前已复制所有本地数据。

跳过静默会丢失所有待复制到远程 pod 的数据。

仅当 pod 处于 Acrive DR 副本链接关系时才能降级 pod。

这将默认为 True

选择

  • false

  • true

quota

字符串

在 purestorage.flasharray 1.18.0 中添加

pod 的逻辑配额限制，以 K、M、G、T 或 P 单位或字节为单位。

state

字符串

定义 pod 是否应该存在。

选择

  • "absent"

  • "present" ← (默认)

stretch

字符串

要扩展到/取消扩展的阵列名称。必须同步复制。

要取消扩展阵列，请使用 state *absent*

您只能指定远程阵列，即您不能从当前阵列取消扩展 pod，然后再重新扩展回当前阵列。

要重新扩展 pod，您必须从 pod 所在的剩余阵列执行此操作。

target

字符串

克隆目标 pod 的名称。

throttle

布尔值

在 purestorage.flasharray 1.29.0 中添加

如果阵列运行状况不佳，则允许 pod 创建失败

选择

  • false ← (默认)

  • true

undo

布尔值

当 *promote* 为 true 且提升 ActiveDR pod 时，使用 *undo-remote* pod。

这将默认为 True

选择

  • false

  • true

说明

注意

  • 此模块需要 purestorage 和 py-pure-client Python 库

  • 特定模块可能需要其他 Python 库。

  • 如果未将 *fa_url* 和 *api_token* 参数直接传递给模块，则必须设置 PUREFA_URL 和 PUREFA_API 环境变量

示例

- name: Create new pod named foo
  purestorage.flasharray.purefa_pod:
    name: foo
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: present

- name: Delete and eradicate pod named foo
  purestorage.flasharray.purefa_pod:
    name: foo
    eradicate: true
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: absent

- name: Set failover array for pod named foo
  purestorage.flasharray.purefa_pod:
    name: foo
    failover:
    - array1
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Set mediator for pod named foo
  purestorage.flasharray.purefa_pod:
    name: foo
    mediator: bar
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Stretch a pod named foo to array2
  purestorage.flasharray.purefa_pod:
    name: foo
    stretch: array2
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Unstretch a pod named foo from array2
  purestorage.flasharray.purefa_pod:
    name: foo
    stretch: array2
    state: absent
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Create clone of pod foo named bar
  purestorage.flasharray.purefa_pod:
    name: foo
    target: bar
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: present

作者

  • Pure Storage Ansible 团队 (@sdodsley)