Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/voxpupuli/puppet-chrony
Puppet module for Chrony with Systemd
https://github.com/voxpupuli/puppet-chrony
archlinux-puppet-module centos-puppet-module debian-puppet-module gentoo-puppet-module hacktoberfest linux-puppet-module puppet redhat-puppet-module sles-puppet-module ubuntu-puppet-module
Last synced: 3 days ago
JSON representation
Puppet module for Chrony with Systemd
- Host: GitHub
- URL: https://github.com/voxpupuli/puppet-chrony
- Owner: voxpupuli
- License: apache-2.0
- Created: 2012-08-22T04:50:16.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2024-09-17T23:41:36.000Z (4 months ago)
- Last Synced: 2024-12-30T16:05:21.548Z (4 days ago)
- Topics: archlinux-puppet-module, centos-puppet-module, debian-puppet-module, gentoo-puppet-module, hacktoberfest, linux-puppet-module, puppet, redhat-puppet-module, sles-puppet-module, ubuntu-puppet-module
- Language: Ruby
- Homepage: https://forge.puppet.com/puppet/chrony
- Size: 480 KB
- Stars: 12
- Watchers: 43
- Forks: 59
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# puppet-chrony
[](https://github.com/voxpupuli/puppet-chrony/blob/master/LICENSE)
[](http://travis-ci.org/voxpupuli/puppet-chrony)
[](https://forge.puppetlabs.com/puppet/chrony)
[](https://forge.puppetlabs.com/puppet/chrony)
[](https://forge.puppetlabs.com/puppet/chrony)
## Table of Contents
1. [Overview](#overview)
1. [Module Description - What the module does and why it is useful](#module-description)
1. [Setup - The basics of getting started with chrony](#setup)
- [What chrony affects](#what-chrony-affects)
- [Setup requirements](#setup-requirements)
- [Beginning with chrony](#beginning-with-chrony)
1. [Usage - Configuration options and additional functionality](#usage)
1. [Reference - An under-the-hood peek at what the module is doing and how](#reference)
1. [Limitations - OS compatibility, etc.](#limitations)
1. [Copyright and License](#copyright-and-license)
## Overview
### Chrony Puppet Module
Manage chrony time daemon on Archlinux and Redhat
## Module Description
The Chrony module handles running chrony in Archlinux and Redhat systems
with systemd.
## Setup
### What chrony affects
- chrony package.
- chrony configuration file.
- chrony key file.
- chrony service.
### Requirements
Please review `metadata.json` for a list of requirements.
### Beginning with chrony
`include 'chrony'` is all you need to get it running. If you
wish to pass in parameters like which servers to use
then you can use:
```puppet
class { 'chrony':
servers => ['ntp1.corp.com', 'ntp2.corp.com' ],
}
```
## Usage
All interaction with the chrony module can be done through
the main chrony class.
### I just want chrony, what's the minimum I need?
```puppet
include 'chrony'
```
### I just want to tweak the servers, nothing else
```puppet
class { 'chrony':
servers => [ 'ntp1.corp.com', 'ntp2.corp.com', ],
}
```
### I'd like to make sure a secret password is used for chronyc
```puppet
class { 'chrony':
servers => [ 'ntp1.corp.com', 'ntp2.corp.com', ],
chrony_password => 'secret_password',
}
```
### I'd like to use NTP authentication
```puppet
class { 'chrony':
keys => ['25 SHA1 HEX:1dc764e0791b11fa67efc7ecbc4b0d73f68a070c'],
servers => {
'ntp1.corp.com' => ['key 25', 'iburst'],
'ntp2.corp.com' => ['key 25', 'iburst'],
},
}
```
### I'd like chronyd to auto generate a command key at startup
```puppet
class { 'chrony':
chrony_password => 'unset',
config_keys_manage => false,
}
```
### Allow some hosts
```puppet
class { 'chrony':
queryhosts => [ '192.168/16', ],
}
```
### How to configure leap second
```puppet
class { 'chrony':
leapsecmode => 'slew',
smoothtime => '400 0.001 leaponly',
maxslewrate => 1000.0
}
```
### Enable chrony-wait.service
RedHat and Suse provide a default disabled `chrony-wait.service` to block the `time-sync.target`
until node is synchronised.
To enable it:
```puppet
class { 'chrony':
wait_enable => true,
wait_ensure => true,
}
```
## Reference
Reference documentation for the chrony module is generated using
[puppet-strings](https://puppet.com/docs/puppet/latest/puppet_strings.html) and
available in [REFERENCE.md](REFERENCE.md)
## Limitations
This module has been built on and tested against Puppet 5.5 and higher.
The module has been tested on:
- Arch Linux
- Red Hat
- Debian 9, 10
- Ubuntu 18.04, 20.04
- Suse 12.3
- Gentoo 2.7
## Copyright and License
This module is distributed under the [Apache License 2.0](LICENSE). Copyright
belongs to the module's authors, including Niels Abspoel and
[others](https://github.com/voxpupuli/puppet-chrony/graphs/contributors).
The module was originally written by [Niels Abspoel](https://github.com/aboe76)
and released as [aboe76/chrony](https://forge.puppet.com/aboe/chrony).
Since version 0.4.0, it is maintained by [Vox Pupuli](https://voxpupuli.org/).