ansible.builtin.inventory_hostnames lookup – 匹配主机模式的清单主机列表

注意

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

摘要

  • 此查找了解 playbook 中 hosts: 关键字使用的“主机模式”，并且可以从清单中返回匹配主机的列表

注释

注意

  • 这仅适用于“主机名模式”，否则循环遍历 group/group_names 变量更容易。

示例

- name: show all the hosts matching the pattern, i.e. all but the group www
  ansible.builtin.debug:
    msg: "{{ item }}"
  with_inventory_hostnames:
    - all:!www

返回值

键

描述

返回值

列表 / 元素=字符串

与清单中主机模式匹配的主机名列表

返回：成功

作者

  • Michael DeHaan

  • Steven Dossett

提示

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