ansible.builtin.inventory_hostnames – список хостов инвентаря, соответствующих шаблону хоста

Примечание

Этот модуль является частью ansible-base и включён во все инсталляции Ansible. В большинстве случаев вы можете использовать короткое имя модуля inventory_hostnames даже без указания collections: ключевого слова. Несмотря на это, мы рекомендуем использовать FQCN для лёгкой ссылки на документацию по модулю и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.

Новый в версии 1.3: из ansible.builtin

Описание
Примечания
Примеры
Возвращаемые значения

Описание

Этот поиск понимает «шаблоны хостов», как используется hosts: ключевое слово в плейбуках и может возвращать список соответствующих хостов из инвентаря

Примечания

Примечание

это имеет смысл только для «шаблонов имён хостов», в противном случае проще перебирать переменные group/group_names.

Примеры

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

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие — это поля, уникальные для этого поиска:

Ключ	Возвращённое значение	Описание
_hostnames список / элементы=строка	успех	список имён хостов, которые соответствуют шаблону хоста в инвентаре

Авторы

Michael DeHaan
Steven Dossett (!UNKNOWN) <sdossett@panath.com>

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/builtin/inventory_hostnames_lookup.html