Ansible 核心文档

ansible.builtin.mount_facts 模块 – 获取挂载信息。

注意

此模块是 ansible-core 的一部分，包含在所有 Ansible 安装中。在大多数情况下，即使不指定 collections 关键字，您也可以使用简短的模块名称 mount_facts。但是，我们建议您使用完全限定的集合名称 (FQCN) ansible.builtin.mount_facts，以便轻松链接到模块文档并避免与可能具有相同模块名称的其他集合发生冲突。

ansible-core 2.18 中新增

摘要 

从首选来源检索有关挂载的信息，并根据文件系统类型和设备过滤结果。

参数 

参数	注释
devices 列表 / 元素=字符串	一个 fnmatch 模式列表，用于根据特殊设备或远程文件系统过滤挂载。
fstypes 列表 / 元素=字符串	一个 fnmatch 模式列表，用于根据文件系统的类型过滤挂载。
include_aggregate_mounts 布尔值	模块是否应在 `ansible_facts` 中返回 `aggregate_mounts` 列表。当此值为 `null` 时，如果发现同一挂载点的多个挂载，则会发出警告。选项 `false` `true`
mount_binary 任意	如果 `mount_binary` 包含值“mount”，或者如果 `sources` 包含动态源，并且未找到任何源（如 BSD 或 AIX 主机上预期的那样），则使用 `mount_binary`。设置为 `null` 以在未找到动态文件源后停止。默认值： `"mount"`
on_timeout 字符串	当收集挂载信息超过 `timeout` 时要采取的操作。选项 `"error"` ← (默认) `"warn"` `"ignore"`
sources 列表 / 元素=字符串	用于确定挂载的源列表。跳过缺少的文件源（或空文件）。跳过重复的源，包括符号链接。返回值 `mount_points` 包含为挂载点找到的第一个定义。同一挂载点的其他挂载可从 `aggregate_mounts`（如果已启用）获得。默认情况下，从所有标准位置检索挂载，这些位置具有预定义的别名 `all`/`static`/`dynamic`。 `all` 包含 `dynamic` 和 `static`。 `dynamic` 包含 `/etc/mtab`、`/proc/mounts`、`/etc/mnttab` 以及 `mount_binary` 的值（如果它不为 None）。这允许像 BSD 或 AIX 这样的平台（没有等效于 `/proc/mounts` 的内容）默认情况下收集当前挂载。请参阅 `mount_binary` 选项以禁用回退或配置不同的可执行文件。 `static` 包含 `/etc/fstab`、`/etc/vfstab` 和 `/etc/filesystems`。请注意，`/etc/filesystems` 特定于 AIX。此名称的 Linux 文件具有不同的格式/用途，将被忽略。 `mount_binary` 的值可以配置为源，这将导致它始终执行。根据配置的其他源，这可能效率低下/冗余。例如，如果 `/proc/mounts` 和 `mount` 被列为 `sources`，则 Linux 主机将两次检索相同的挂载。
timeout 浮点数	这是等待每个挂载完成的最大秒数。当此值为 `null` 时，无限期等待。与 `on_timeout` 一起配置以跳过无响应的挂载。此超时也适用于 `mount_binary` 命令以列出挂载。如果模块配置为在 play 的事实收集阶段运行，请使用 module_defaults 设置超时以防止挂起（请参阅示例）。

属性 

属性	支持	描述
check_mode	支持：完全支持	可以在 check_mode 下运行并返回更改状态预测，而无需修改目标，如果不支持，则将跳过操作。
diff_mode	支持：不支持	在 diff 模式下，将返回有关已更改内容（或可能需要在 check_mode 下更改的内容）的详细信息
platform	平台： posix	可以对其进行操作的目标操作系统/系列

示例 

- name: Get non-local devices
  mount_facts:
    devices: "[!/]*"

- name: Get FUSE subtype mounts
  mount_facts:
    fstypes:
      - "fuse.*"

- name: Get NFS mounts during gather_facts with timeout
  hosts: all
  gather_facts: true
  vars:
    ansible_facts_modules:
      - ansible.builtin.mount_facts
  module_default:
    ansible.builtin.mount_facts:
      timeout: 10
      fstypes:
        - nfs
        - nfs4

- name: Get mounts from a non-default location
  mount_facts:
    sources:
      - /usr/etc/fstab

- name: Get mounts from the mount binary
  mount_facts:
    sources:
      - mount
    mount_binary: /sbin/mount

作者

Ansible 核心团队
Sloane Hertel (@s-hertel)

集合链接