document role dependencies
authorRalf Jung <post@ralfj.de>
Tue, 22 May 2018 20:25:54 +0000 (22:25 +0200)
committerRalf Jung <post@ralfj.de>
Tue, 22 May 2018 20:25:54 +0000 (22:25 +0200)
site.yml

index 74658bf..ce0a363 100644 (file)
--- a/site.yml
+++ b/site.yml
@@ -1,3 +1,12 @@
+# Dependencies are "expressed" by the hosts file, e.g.
+# ```
+# [letsencrypt:children]
+# apache
+# email
+# ```
+# I tried using role dependencies but that doesn't interact well with tags:
+# When restricting to a tag, its dependencies still get played.
+
 - hosts: all
   gather_facts: no
   pre_tasks:
   tags: letsencrypt
 
 - hosts: email
+  # depends: letsencrypt, unbound
   gather_facts: no
   roles:
   - email
   tags: email
 
 - hosts: journalwatch
+  # depends: email
   gather_facts: no
   roles:
   - journalwatch
   tags: etherpad
 
 - hosts: prosody
+  # depends: letsencrypt
   gather_facts: no
   roles:
   - prosody
   tags: prosody
 
 - hosts: apache
+  # depends: letsencrypt
   gather_facts: no
   roles:
   - apache