Spec-Zone.ru › Ansible 2.4

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

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

Описание

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

Параметры

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

Примеры

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

# add a host with a non-standard port local to your machines
- add_host:
    name: "{{ new_ip }}:{{ new_port }}"

# 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 }}"

# 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}}"

Примечания

Примечание

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

Статус

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

Информация о техническом обслуживании

Для получения дополнительной информации о поддержке этого модуля компанией Red Hat, обратитесь к этому knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>

Для получения помощи в разработке модулей, если у вас есть такое желание, пожалуйста, прочитайте Информацию о сообществе и участии в разработке, Тестирование Ansible и Разработка модулей.

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

Spec-Zone.ru

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