purestorage.flasharray.purefa_offload 模块 – 创建、修改和删除 NFS、S3 或 Azure 卸载目标

注意

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

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

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

要在剧本中使用它，请指定：purestorage.flasharray.purefa_offload。

purestorage.flasharray 1.0.0 中的新增功能

概要

  • 创建、修改和删除 NFS、S3 或 Azure 卸载目标。

  • 仅在 Purity v5.2.0 或更高版本上受支持。

  • 您必须拥有已正确配置的卸载网络才能使卸载工作。

需求

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

  • python >= 3.3

  • purestorage >= 1.19

  • py-pure-client >= 1.26.0

  • netaddr

  • requests

  • pycountry

  • urllib3

参数

参数

注释

access_key

字符串

卸载目标的访问密钥 ID

account

字符串

Azure Blob 存储帐户的名称

address

字符串

NFS 服务器的 IP 地址或 FQDN 地址

api_token

字符串

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

auth_region

字符串

在 purestorage.flasharray 1.32.0 中添加

将用于初始身份验证请求的区域。

此参数是可选的，仅当区域自动检测失败时才应使用。

bucket

字符串

S3 或 GCP 目标的存储桶名称

container

字符串

Azure 目标的 Blob 容器名称

默认值： "offload"

disable_warnings

布尔值

在 purestorage.flasharray 1.29.0 中添加

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

选项

  • false ← (默认)

  • true

fa_url

字符串

FlashArray 管理 IPv4 地址或主机名。

initialize

布尔值

定义是否初始化卸载存储桶

选项

  • false

  • true ← (默认)

name

字符串 / 必需

卸载目标的名称

options

字符串

NFS 共享的附加挂载选项

支持的挂载选项包括 *port*、*rsize*、*wsize*、*nfsvers* 以及 *tcp* 或 *udp*

默认值： ""

placement

字符串

AWS S3 位置策略

选项

  • "retention-based" ← (默认)

  • "aws-standard-class"

  • "aws-intelligent-tiering"

profile

字符串

在 purestorage.flasharray 1.21.0 中添加

将为此目标选择的卸载目标配置文件。

此选项允许在协议参数之上对目标进行更细粒度的配置

选项

  • "azure"

  • "gcp"

  • "nfs"

  • "nfs-flashblade"

  • "s3-aws"

  • "s3-flashblade"

  • "s3-scality-ring"

  • "s3-wasabi-pay-as-you-go"

  • "s3-wasabi-rcs"

  • "s3-other"

protocol

字符串

定义卸载引擎使用的协议

Purity/FA 6.6.0 及更高版本不支持 NFS 协议

选项

  • "nfs" ← (默认)

  • "s3"

  • "azure"

  • "gcp"

secret

字符串

卸载目标的密钥访问密钥

share

字符串

NFS 服务器上的 NFS 导出

state

字符串

定义卸载状态

选项

  • "absent"

  • "present" ← (默认)

uri

字符串

在 purestorage.flasharray 1.32.0 中添加

用于在阵列和非 AWS S3 卸载目标之间建立连接的 URI。

非 AWS S3 卸载目标不支持存储位置策略。

允许 HTTP 和 HTTPS 协议。

备注

注意

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

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

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

示例

- name: Create NFS offload target
  purestorage.flasharray.purefa_offload:
    name: nfs-offload
    protocol: nfs
    address: 10.21.200.4
    share: "/offload_target"
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Create S3 offload target
  purestorage.flasharray.purefa_offload:
    name: s3-offload
    protocol: s3
    access_key: "3794fb12c6204e19195f"
    bucket: offload-bucket
    secret: "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
    placement: aws-standard-class
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Create Azure offload target
  purestorage.flasharray.purefa_offload:
    name: azure-offload
    protocol: azure
    secret: "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
    container: offload-container
    account: user1
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Delete offload target
  purestorage.flasharray.purefa_offload:
    name: nfs-offload
    protocol: nfs
    state: absent
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

作者

  • Pure Storage Ansible 团队 (@sdodsley)