Merge branch 'jeremydouglass-patch-1'

* jeremydouglass-patch-1:
  rename docker-cloud.yml --> docker-stack.yml
  comments: give simple example instructions for compose and swarm
  comments: expand port and pass comments
  drop `links` (ignored in swarm)

Author: jeremydouglass

docker-cloud.yml renamed to docker-stack.yml

@@ -1,27 +1,35 @@
 version: '3.1'
 
+# run with docker-compose:
+#
+#     docker-compose -f docker-stack.yml up
+
+# run with docker swarm:
+#
+#     docker swarm init
+#     docker stack deploy --compose-file docker-stack.yml authdemo
+
 volumes:
   web-data:
 
 services:
 
   web:
     image: 'nginx'
-    ## instead of an exposed port use FORWARD_PORT below
+    ## instead of an exposed port, use FORWARD_PORT in auth, below
     # ports:
     #   - '80:80'
     volumes:
       - web-data:/usr/share/nginx/html:ro
 
   auth:
     image: 'beevelop/nginx-basic-auth'
-    links:
-      - 'web'
     ports:
       - '8080:80'
     environment:
       - PORT=80
       - FORWARD_HOST=web
       - FORWARD_PORT=80
       ## escape $ with $$ in Docker yml due to variable expansion
+      ## example user/pass generated with htpasswd is foo:bar
       - HTPASSWD=foo:$$apr1$$odHl5EJN$$KbxMfo86Qdve2FH4owePn.