ansible.builtin.group_by – Создание групп Ansible на основе фактов

Примечание

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

Добавлено в версии 0.9: из ansible.builtin

Описание
Параметры
Примечания
См. также
Примеры

Описание

Используйте факты для создания временных групп, которые можно использовать позднее в книге задач.
Этот модуль также поддерживается для целей Windows.

Примечание

У этого модуля есть соответствующий плагин действий.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
key строка / обязательный		Переменные, значения которых будут использоваться в качестве групп.
parents список / элементы=строка добавлено в версии 2.4 ansible.builtin	По умолчанию: "all"	Список родительских групп.

Примечания

Примечание

Пробелы в именах групп преобразуются в дефисы ‘-‘.
Этот модуль также поддерживается для целей Windows.
Хотя этот модуль не изменяет удалённый хост, мы предоставляем статус «изменён» для удобства отслеживания изменений инвентаризации.

См. также

ansible.builtin.add_host: Официальная документация модуля ansible.builtin.add_host.

Примеры

- name: Create groups based on the machine architecture
  ansible.builtin.group_by:
    key: machine_{{ ansible_machine }}

- name: Create groups like 'virt_kvm_host'
  ansible.builtin.group_by:
    key: virt_{{ ansible_virtualization_type }}_{{ ansible_virtualization_role }}

- name: Create nested groups
  ansible.builtin.group_by:
    key: el{{ ansible_distribution_major_version }}-{{ ansible_architecture }}
    parents:
      - el{{ ansible_distribution_major_version }}

- name: Add all active hosts to a static group
  ansible.builtin.group_by:
    key: done

Авторы

Jeroen Hoekx (@jhoekx)

© 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/group_by_module.html