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

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

Описание

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

Параметры

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

Примечания

Примечание

Этот модуль обходит цикл хостов в задаче и выполняется только один раз для всех хостов в задаче. Если требуется итерация, используйте конструкцию с циклом.
Псевдоним 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.8/modules/add_host_module.html