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 的数据。

只有在 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)