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]
- Этот модуль поддерживается основной командой Ansible. [core]
Поддержка Red Hat
Дополнительная информация о поддержке этого модуля Red Hat доступна в этой статье базы знаний 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.7/modules/add_host_module.html