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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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 псевдонимы: rtc строка	Указывает, настроены ли аппаратные часы на UTC или местный часовой пояс. По умолчанию сохраняется текущая настройка. Не рекомендуется изменять этот параметр; его настройка может завершиться с ошибкой, особенно в виртуальных средах, таких как AWS. Требуется указать как минимум один из параметров `name` и `hwclock`. Используется только в Linux. Допустимые значения: `"local"` `"UTC"`
name строка	Название часового пояса для системных часов. По умолчанию сохраняется текущая настройка. Требуется указать как минимум один из параметров `name` и `hwclock`.

Параметр

Комментарии

hwclock

псевдонимы: rtc

строка

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

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

Не рекомендуется изменять этот параметр; его настройка может завершиться с ошибкой, особенно в виртуальных средах, таких как AWS.

Требуется указать как минимум один из параметров name и hwclock.

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

Допустимые значения:

"local"
"UTC"

name

строка

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

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

Требуется указать как минимум один из параметров name и hwclock.

Атрибуты

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

Примечания

Примечание

В Ubuntu 24.04 и Debian 13 (Trixie) для предоставления команды hwclock требуется пакет util-linux-extra.
В 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

- name: Set timezone and hardware clock to UTC
  community.general.timezone:
    name: UTC
    hwclock: UTC

Авторы

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

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

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