ansible.builtin.file 测试 – 检查路径是否解析为现有文件

注意

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

摘要

  • 检查提供的路径是否映射到控制器文件系统 (localhost) 上的现有文件。

别名：is_file

输入

这描述了测试的输入，即 is ansible.builtin.file 或 is not ansible.builtin.file 之前的 value。

参数

注释

输入

path

路径。

示例

vars:
  my_etc_hosts_is_a_file: "{{ '/etc/hosts' is file }}"
  list_of_files: "{{ list_of_paths | select('file') }}"

返回值

键

描述

返回值

boolean

如果路径对应于控制器上文件系统上的现有文件，则返回 True，否则返回 False。

返回： success

作者

  • Ansible 核心

提示

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