ansible.builtin.hostname – Управление именем хоста
Примечание
Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля hostname даже без указания ключевого слова collections:. Несмотря на это, мы рекомендуем использовать FQCN для лёгкой ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.
Новое в версии 1.4: of ansible.builtin
Описание
- Установка имени хоста системы, поддерживает большинство ОС/дистрибутивов, включая те, которые используют systemd.
- Обратите внимание, что этот модуль НЕ изменяет
/etc/hosts. Вам нужно изменить его самостоятельно с помощью других модулей, таких как template или replace. - В настоящее время Windows, HP-UX и AIX не поддерживаются.
Требования
Ниже приведены требования, необходимые на хосте, который выполняет этот модуль.
- hostname
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| name строка / обязательно | Имя хоста | |
| use строка добавлен в 2.9 версии ansible.builtin |
| Стратегия для обновления имени хоста. Если не задано, мы пытаемся определить автоматически, но это может быть проблематично, особенно в контейнерах, так как они могут предоставлять вводящую в заблуждение информацию. |
Примеры
- name: Set a hostname
hostname:
name: web01
Авторы
- Adrian Likins (@alikins)
- Hideki Saito (@saito-hideki)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/builtin/hostname_module.html