docs(local-vagrant): some clarifications

Author: Stefan Walther

local-bash/README.md

@@ -2,9 +2,9 @@
 
 ## Summary
 
-- Create a few machines in the local VirtualBox environment
+- Create a few machines on your local VirtualBox
 - Init a swarm (manager + worker nodes)
-- Deploy a docker-compose (v3) file
+- Deploy a Docker stack (Docker compose v3; swarm mode)
 
 ## Prerequisites
 

local-vagrant/README.md

@@ -1,3 +1,13 @@
+# Deploy a swarm cluster on your local machine (using Vagrant)
+
+## Summary
+
+The following tasks will be performed:
+
+- Create a few machines on your local VirtualBox
+- Init a Docker swarm (manager + worker nodes)
+- Deploy a Docker stack (Docker compose v3; swarm mode)
+
 
 ## Prerequisites
 
@@ -17,17 +27,17 @@ $ vagrant up
 
 This will 
 
-- provision 1 manager, 
-- 3 workers and 
+- provision 3 managers, 
+- 2 workers and 
 - deploy, initialize a docker swarm and 
-- deploy the services as defined in `.docker-stack.yml`.
+- deploy the services as defined in `./../lib/docker-stack.yml`.
 
 ## Configuration
 
 Open the `config.yml` file to change the configuration options:
 
-- `NUM_OF_MANAGERS` - Number of managers to create (defaults to `1`).
-- `NUM_OF_WORKERS` - Number of workers to create (defaults to `3`).
+- `NUM_OF_MANAGERS` - Number of managers to create (defaults to `3`).
+- `NUM_OF_WORKERS` - Number of workers to create (defaults to `2`).
 - `MEMORY` - Allocated memory for each of the machines (defaults to `1024`)
 - `NUM_CPUS` - Allocated number of CPUs for each of the machines (defaults to `2`)
 

local-vagrant/Vagrantfile

@@ -116,6 +116,11 @@ Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
       node.vm.provision "shell", inline: @initWorker
 
       # Todo: Not really nice, but couldn't find any better way to provision one of the managers at "the end" of the process
+      # Todo: This ugly hack is actually the main reason why this solution is not really nice and a combination of
+      #   - vagrant & bash
+      #   - vagrant & ansible
+      # might be the better and more stable approach.
+
       # Any hint welcome how to improve this ...
       if NUM_OF_WORKERS == workerNumber
         node.vm.provision :host_shell do |host_shell|

local-vagrant/config.yml

@@ -1,4 +1,4 @@
-NUM_OF_MANAGERS: 1
-NUM_OF_WORKERS: 3
+NUM_OF_MANAGERS: 3
+NUM_OF_WORKERS: 2
 MEMORY: 1024
 NUM_CPUS: 2