ansible.builtin.hostname – Управление именем хоста

Примечание

Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля hostname даже без указания ключевого слова collections:. Несмотря на это, мы рекомендуем использовать FQCN для лёгкой ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.

Введено в версии 1.4: of ansible.builtin

Описание
Требования
Параметры
Примечания
Примеры

Описание

Установить имя хоста системы. Поддерживает большинство ОС/дистрибутивов, включая те, которые используют systemd.
Windows, HP-UX и AIX в настоящее время не поддерживаются.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

hostname

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
name строка / обязательно		Имя хоста. Если значение представляет собой полное доменное имя, которое не разрешается с данного хоста, это заставит модуль зависнуть на несколько секунд, ожидая, пока попытка разрешения имени не истечёт.
use строка добавлено в 2.9 of ansible.builtin	Варианты: alpine debian freebsd generic macos macosx darwin openbsd openrc redhat sles solaris systemd	Стратегия обновления имени хоста. Если не задано, мы пытаемся определить автоматически, но это может быть проблематично, особенно в контейнерах, так как они могут предоставлять вводящую в заблуждение информацию. Обратите внимание, что для RHEL/EL/CentOS 7+ следует указать 'systemd'. Более старые дистрибутивы должны использовать 'redhat'.

Примечания

Примечание

Этот модуль НЕ изменяет /etc/hosts. Вам необходимо изменить его самостоятельно, используя другие модули, такие как ansible.builtin.template или ansible.builtin.replace.
В macOS этот модуль использует scutil для установки HostName, ComputerName, и LocalHostName. Так как LocalHostName не может содержать пробелы или большинство специальных символов, этот модуль заменит символы при установке LocalHostName.
Поддерживает check_mode.

Примеры

- name: Set a hostname
  ansible.builtin.hostname:
    name: web01

- name: Set a hostname specifying strategy
  ansible.builtin.hostname:
    name: web01
    strategy: systemd

Авторы

Adrian Likins (@alikins)
Hideki Saito (@saito-hideki)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/builtin/hostname_module.html