timezone – Настройка часового пояса
Обзор
- Этот модуль настраивает часовой пояс, как для системных часов, так и для аппаратных часов. Если вы хотите настроить NTP, используйте модуль service.
- Рекомендуется перезапустить
crondпосле изменения часового пояса, иначе задачи могут выполняться в неправильное время. - В зависимости от используемой ОС/дистрибутива используются различные инструменты. Для Linux можно использовать
timedatectlили отредактировать/etc/sysconfig/clockили/etc/timezoneиhwclock. На SmartOS используетсяsm-set-timezone, для macOS –systemsetup, для BSD –/etc/localtime. На AIX используетсяchtz. - Начиная с Ansible 2.3, добавлена поддержка SmartOS и BSD.
- Начиная с Ansible 2.4, добавлена поддержка macOS.
- Начиная с Ansible 2.9, добавлена поддержка AIX 6.1+
- Windows и HPUX не поддерживаются. Пожалуйста, сообщите нам, если вы обнаружите другую ОС/дистрибутив, в котором этот модуль не работает.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| hwclock строка |
| Определяет, находятся ли аппаратные часы в UTC или в локальном часовом поясе. Значение по умолчанию – сохранение текущих настроек. Обратите внимание, что рекомендуется не изменять этот параметр, и он может не сконфигурироваться, особенно в виртуальных средах, таких как AWS. Требуется указание хотя бы одного из параметров name или hwclock. Используется только на Linux. псевдонимы: rtc |
| name строка | Имя часового пояса для системных часов. Значение по умолчанию – сохранение текущих настроек. Требуется указание хотя бы одного из параметров name или hwclock. |
Примечания
Примечание
- На SmartOS требуется утилита
sm-set-timezone, (часть пакета smtools), для установки часового пояса. - На AIX можно использовать только часовые пояса из базы данных Olson/tz (POSIX не поддерживается). — Для вступления в силу нового часового пояса на AIX также требуется перезагрузка ОС.
Примеры
- name: Set timezone to Asia/Tokyo
timezone:
name: Asia/Tokyo
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| diff сложное | 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.9/modules/timezone_module.html