Ansible 核心文档

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

注意

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

在 ansible-core 2.18 中新增

概要 

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

参数 

参数	注释
devices list / elements=string	一个 fnmatch 模式列表，用于根据特殊设备或远程文件系统过滤挂载。
fstypes list / elements=string	一个 fnmatch 模式列表，用于根据文件系统类型过滤挂载。
include_aggregate_mounts boolean	模块是否应该在 `ansible_facts` 中返回 `aggregate_mounts` 列表。当此值为 `null` 时，如果发现同一个挂载点的多个挂载，将发出警告。选择 `false` `true`
mount_binary any	如果 `sources` 包含值“mount”，或者如果 `sources` 包含动态源并且没有找到任何动态源（如预期的那样在 BSD 或 AIX 主机上），则使用 `mount_binary`。设置为 `null`，以便在没有找到动态文件源后停止。默认值： `"mount"`
on_timeout string	收集挂载信息超过 `timeout` 时要采取的操作。选择 `"error"` ← (默认值) `"warn"` `"ignore"`
sources list / elements=string	用于确定挂载的源列表。缺少的文件源（或空文件）将被跳过。重复的源，包括符号链接，将被跳过。返回值 `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 float	这是等待每个挂载完成的最大秒数。当此值为 `null` 时，无限期等待。与 `on_timeout` 结合配置，以跳过无响应的挂载。此超时也适用于列出挂载的 `mount_binary` 命令。如果模块配置为在剧本的收集事实阶段运行，请使用 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 核心团队
Sloane Hertel (@s-hertel)

集合链接