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