Add example app ReadMe

roles/whoami/README.md

@@ -0,0 +1,51 @@
+# whoami
+
+A very simple service application stack role which can be used to base other roles off of.
+Contains only a single deployed image and a couple of simple variables to set.
+
+## Variables
+
+```
+whoami_upstream_file_dir: "{{ docker_stack_files_dir }}/{{ stack.name }}"
+```
+
+The on-target directory where the proxy configuration file should be stashed.
+
+```
+whoami_use_https: true
+```
+
+Whether the service should be reachable through http (port 80) or through https (port 443) and provision an https certificate. Usually you will want this to stay `true`.
+
+```
+whoami_version: latest
+```
+
+The docker image version to be used in stack creation.
+
+## Internal variables
+
+```
+stack:
+  name: whoami
+  compose: "{{ lookup('template', 'docker-stack.yml.j2') | from_yaml }}"
+```
+
+The name of the stack to be provisioned and the compose file to be used.
+See caddy ReadMe for configuration.
+
+```
+stack_image: "containous/whoami"
+```
+
+The docker hub image to be use in provisioning.
+
+## Simple single-container stack repurposing
+
+If basing another single-container 'stack' on it, only the variables in defaults and vars have to be replaced for another fully functioning stack.
+The fastest way to accomplish this is with rg and sed:
+
+```
+rg 'containous/whoami' --files-with-matches | xargs sed -i 's|containous/whoami|<your-new-docker-image>|g'
+rg whoami --files-with-matches | xargs sed -i 's/whoami/wallabag/g'
+```