Модуль community.general.timezone – Настройка часового пояса

Примечание

Этот модуль входит в коллекцию community.general (версия 9.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в плейбуке, укажите: community.general.timezone.

Описание
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые значения

Описание

Этот модуль настраивает часовой пояс, как системных, так и аппаратных часов. Если вы хотите настроить NTP, используйте модуль ansible.builtin.service.
Рекомендуется перезапустить crond после изменения часового пояса, иначе задачи могут выполняться в неправильное время.
Для различных ОС/дистрибутивов используются разные инструменты. Для Linux может использоваться timedatectl или редактироваться /etc/sysconfig/clock или /etc/timezone и hwclock. В SmartOS, sm-set-timezone, для macOS, systemsetup, для BSD, /etc/localtime изменяется. В AIX используется chtz.
Убедитесь, что файлы zoneinfo установлены с соответствующим пакетом ОС, например, tzdata (обычно всегда установлен, если не используется минимальная установка, например, Alpine Linux).
Windows и HPUX не поддерживаются, сообщите нам, если вы обнаружите другие ОС/дистрибутивы, в которых это не работает.

Параметры

Параметр	Комментарии
hwclock aliases: rtc строка	Указывает, в UTC или в локальном часовом поясе находятся аппаратные часы. По умолчанию сохраняется текущая настройка. Обратите внимание, что эту опцию рекомендуется не менять, и она может не сработать, особенно в виртуальных средах, таких как AWS. Требуется указать хотя бы name или hwclock. Используется только в Linux. Варианты: `"local"` `"UTC"`
name строка	Имя часового пояса для системных часов. По умолчанию сохраняется текущая настройка. Требуется указать хотя бы name или hwclock.

Параметр

Комментарии

hwclock

aliases: rtc

строка

Указывает, в UTC или в локальном часовом поясе находятся аппаратные часы.

По умолчанию сохраняется текущая настройка.

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

Требуется указать хотя бы name или hwclock.

Используется только в Linux.

Варианты:

"local"
"UTC"

name

строка

Имя часового пояса для системных часов.

По умолчанию сохраняется текущая настройка.

Требуется указать хотя бы name или hwclock.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать предсказание изменения статуса без изменения целевого объекта.
diff_mode	Поддержка: полная	Возвращает подробную информацию о том, что изменилось (или, возможно, требует изменения в `check_mode`), когда используется режим diff.

Примечания

Примечание

В Ubuntu 24.04 требуется пакет util-linux-extra для предоставления команды hwclock.
В SmartOS требуется утилита sm-set-timezone (часть пакета smtools) для установки часового пояса.
В AIX можно использовать только часовые пояса базы данных Olson/tz (POSIX не поддерживается). Для вступления в силу новой настройки часового пояса в AIX также требуется перезагрузка ОС. Обратите внимание, что требуется AIX 6.1+ (уровень ОС 61 или выше).

Примеры

- name: Set timezone to Asia/Tokyo
  become: true
  community.general.timezone:
    name: Asia/Tokyo

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Описание
diff сложное	Различия по заданным аргументам. Возвращается: успех
after словарь	Значения после изменения Возвращается: успех
before словарь	Значения до изменения Возвращается: успех

Авторы

Shinichi TAMURA (@tmshn)
Jasper Lievisse Adriaanse (@jasperla)
Indrajit Raychaudhuri (@indrajitr)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/timezone_module.html