Frzk.chrony
Ansible Role: chrony
This Ansible role lets you install chrony
and manage its settings.
A special systemd unit file is created for Debian version 11 and above, and Arch Linux.
For more details on chrony
, visit the official project page.
Requirements
None
Dependencies
None
Role variables
Variable name | Description | Default value |
---|---|---|
chrony_service_name |
The name of the service. | chronyd |
chrony_ntp_pools |
A list of NTP pools to use and their options. | [ 'pool.ntp.org iburst maxpoll 10' ] |
chrony_ntp_servers |
A list of NTP servers to use and their options. | [] |
chrony_ntp_peers |
A list of NTP peers to use and their options. | [] |
chrony_config_file |
The location of the chrony configuration file. | /etc/chrony.conf |
chrony_config_logdir |
The location of the chrony logs directory. | /var/log/chrony |
chrony_config_driftfile |
The location of the chrony drift file. | /var/lib/chrony/drift |
chrony_makestep_threshold |
The time (in seconds) beyond which chrony will step the clock instead of adjusting it gradually. | 1 |
chrony_makestep_limit |
The limit (in number) beyond which chrony will no longer step the clock, even if needed. | 10 |
chrony_allow |
A list of allowed subnets that can access this machine as an NTP server. | [] |
chrony_deny |
A list of disallowed subnets that cannot access this machine as an NTP server. | [] |
:green_book: Documentation:
Example
Here’s a simple example playbook.
IMPORTANT: DO NOT use this example directly.
---
- hosts: all
become: true
roles:
- role: frzk.chrony
chrony_service_name: chronyd
chrony_ntp_pools: []
chrony_ntp_servers:
- 0.rhel.pool.ntp.org iburst maxpoll 10
- 1.rhel.pool.ntp.org iburst maxpoll 10
- 2.rhel.pool.ntp.org iburst maxpoll 10
- 3.rhel.pool.ntp.org iburst maxpoll 10
chrony_ntp_peers:
- ntp00.example.com maxpoll 10
- ntp01.example.com maxpoll 10
- ntp02.example.com maxpoll 10
chrony_config_file: /etc/chrony.conf
chrony_config_driftfile: /var/lib/chrony/drift
chrony_makestep_threshold: 5
chrony_makestep_limit: 3
chrony_allow:
- 192.0.2.0/24
- 192.0.2.200
chrony_deny:
- 192.0.2.0/25
...
Testing
Testing is done using Molecule and Ansible with GitHub Actions and Docker containers.
Successful tests occur on:
- Arch Linux
- Debian 11
- Debian 10
- Debian 9
- Ubuntu 20.04
- Ubuntu 18.04
Contributing
Feedback, patches, comments, bug reports, and feature requests are welcome. Please refer to the Contributing Guide for more details.