community.general.zfs 模块 – 管理 ZFS

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

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

要安装它，请使用： ansible-galaxy collection install community.general。

要在 playbook 中使用它，请指定： community.general.zfs。

概要

  • 管理 ZFS 文件系统、卷、克隆和快照

参数

参数

注释

extra_zfs_properties

字典

要设置的 zfs 属性字典。

有关更多信息，请参阅 zfs(8) 手册页。

默认值： {}

name

字符串 / 必需

文件系统、快照或卷名称，例如 rpool/myfs。

origin

字符串

从中创建克隆的快照。

state

字符串 / 必需

是创建 (present) 还是删除 (absent) 文件系统、快照或卷。所有父项/子项都将根据需要创建/销毁以达到所需状态。

选项

  • "absent"

  • "present"

属性

属性

支持

描述

check_mode

支持：部分

在某些情况下，它可能会将任务报告为已更改，而当禁用 check_mode 时，不会将其报告为已更改。

例如，当设置 zpool altroot 选项或使用人类可读的表示法（例如 1M 或 1024K）而不是无限定的字节计数（例如 1048576）写入大小时，可能会发生这种情况。

可以在 check_mode 下运行并返回已更改状态预测，而无需修改目标。

diff_mode

支持：完全

处于差异模式时，将返回有关已更改内容（或可能需要在 check_mode 中更改的内容）的详细信息。

示例

- name: Create a new file system called myfs in pool rpool with the setuid property turned off
  community.general.zfs:
    name: rpool/myfs
    state: present
    extra_zfs_properties:
      setuid: 'off'

- name: Create a new volume called myvol in pool rpool.
  community.general.zfs:
    name: rpool/myvol
    state: present
    extra_zfs_properties:
      volsize: 10M

- name: Create a snapshot of rpool/myfs file system.
  community.general.zfs:
    name: rpool/myfs@mysnapshot
    state: present

- name: Create a new file system called myfs2 with snapdir enabled
  community.general.zfs:
    name: rpool/myfs2
    state: present
    extra_zfs_properties:
      snapdir: enabled

- name: Create a new file system by cloning a snapshot
  community.general.zfs:
    name: rpool/cloned_fs
    state: present
    origin: rpool/myfs@mysnapshot

- name: Destroy a filesystem
  community.general.zfs:
    name: rpool/myfs
    state: absent

作者

  • Johan Wiren (@johanwiren)