community.general.aix_filesystem 模块 – 配置 AIX 的 LVM 和 NFS 文件系统

注意

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

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

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

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

概要 

此模块使用 /etc/filesystems 为 AIX 创建、删除、挂载和卸载 LVM 和 NFS 文件系统。
对于 LVM 文件系统，可以调整文件系统的大小。

参数 

参数	注释
account_subsystem 布尔值	指定是否由记帐子系统处理文件系统。选项 `false` ← (默认) `true`
attributes 列表 / 元素=字符串	指定文件系统的属性，用逗号分隔。默认值： `["agblksize=4096", "isnapshot=no"]`
auto_mount 布尔值	文件系统在系统重启时自动挂载。选项 `false` `true` ← (默认)
device 字符串	逻辑卷 (LV) 设备名称或远程导出设备，用于创建 NFS 文件系统。它用于在已存在的逻辑卷或导出的 NFS 文件系统上创建文件系统。如果未提及，将按照 AIX 标准（LVM）创建一个新的逻辑卷名称。
filesystem 字符串 / 必需	指定挂载点，即文件系统将要挂载的目录。
fs_type 字符串	指定虚拟文件系统类型。默认值： `"jfs2"`
mount_group 字符串	指定挂载组。
nfs_server 字符串	指定网络文件系统 (NFS) 服务器。
permissions 字符串	设置文件系统权限。`rw` (读写) 或 `ro` (只读)。选项 `"ro"` `"rw"` ← (默认)
rm_mount_point 布尔值	当与状态 `absent` 一起使用时，删除挂载点目录。选项 `false` ← (默认) `true`
size 字符串	指定文件系统大小。对于已经 `present` 的文件系统，将调整其大小。 512 字节块、兆字节或千兆字节。如果值指定了 M，则单位为兆字节。如果值指定了 G，则单位为千兆字节。如果没有 M 或 G，则该值将为 512 字节块。如果值的开头指定了“+”，则该值将被添加到现有大小。如果值的开头指定了“-”，则该值将从现有大小中移除。如果未指定“+”或“-”，则总值将为指定的值。大小将遵循 LVM AIX 标准。
state 字符串	控制文件系统状态。 `present` 检查文件系统是否存在，创建或调整大小。 `absent` 如果已 `unmounted`，则删除现有文件系统。 `mounted` 检查文件系统是否已挂载或挂载文件系统。 `unmounted` 检查文件系统是否已卸载或卸载文件系统。选项 `"absent"` `"mounted"` `"present"` ← (默认) `"unmounted"`
vg 字符串	指定一个现有的卷组 (VG)。

属性 

属性	支持	描述
check_mode	支持: 完全	可以在 `check_mode` 中运行，并返回更改状态预测，而无需修改目标。
diff_mode	支持: 无	当处于 diff 模式时，将返回有关已更改的内容（或可能需要在 `check_mode` 中更改的内容）的详细信息。

备注 

注意

有关更多 属性，请查看 “crfs” AIX 手册。

示例 

- name: Create filesystem in a previously defined logical volume.
  community.general.aix_filesystem:
    device: testlv
    filesystem: /testfs
    state: present

- name: Creating NFS filesystem from nfshost.
  community.general.aix_filesystem:
    device: /home/ftp
    nfs_server: nfshost
    filesystem: /home/ftp
    state: present

- name: Creating a new file system without a previously logical volume.
  community.general.aix_filesystem:
    filesystem: /newfs
    size: 1G
    state: present
    vg: datavg

- name: Unmounting /testfs.
  community.general.aix_filesystem:
    filesystem: /testfs
    state: unmounted

- name: Resizing /mksysb to +512M.
  community.general.aix_filesystem:
    filesystem: /mksysb
    size: +512M
    state: present

- name: Resizing /mksysb to 11G.
  community.general.aix_filesystem:
    filesystem: /mksysb
    size: 11G
    state: present

- name: Resizing /mksysb to -2G.
  community.general.aix_filesystem:
    filesystem: /mksysb
    size: -2G
    state: present

- name: Remove NFS filesystem /home/ftp.
  community.general.aix_filesystem:
    filesystem: /home/ftp
    rm_mount_point: true
    state: absent

- name: Remove /newfs.
  community.general.aix_filesystem:
    filesystem: /newfs
    rm_mount_point: true
    state: absent

返回值 

通用返回值已在此处文档化，以下是此模块独有的字段

键	描述
changed 布尔值	对于 aix_filesystems 操作，返回 changed 为 true 或 false。返回: 总是
msg 字符串	返回有关操作的消息。返回: 总是

作者

Kairo Araujo (@kairoaraujo)