Ansible Core 文档

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

注意

此模块是 ansible-core 的一部分，并包含在所有 Ansible 安装中。在大多数情况下，您可以使用短模块名称 mount_facts，即使不指定 collections 关键字。但是，我们建议您使用完全限定集合名称 (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 任意	如果 `sources` 包含值“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` 命令以列出挂载。如果模块配置为在 playbook 的事实收集阶段运行，请使用 module_defaults 设置超时以防止挂起（请参见示例）。

属性 

属性	支持	描述
check_mode	支持：完整	可以在 check_mode 中运行，并返回已更改状态预测，而无需修改目标，如果不支持，则将跳过该操作。
diff_mode	支持：无	在差异模式下运行时，将返回有关已更改（或可能需要在 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 Core 团队
Sloane Hertel (@s-hertel)

集合链接