Description

Installs/Configures chrony

Requirements

Chef Client:

• chef (>= 12.1)

Platform:

• debian (>= 8.0.0)
• ubuntu (>= 16.04.0)
• centos (>= 7.0.0)
• redhat
• amazon

Cookbooks:

No dependencies defined

Attributes

• node[cookbook_name]['config'] - chrony.conf value. Hash value can be a string or an array of string. Defaults to case node['platform_family'].
• node[cookbook_name]['amazon_time_sync_service'] - Whether to use Amazon Time Sync Service. Defaults to false.
• node[cookbook_name]['config_update_restart'] - Whether to restart chrony daemon after config file change. Defaults to true.

Recipes

• chrony_ii::config - Configures application name, path, and configuration file based on platform family.
• chrony_ii::default - Loads necessary recipes.
• chrony_ii::package - Removes competing packages and installs chrony.
• chrony_ii::service - Configures chrony service.
• chrony_ii::systemd_support

chrony_ii::config

Configures application name, path, and configuration file based on platform family.

chrony_ii::default

Loads necessary recipes.

chrony_ii::package

Removes competing packages and installs chrony.

chrony_ii::service

Configures chrony service.

chrony_ii::systemd_support

Provides supporting resources for systemd

Resources

• chrony_ii_systemd_dependency

chrony_ii_systemd_dependency

Manages additional chronyd service dependencies in systemd

Actions

• create: Create chronyd service dependencies in systemd Default action.
• delete: Delete chronyd service dependencies in systemd

Attribute Parameters

• systemd_system_dir: systemd's system config directory path
• wants: systemd service 'Wants=' targets with symlinks to 'chronyd.service.wants' Defaults to <code>"network-online.target"</code>.
• after: systemd service 'After=' targets with symlinks to 'chronyd.service.after' Defaults to <code>"network-online.target"</code>.

Examples

include_recipe 'chrony_ii::systemd_support'
chrony_ii_systemd_dependency '/usr/lib/systemd/system'

include_recipe 'chrony_ii::systemd_support'
chrony_ii_systemd_dependency '/usr/lib/systemd/system' do
  wants 'x.target y.target'
  after 'x.target'
end

Deprecation Notice

We are planning to migrate from attribute and recipe-based cookbook to custom resource-based cookbook.
Most recipes will be deprecated after providing custom resources.

For custom resource's unified_mode feature mandatory for Chef 17, the next major update requires Chef >= 15.3.0.

How to release

• Version up: update metadata.rb
• Update Changelog: github_changelog_generator -u elastic-infra -p chrony_ii --future-release v0.5.2
• Release cookbook: chef exec stove

Testing

To lint the project

chef exec cookstyle

Unit testing

chef exec rspec

Integration testing

chef exec kitchen test

Usage

If you are fine with using the public NTP servers you can simply include chrony_ii in your node's run_list:

{
  "name":"my_node",
  "run_list": [
    "recipe[chrony_ii]"
  ]
}

If you need to control your configuration use a role.

License and Maintainer

Maintainer:: Tomoya Kabe (kabe@elastic-infra.com)

Source:: https://github.com/elastic-infra/chrony_ii

Issues:: https://github.com/elastic-infra/chrony_ii/issues

License:: MIT