From: Ralf Jung <post@ralfj.de>
Date: Tue, 22 May 2018 20:25:54 +0000 (+0200)
Subject: document role dependencies
X-Git-Url: https://git.ralfj.de/ansible.git/commitdiff_plain/c1820adc8c1046521859adf5301b230797e2255f?ds=inline;hp=1be17289bddb7a00cd1cef53107656e6c0692531

document role dependencies
---

diff --git a/site.yml b/site.yml
index 74658bf..ce0a363 100644
--- 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:
@@ -19,12 +28,14 @@
   tags: letsencrypt
 
 - hosts: email
+  # depends: letsencrypt, unbound
   gather_facts: no
   roles:
   - email
   tags: email
 
 - hosts: journalwatch
+  # depends: email
   gather_facts: no
   roles:
   - journalwatch
@@ -43,12 +54,14 @@
   tags: etherpad
 
 - hosts: prosody
+  # depends: letsencrypt
   gather_facts: no
   roles:
   - prosody
   tags: prosody
 
 - hosts: apache
+  # depends: letsencrypt
   gather_facts: no
   roles:
   - apache