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

注意

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

概要

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

别名：is_file

输入

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

参数

注释

输入

path

路径。

示例

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

返回值

键

描述

返回值

boolean

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

返回： 成功

作者

  • Ansible Core

提示

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