purestorage.flashblade.purefb_snap 模块 – 管理 Pure Storage FlashBlade 上的文件系统快照

注意

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

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

要安装它,请使用:ansible-galaxy collection install purestorage.flashblade。 您需要进一步的要求才能使用此模块,请参阅 要求 了解详细信息。

要在 playbook 中使用它,请指定:purestorage.flashblade.purefb_snap

purestorage.flashblade 1.0.0 中的新增功能

概要

  • 在 Pure Storage FlashBlade 上创建或删除卷和文件系统快照。

  • 仅支持使用最新快照从快照恢复文件系统。

要求

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

  • python >= 3.9

  • py-pure-client

  • purity_fb >= 1.12.2

  • netaddr

  • datetime

  • pytz

  • distro

  • pycountry

  • urllib3

参数

参数

注释

api_token

字符串

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

disable_warnings

布尔值

在 purestorage.flashblade 1.18.0 中添加

禁用不安全的证书警告

选项

  • false ←(默认)

  • true

eradicate

布尔值

定义在删除时是清除快照还是保留在回收站中。

选项

  • false ←(默认)

  • true

fb_url

字符串

FlashBlade 管理 IP 地址或主机名。

name

字符串 / 必需

源文件系统的名称。

now

布尔值

在 purestorage.flashblade 1.7.0 中添加

是否立即启动快照复制

选项

  • false ←(默认)

  • true

state

字符串

定义文件系统快照应该存在还是不存在。

选项

  • "absent"

  • "present" ←(默认)

  • "restore"

suffix

字符串

快照名称的后缀。

target

别名: targets

字符串

在 purestorage.flashblade 1.7.0 中添加

将快照复制到的目标名称。

仅当 nowtrue 时适用

注意

注意

  • 此模块需要 purity_fb Python 库

  • 如果未直接将 fb_urlapi_token 参数传递给模块,则必须设置 PUREFB_URLPUREFB_API 环境变量

示例

- name: Create snapshot foo.ansible
  purestorage.flashblade.purefb_snap:
    name: foo
    suffix: ansible
    fb_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: present

- name: Create immeadiate snapshot foo.ansible to connected FB bar
  purestorage.flashblade.purefb_snap:
    name: foo
    suffix: ansible
    now: true
    target: bar
    fb_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: present

- name: Delete snapshot named foo.snap
  purestorage.flashblade.purefb_snap:
    name: foo
    suffix: snap
    fb_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: absent

- name: Recover deleted snapshot foo.ansible
  purestorage.flashblade.purefb_snap:
    name: foo
    suffix: ansible
    fb_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: present

- name: Restore filesystem foo (uses latest snapshot)
  purestorage.flashblade.purefb_snap:
    name: foo
    fb_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: restore

- name: Eradicate snapshot named foo.snap
  purestorage.flashblade.purefb_snap:
    name: foo
    suffix: snap
    eradicate: true
    fb_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: absent

作者

  • Pure Storage Ansible 团队 (@sdodsley)