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 сложное | успех | Различия по заданным аргументам. | |
| after словарь | Значения после изменения | ||
| before словарь | Значения до изменения | ||
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимостью.
Автор
- 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.5/modules/timezone_module.html