add_host – Добавление хоста (и альтернативно группы) в инвентарь ansible-playbook в памяти

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

Описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
groups список		Группы, к которым нужно добавить имя хоста. псевдонимы: group, groupname
name строка / обязательно		Имя хоста/IP-адрес хоста для добавления в инвентарь, может содержать двоеточие и номер порта. псевдонимы: host, hostname

Примечания

Примечание

Этот модуль обходит цикл хостов плейбука и выполняется только один раз для всех хостов в задаче; если вам нужно итерировать, используйте конструкцию with-loop.
Псевдоним host параметра name доступен только в Ansible 2.4 и новее.
С Ansible 2.4 переменная inventory_dir теперь задается значением None, а не «глобальным источником инвентаря», так как теперь у вас может быть несколько источников. Приведен пример, показывающий, как частично восстановить предыдущее поведение.
Этот модуль поддерживает целевые объекты Windows.

См. также

group_by – Создание групп Ansible на основе фактов: Официальная документация модуля group_by.

Примеры

- name: Add host to group 'just_created' with variable foo=42
  add_host:
    name: '{{ ip_from_ec2 }}'
    groups: just_created
    foo: 42

- name: Add host to multiple groups
  add_host:
    hostname: '{{ new_ip }}'
    groups:
    - group1
    - group2

- name: Add a host with a non-standard port local to your machines
  add_host:
    name: '{{ new_ip }}:{{ new_port }}'

- name: Add a host alias that we reach through a tunnel (Ansible 1.9 and older)
  add_host:
    hostname: '{{ new_ip }}'
    ansible_ssh_host: '{{ inventory_hostname }}'
    ansible_ssh_port: '{{ new_port }}'

- name: Add a host alias that we reach through a tunnel (Ansible 2.0 and newer)
  add_host:
    hostname: '{{ new_ip }}'
    ansible_host: '{{ inventory_hostname }}'
    ansible_port: '{{ new_port }}'

- name: Ensure inventory vars are set to the same value as the inventory_hostname has (close to pre Ansible 2.4 behaviour)
  add_host:
    hostname: charlie
    inventory_dir: '{{ inventory_dir }}'

Статус

Этот модуль гарантирует обратную совместимость будущих изменений интерфейса. [stableinterface]
Этот модуль поддерживается командой разработчиков Ansible. [core]

Поддержка Red Hat

Дополнительная информация о поддержке этого модуля Red Hat доступна в этой статье базы знаний Red Hat.

Авторы

Команда разработчиков Ansible
Seth Vidal (@skvidal)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/add_host_module.html