ansible-role-timesync

Configure time synchronization based upon timesync

Dependencies

Roles

None

Collections

• community.general

Platforms

Supported platforms

• Red Hat Enterprise Linux 8¹
• Red Hat Enterprise Linux 9¹
• RockyLinux 8
• RockyLinux 9
• OracleLinux 8
• OracleLinux 9
• AlmaLinux 8
• AlmaLinux 9
• Debian 11 (Bullseye)
• Debian 12 (Bookworm)
• Debian 13 (Trixie)
• Ubuntu 22.04 LTS
• Ubuntu 24.04 LTS
• Fedora 42
• Fedora 43

Note: ¹ : no automated testing is performed on these platforms

Role Variables

defaults/main.yml

# packages that need to be present
timesync_packages:
  - systemd-timesyncd

# should obsolete packages be uninstalled
timesync_packages_uninstall: false

# Packages that can be removed
timesync_packages_obsolete:
  - chrony
  - ntp

# Obsolete services
timesync_services_obsolete:
  - chrony
  - chronyd
  - ntp
  - ntpd

# Time zone (eg 'Europe/Amsterdam')
# Use value 'unchanged' to leave it unchanged
timesync_timezone: ""

# Ensure hwclock is set to UTC or local time
# options : local, UTC
timesync_hwclock: null

# List of primary NTP servers
timesync_ntp_servers: []

# List of fallback NTP servers
timesync_fallback_ntp_servers:
  - 0.pool.ntp.org
  - 1.pool.ntp.org
  - 2.pool.ntp.org
  - 3.pool.ntp.org

# Additional options (as key/value pairs)
timesync_options: {}

defaults/Debian-10.yml

# packages that should be installed
timesync_packages: []

defaults/family-Debian.yml

defaults/family-RedHat-7.yml

# packages that should be installed
timesync_packages: []

defaults/family-RedHat.yml

defaults/family-Suse.yml

# For SLES/OpenSUSE, it is part of ssytemd
timesync_packages: []

defaults/Fedora.yml

# packages that need to be present
timesync_packages:
  - systemd-udev

defaults/Ubuntu-18.yml

# packages that should be installed
timesync_packages: []

Example Playbook

molecule/default/converge.yml

- name: sample playbook for role 'timesync'
  hosts: all
  become: 'yes'
  vars:
    molecule_driver: '{{ lookup(''env'', ''MOLECULE_DRIVER_NAME'') }}'
    timesync_timezone: UTC
    timesync_ntp_servers:
      - 0.nl.pool.ntp.org
      - 1.nl.pool.ntp.org
      - 2.nl.pool.ntp.org
      - 3.nl.pool.ntp.org
  tasks:
    - name: Include role 'timesync'
      ansible.builtin.include_role:
        name: timesync