community.general.timezone – Настройка часового пояса
Примечание
Этот плагин входит в состав коллекции community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в playbook укажите: community.general.timezone.
Описание
- Этот модуль настраивает часовой пояс, как системных часов, так и аппаратных часов. Если вы хотите настроить NTP, используйте модуль ansible.builtin.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
community.general.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.10/collections/community/general/timezone_module.html