hostname

Модуль ansible.builtin.hostname изменяет название (hostname) управляемого узла.

Особенности работы

Особенности использования модуля ansible.builtin.hostname:

• На управляемом узле должна быть установлена утилита hostname.

• Модуль поддерживает большинство ОС и дистрибутивов, включая те, что используют systemd.

• Windows, HP-UX и AIX не поддерживаются этим модулем.

• Модуль не изменяет содержимое файла /etc/hosts. Для редактирования этого файла используйте отдельные модули, например, ansible.builtin.template или ansible.builtin.replace.

• На macOS модуль использует утилиту scutil для управления системными параметрами, отвечающими за название узла: HostName, ComputerName и LocalHostName.

  Примечание

  Поскольку системный параметр LocalHostName не может содержать пробелы и большинство специальных символов, модуль будет автоматически заменять недопустимые символы при установке названия узла.

Параметры

Модуль поддерживает следующие параметры:

name

Обязательный параметр.

Название, которое будет присвоено узлу.

Если указан FQDN, которое не разрешается на указанном узле, возможна задержка из-за таймаута попытки разрешения.

use

Стратегия обновления названия узла.

Если параметр не задан, стратегия смены названия определяется автоматически, однако это может привести к ошибкам, особенно в контейнерах, где информация о системе может быть некорректной.

Примечание

Для работы с RHEL, EL, CentOS 7+ используйте стратегию systemd. В более старых дистрибутивах используйте redhat.

Возможные значения:

• alpine;

• debian;

• freebsd;

• generic;

• macos;

• macosx;

• darwin;

• openbsd;

• openrc;

• redhat;

• sles;

• solaris;

• systemd.

Атрибуты

Атрибуты определяют функции Ansible, которые может использовать модуль.

Атрибут	Описание
check_mode	Модуль работает в режиме проверки (check_mode) в полном объеме.
diff_mode	Модуль поддерживает режим сравнения (diff_mode) в полном объеме.
facts	При успешном выполнении возвращает обновленный словарь ansible_facts с новым названием узла.
platform	Модуль поддерживает только POSIX-совместимые ОС.

Примеры

Для изучения возможностей модуля ознакомьтесь с приведенными ниже примерами.

Установка названия узла

Следующий пример демонстрирует установку названия узла без указания стратегии:

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

Установка названия узла с указанием стратегии

Следующий пример демонстрирует установку названия узла с использованием стратегии systemd:

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