ansible.builtin.inventory_hostnames 查找 – 匹配主机模式的主机列表

注意

此查找插件是 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

提示

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