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 模式下更改）的详细信息。

注释

注意

  • 有关更多 attributes，请查看 “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)