From 9270ea6230c8541102e7f21c3385f56348b23304 Mon Sep 17 00:00:00 2001 From: Davous3k <42912770+Davous3k@users.noreply.github.com> Date: Thu, 28 Jul 2022 10:58:31 +0200 Subject: [PATCH] Update README.md --- README.md | 37 ++++++++++++++++++++++++++++++++++--- 1 file changed, 34 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index dcbfd3b..12df1b0 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,34 @@ -# TODO -- Add readme, as it is always needed. Who knows who will want to use this role? -- - At least: 1) Basic description 2) Important variables 3) Detailed info 4) Playbook example 5) Don't forget to mention other role dependencies +Ansible role for chrony setup. + +This role is developed with Ansible 2.9.6 and tesed on Ubuntu 20.04 LTS. + +## Role Variables + +| Variable | Required | Default | Comments | +| -------- | -------- | ------- | -------- | +| `chrony_pkg_state` | No | `present` | Set pkg `enabled`, `disabled`, `latest` | +| `chrony_service_state` | No | `started` | Set service state, started, enabled or disabled | +| `chrony_service_enabled` | No | `yes` | A list of NTP servers to use. | +| `chrony_config_server` | No | `["0.cz.pool.ntp.org","1.cz.pool.ntp.org","2.cz.pool.ntp.org", "3.cz.pool.ntp.org"]` | A list of NTP servers to use. | +| `chrony_config_logdir` | No | `/var/log/chrony` | A list of NTP servers to use. | +| `chrony_config_extra_options` | No | `{}` | A dict of extra config options. | + +## Requirements + +None + +## Install chrony with default settings +```yaml + roles: + - ansible-chrony +``` + +## Install chrony with some custom variables +```yaml + roles: + - ansible-chrony + vars: + - chrony_config_server: + - 0.pool.ntp.org + - 1.pool.ntp.org +```