timezone – Настройка часового пояса
Новая версия 2.2.
Обзор
- Этот модуль настраивает часовой пояс, как системных часов, так и аппаратных. Для настройки NTP используйте модуль service.
- Рекомендуется перезапустить
crondпосле изменения часового пояса, иначе задачи могут выполняться в неверное время. - В зависимости от операционной системы/дистрибутива используются разные инструменты. Для Linux может использоваться
timedatectlили редактирование/etc/sysconfig/clockили/etc/timezoneиhwclock. На SmartOS используетсяsm-set-timezone, для macOS -systemsetup, а для BSD -/etc/localtime. - Поддержка SmartOS и BSD добавлена в Ansible 2.3.
- Поддержка macOS добавлена в Ansible 2.4.
- Windows, AIX и HPUX не поддерживаются. Пожалуйста, сообщите нам, если вы обнаружите другие операционные системы/дистрибутивы, в которых модуль не работает.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| hwclock строка |
| Устанавливает часовой пояс для аппаратных часов (UTC или локальный). По умолчанию сохраняется текущее значение. Обратите внимание, что изменение этого параметра не рекомендуется, особенно в виртуальных средах (например, AWS), и может привести к ошибкам конфигурации. Необходимо указать хотя бы один из параметров: name или hwclock. Используется только на Linux. алиасы: rtc |
| name строка | Имя часового пояса для системных часов. По умолчанию сохраняется текущее значение. Необходимо указать хотя бы один из параметров: name или hwclock. |
Примечания
Примечание
- На SmartOS для установки часового пояса необходимо использовать утилиту
sm-set-timezone, которая входит в пакет smtools.
Примеры
- name: Set timezone to Asia/Tokyo
timezone:
name: Asia/Tokyo
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| diff сложный тип | успех | Различия по заданным аргументам. | |
| after словарь | Значения после изменения. | ||
| before словарь | Значения до изменения. | ||
Статус
- Не гарантируется обратная совместимость модуля. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Shinichi TAMURA (@tmshn)
- Jasper Lievisse Adriaanse (@jasperla)
- Indrajit Raychaudhuri (@indrajitr)
Подсказка
Если вы обнаружили какие-либо проблемы в этом документе, вы можете отредактировать его, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/timezone_module.html
