community.general.timezone – Настройка часового пояса

Примечание

Этот плагин входит в коллекцию community.general (версия 2.0.1).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в книге задач укажите: 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 строка	Варианты: local UTC	Указывает, находятся ли аппаратные часы в 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 сложный		success	Различия по заданным аргументам.
	after словарь	success	Значения после изменения.
	before словарь	success	Значения до изменения.

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/timezone_module.html