Changeset - 91b1e458dd17
[Not reviewed]
0 3 0
Branko Majic (branko) - 6 years ago 2017-11-19 19:02:19
branko@majic.rs
MAR-127: Updated documentation and testsite configuration for NTP:

- Updated role reference documentation for common role to list the new
functionality and documented the new parameter.
- Updated usage instructions to mention NTP time synchronisation
configuration.
- Updated testsite configuration to set-up the NTP time
synchronisation.
3 files changed with 28 insertions and 1 deletions:
0 comments (0 inline, 0 general)
docs/rolereference.rst
Show inline comments
 
@@ -300,6 +300,8 @@ The role implements the following:
 
  custom script that outputs diffs if upgrades are available. Script is run via
 
  cronjob on hourly basis, and any output will be delivered to local ``root``
 
  user.
 
* Optionally configures time synchronisation using NTP (if
 
  ``ntp_servers`` parameter is set).
 

	
 

	
 
Role dependencies
 
@@ -400,6 +402,19 @@ Parameters
 
  higher than ``incoming_connection_limit``), even if it would go above the
 
  specified connection limit.
 

	
 
**ntp_servers** (list, optional, ``[]``)
 
  List of NTP servers to use for synchronising the time on managed
 
  machine using NTP. If no time synchronisation should be set-up, set
 
  to empty list. Default is not to configure time synchronisation.
 

	
 
  If setting this parameter, it is recommended to set the list of
 
  servers to list shipped by default Debian configuration::
 

	
 
    - "0.debian.pool.ntp.org"
 
    - "1.debian.pool.ntp.org"
 
    - "2.debian.pool.ntp.org"
 
    - "3.debian.pool.ntp.org"
 

	
 
**pipreqcheck_uid** (integer, optional, ``whatever OS picks``)
 
  UID for user running the pip requirements upgrade checks. User is created with
 
  name ``pipreqcheck``.
docs/usage.rst
Show inline comments
 
@@ -448,6 +448,11 @@ Let's take care of this common configuration right away:
 
      common_packages:
 
        - emacs24-nox
 

	
 
   .. note::
 
      The ``common`` role comes with ability to set-up time
 
      synchronisation using NTP. This is not done by default. For
 
      details see the role parameter ``ntp_servers``.
 

	
 
6. That's all for configuration, time to apply the changes::
 

	
 
     workon mysite && ansible-playbook playbooks/site.yml
testsite/group_vars/all.yml
Show inline comments
 
@@ -82,4 +82,11 @@ backup_ssh_key: "{{ lookup('file', inventory_dir + '/ssh/' + ansible_fqdn) }}"
 

	
 
# Set-up prompt.
 
prompt_colour: light_purple
 
prompt_id: MAR
 
\ No newline at end of file
 
prompt_id: MAR
 

	
 
# Set-up NTP time synchronisation.
 
ntp_servers:
 
  - "0.debian.pool.ntp.org"
 
  - "1.debian.pool.ntp.org"
 
  - "2.debian.pool.ntp.org"
 
  - "3.debian.pool.ntp.org"
0 comments (0 inline, 0 general)