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