document role dependencies

diff --git a/site.yml b/site.yml
index 74658bfd449820aa4aa44ea7c11826fa5af02238..ce0a363e6e61820603f8b35f940120f08510cf6f 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:
 - hosts: all
   gather_facts: no
   pre_tasks:


@@ -19,12 +28,14 @@
   tags: letsencrypt
 
 - hosts: email
   tags: letsencrypt
 
 - hosts: email

+  # depends: letsencrypt, unbound

   gather_facts: no
   roles:
   - email
   tags: email
 
 - hosts: journalwatch
   gather_facts: no
   roles:
   - email
   tags: email
 
 - hosts: journalwatch

+  # depends: email

   gather_facts: no
   roles:
   - journalwatch
   gather_facts: no
   roles:
   - journalwatch


@@ -43,12 +54,14 @@
   tags: etherpad
 
 - hosts: prosody
   tags: etherpad
 
 - hosts: prosody

+  # depends: letsencrypt

   gather_facts: no
   roles:
   - prosody
   tags: prosody
 
 - hosts: apache
   gather_facts: no
   roles:
   - prosody
   tags: prosody
 
 - hosts: apache

+  # depends: letsencrypt

   gather_facts: no
   roles:
   - apache
   gather_facts: no
   roles:
   - apache