ansible.builtin.inventory_hostnames 查找 – 列出与主机模式匹配的清单主机

注意

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

概要

  • 此查找理解剧本中 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

返回值

键

描述

返回值

list / elements=string

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

返回: 成功

作者

  • Michael DeHaan

  • Steven Dossett

提示

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