Ansible Role: NTP
Installs NTP on Linux.
Requirements
None.
Role Variables
Available variables are listed below, along with default values (see defaults/main.yml):
ntp_enabled: True
Whether to start the ntpd service and enable it at system boot. On many virtual machines that run inside a container (like OpenVZ or VirtualBox), it's recommended you don't run the NTP daemon, since the host itself should be set to synchronize time for all it's child VMs.
ntp_timezone: Etc/UTC
Set the timezone for your server.
ntp_manage_config: False
Set to true to allow this role to manage the NTP configuration file (/etc/ntp.conf).
ntp_area: ''
Set the NTP Pool Area to use. Defaults to none, which uses the worldwide pool.
ntp_servers:
- "0{{ '.' + ntp_area if ntp_area else '' }}.pool.ntp.org"
- "1{{ '.' + ntp_area if ntp_area else '' }}.pool.ntp.org"
- "2{{ '.' + ntp_area if ntp_area else '' }}.pool.ntp.org"
- "3{{ '.' + ntp_area if ntp_area else '' }}.pool.ntp.org"
Specify the NTP servers you'd like to use. The iburst flag isset on all servers.
ntp_localhosts:
- "127.0.0.1"
- "::1"
Specifiy NTP clients that should have full access to the server, typically just localhost. Only takes effect if you allow this role to manage NTP's configuration, by setting ntp_manage_config to True.
ntp_clients:
- "192.168.0.0/24"
- "192.168.1.0/24""
Specifiy NTP clients that should have full polling access to the server, typically machines on local networks. Only takes effect if you allow this role to manage NTP's configuration, by setting ntp_manage_config to True.
ntp_clients:
- "192.168.0.0/24"
- "192.168.1.0/24""
Specifiy NTP clients that should have full polling access to the server, typically machines on local networks. Only takes effect if you allow this role to manage NTP's configuration, by setting ntp_manage_config to True.
ntp_peers:
- "192.168.0.4"
- "192.168.0.5""
Specifiy NTP peers servers that should have full a symmetric time adjustment relationship. Only takes effect if you allow this role to manage NTP's configuration, by setting ntp_manage_config to True.
Dependencies
None.
Example Playbook
- hosts: all
roles:
- geerlingguy.ntp
Inside vars/main.yml:
ntp_timezone: America/Chicago
License
MIT / BSD
Author Information
This role was created in 2014 by Jeff Geerling, author of Ansible for DevOps.