Ansible role ntp

Ansible role to install and configure the Network Time Protocol (NTP) Daemon.

This role was built with support for a variety of operating systems. Including Debian/Ubuntu, RHEL, Suse and Archlinux based Linux versions as well as FreeBSD, Darwin and OpenBSD.

Role Variables

In addition to the operating system-dependent variables, there are the following default values to adjust:

---
# defaults file for ansible-role-ntp

# Restrict acces on ntp server
# Default is: ::1, 127.0.0.1
ntp_restrict:
  - default nomodify notrap nopeer noquery
  - 127.0.0.1
  - ::1

# Ntp server to use for date synchronization
# Default is worldwide pool
ntp_servers:
  - ptbtime1.ptb.de
  - ptbtime3.ptb.de
  - 0.pool.ntp.org iburst
  - 1.pool.ntp.org iburst
  - 2.pool.ntp.org iburst
  - 3.pool.ntp.org iburst

# optionally set timezone
ntp_set_time_zone: false
ntp_timezone: 'Europe/Berlin'

# Leap seconds definition provided by tzdata
ntp_leap: true
ntp_leapfile: '/usr/share/zoneinfo/leap-seconds.list'

# Enable or disable ntp statistics
ntp_statistics: false

# version check for this playbook (true is recomended)
submodules_versioncheck: false

Example Usage

Getting this Role

You can install this role using ansible Galaxy:

ansible-galaxy install roles-ansible.ntp

Or download or clone this git repo. Example:

git clone https://github.com/roles-ansible/ansible_role_ntp.git roles-ansible.ntp

Using this role in a Playbook

---
- name: Install and Configure NTP
  hosts: example.com
  roles:
    - {role: roles-ansible.ntp, tags: ntp}
  vars:
    submodules_versioncheck: true
    ntp_set_time_zone: true
    ntp_timezone: Zulu
    # In this example, we enabled optional version check
    # and set timezone to Zulu.

Resources

ntp on ubuntu

Requirements

The community.general collection is required for some parts of this ansible role. You can install it with this command:

ansible-galaxy collection install -r requirements.yml --upgrade

Testing

This role is tested on debian stable. It should work on other operating systems. Please Report issues if it does not work.

Author Information

• This role was created in 2018 by diodonfrost.
• This role was updated and maintained since 2019 by L3D (DO1JLR)
• In 2023 this role moved from do1jlr.ntp to l3d.ntp Namespace.
• With the introduction of galaxy-ng the role was forced to move from l3d.ntp to the roles-ansible.ntp Namespace.

Contribution

Pleas feel free to open a issue or (even better) create a Pull Request if there is a problem or you missing a feature or something like that.