ansible.builtin.fileglob lookup – 匹配模式的文件列表

注意

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

摘要

  • 非递归地匹配单个目录中与模式匹配的所有文件。它调用 Python 的“glob”库。

术语

参数

注释

术语

字符串 / 必需

要读取的文件的路径

备注

注意

  • 模式仅支持文件，不支持目录/路径。

  • 请参阅 Ansible 任务路径，以了解文件查找如何与路径一起使用。

  • 匹配针对 Ansible 控制器上的本地系统文件进行。要迭代远程节点上的文件列表，请使用 ansible.builtin.find 模块。

  • 返回由逗号分隔的路径字符串列表，如果没有任何文件匹配则返回空列表。对于“真列表”，请将 wantlist=True 传递给查找。

另请参阅

另请参阅

任务路径

用于相对文件的搜索路径。

示例

- name: Display paths of all .txt files in dir
  ansible.builtin.debug: msg={{ lookup('ansible.builtin.fileglob', '/my/path/*.txt') }}

- name: Copy each file over that matches the given pattern
  ansible.builtin.copy:
    src: "{{ item }}"
    dest: "/etc/fooapp/"
    owner: "root"
    mode: 0600
  with_fileglob:
    - "/playbooks/files/fooapp/*"

返回值

键

描述

返回值

列表 / 元素=路径

文件列表

返回：成功

作者

  • Michael DeHaan

提示

每个条目类型的配置条目具有从低到高的优先级顺序。例如，列表中较低的变量将覆盖较高的变量。