Spec-Zone.ru › Ansible 2.6

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

  • Описание
  • Параметры
  • Примечания
  • Примеры
  • Статус
  • Техническое обслуживание
    • Поддержка
    • Автор

Описание

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
groups
Группы, к которым нужно добавить имя хоста, через запятую.

Псевдонимы: groupname, group
name
обязательно
Имя хоста/IP адреса хоста для добавления в инвентарь, может включать двоеточие и номер порта.

Псевдонимы: hostname, host

Примечания

Примечание

  • Этот модуль обходит цикл хостов задач и выполняется только один раз для всех хостов в задаче. Если вам нужно итерировать, используйте директиву with_.
  • Этот модуль поддерживает цели Windows.
  • Псевдоним «host» параметра «name» доступен только начиная с версии >=2.4
  • Начиная с версии Ansible 2.4, переменная inventory_dir теперь установлена в None, а не в «глобальном источнике инвентаризации», потому что теперь у вас может быть несколько источников. Был добавлен пример, показывающий, как частично восстановить предыдущее поведение.

Примеры

- 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)
  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)
  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 2.4 behaviour)
  add_host:
    hostname: charlie
    inventory_dir: "{{inventory_dir}}"

Статус

Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будет внесены несовместимые с предыдущими версиями изменения в интерфейс.

Техническое обслуживание

Этот модуль помечен как core, что означает, что он поддерживается Командой разработчиков Ansible. Подробнее см. Техническое обслуживание и поддержка модулей.

Список других модулей, также поддерживаемых Командой разработчиков Ansible, см. здесь.

Поддержка

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

Автор

  • Команда разработчиков Ansible
  • Seth Vidal

Подсказка

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

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API