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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/builtin/inventory_hostnames_lookup.html