mirror of
https://github.com/roles-ansible/ansible_role_ntp.git
synced 2024-08-16 12:59:49 +02:00
100 lines
2.8 KiB
Markdown
100 lines
2.8 KiB
Markdown
[](https://galaxy.ansible.com/ui/standalone/roles/l3d/ntp/)
|
|
[](LICENSE)
|
|
[](https://ansible.l3d.space/#l3d.ntp)
|
|
|
|
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:
|
|
|
|
```yaml
|
|
---
|
|
# 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:
|
|
```bash
|
|
ansible-galaxy install l3d.ntp
|
|
```
|
|
|
|
Or download or clone this git repo. Example:
|
|
```bash
|
|
git clone https://github.com/roles-ansible/ansible_role_ntp.git l3d.ntp
|
|
```
|
|
### Using this role in a Playbook
|
|
```yml
|
|
---
|
|
- name: Install and Configure NTP
|
|
hosts: example.com
|
|
roles:
|
|
- {role: l3d.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](https://doc.ubuntu-fr.org/ntp)
|
|
|
|
## Requirements
|
|
The ``community.general`` collection is required for some parts of this ansible role.
|
|
You can install it with this command:
|
|
```bash
|
|
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](https://github.com/do1jlr))*
|
|
+ In 2023 this role moved from ``do1jlr.ntp`` to ``l3d.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.
|