timezone – Настройка часового пояса
Новая версия 2.2.
Обзор
- Этот модуль настраивает часовой пояс, как системных часов, так и аппаратных часов. Если вы хотите настроить NTP, используйте модуль service.
- Рекомендуется перезапустить
crondпосле изменения часового пояса, в противном случае задачи могут выполняться не в то время. - В зависимости от используемой ОС/дистрибутива используются различные инструменты. Для Linux можно использовать
timedatectlили изменить/etc/sysconfig/clockили/etc/timezoneиhwclock. На SmartOS,sm-set-timezone, для macOS,systemsetup, для BSD,/etc/localtime. - Начиная с версии 2.3 добавлена поддержка SmartOS и BSD.
- Начиная с версии 2.4 добавлена поддержка macOS.
- 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 complex | success | Различия по заданным аргументам. | |
| after словарь | Значения после изменения | ||
| before словарь | Значения до изменения | ||
Статус
- Гарантируется, что этот модуль не имеет обратной совместимости. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- 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.7/modules/timezone_module.html