From: nicoo <nicoo@realraum.at>
Date: Thu, 5 Jul 2018 12:02:48 +0000 (+0200)
Subject: Document the settings in ansible.cfg
X-Git-Url: https://git.realraum.at/?p=noc.git;a=commitdiff_plain;h=fe45ed92ebbced301bea5663e654920244021576

Document the settings in ansible.cfg
---

diff --git a/ansible/ansible.cfg b/ansible/ansible.cfg
index 2e674c0..5a05b61 100644
--- a/ansible/ansible.cfg
+++ b/ansible/ansible.cfg
@@ -1,10 +1,13 @@
 [defaults]
+# Setup paths for crucial files (inventory, roles, logs, vault key)
 inventory = ./hosts.ini
 roles_path = ./roles:../roles
 log_path = ./log
-nocows=1
 vault_password_file = ./gpg/get-vault-pass.sh
 
+# Disable an annoying easter-egg
+nocows = 1
+
 # Error-out when encountering an undefined variable
 # See https://docs.ansible.com/ansible/latest/intro_configuration.html#error-on-undefined-vars
 error_on_undefined_vars = True
@@ -12,15 +15,18 @@ error_on_undefined_vars = True
 # Run more tasks in parallel
 forks = 50
 
+# Cache host facts for 2h
 gathering = smart
 fact_caching = jsonfile
 fact_caching_connection = ./.cache/facts
 fact_caching_timeout = 7200
-
 var_compression_level = 9
 
-timeout=30
+# Increase the timeout, to deal with going through jump hosts
+timeout = 30
 
+# Use SSH pipelining and multiplexing to minimize the number of extra
+# connections and round-trips.
 [ssh_connection]
 pipelining = True
 ssh_args = -C -o ControlMaster=auto -o ControlPersist=60s