DEBOPS.TZDATA(5)

NAME
debops.tzdata - Manage system time zone using Ansible

SYNOPSIS

debops run service/tzdata [--limit group,host,...] [--diff] [--check] [--tags tag1,tag2,...] [--skip-tags tag1,tag2,...] [<ansible-playbook options>] ...

DESCRIPTION

The debops.tzdata Ansible role helps manage the time zone on Debian/Ubuntu hosts. The role will make sure that services affected by time zone changes (cron, rsyslog) will be restarted if needed.

The role also provides the ansible_local.tzdata.timezone Ansible local fact with the host time zone specified in the Area/Zone format required in some configuration files.

GETTING STARTED

  Example inventory

The debops.tzdata role is included by default in the common.yml DebOps playbook; you don't need to add hosts to any Ansible groups to enable it.

  Example playbook

If you are using this role without DebOps, here's an example Ansible playbook that uses the debops.tzdata role:

---
- name: Manage time zone configuration
  collections: [ 'debops.debops', 'debops.roles01',
                 'debops.roles02', 'debops.roles03' ]
  hosts: [ 'debops_all_hosts', 'debops_service_tzdata' ]
  become: True
  environment: '{{ inventory__environment | d({})
                   | combine(inventory__group_environment | d({}))
                   | combine(inventory__host_environment  | d({})) }}'
  roles:
    - role: tzdata
      tags: [ 'role::tzdata', 'skip::tzdata' ]

  Ansible tags

You can use Ansible --tags or --skip-tags parameters to limit what tasks are performed during Ansible run. This can be used after a host was first configured to speed up playbook execution, when you are sure that most of the configuration is already in the desired state.

Available role tags:

role::tzdata
    Main role tag, should be used in the playbook to execute all of the role tasks as well as role dependencies.

  Other resources

List of other useful resources related to the debops.tzdata Ansible role:

•   Manual pages: timedatectl(1) <https://manpages.debian.org/timedatectl(1)>

•   Details about time zone changes on Debian wiki <https://wiki.debian.org/TimeZoneChanges>

AUTHOR
Maciej Delmanowski

COPYRIGHT
2014-2024, Maciej Delmanowski, Nick Janetakis, Robin Schneider and others