anuragkh / docker-swarm-sys-seminar

Docker Swarm Demo

This repository contains all the instructions and materials required to run the demo for Docker Swarm. The demo is designed to run on your local MacBook Pro. Some script tweaking might be required to make this run on other platforms.

Installing Docker for Mac

Follow the instructions provided here to install all required Docker Components.

Run

docker ps

on a shell to make sure the installation was successful.

Install VirtualBox

Download and install the latest version of VirtualBox from here.

Create VMs

The script at setup-vms.sh creates 4 VMs for the demo. You need the latest version of VirtualBox for this.

Note: This script will take some time to run, and requires internet connectivity since it downloads a (~38MB) VM image and creates three VMs from the image.

Once the VMs are created, you can check if the docker machines are running:

$ docker-machine ls
NAME      ACTIVE   DRIVER       STATE     URL                         SWARM   DOCKER        ERRORS
agent1    -        virtualbox   Running   tcp://192.168.99.101:2376           v1.12.0-rc2
agent2    -        virtualbox   Running   tcp://192.168.99.102:2376           v1.12.0-rc2
agent3    -        virtualbox   Running   tcp://192.168.99.102:2376           v1.12.0-rc2
manager   -        virtualbox   Running   tcp://192.168.99.100:2376           v1.12.0-rc2

Setup a Docker Swarm

The script at setup-swarm.sh should setup a Docker Swarm for you; it follows the instructions provided here to setup a sandbox environment for trying out Docker Swarm.

You can print out information about your swarm by running

DOCKER_HOST=$(docker-machine ip manager):3376

docker info

The first line instructs your docker cli to connect to the swarm manager, and the second prints out the swarm information.

** Note: There might be some period of time for which docker info shows 0 nodes running; don't worry. Wait for some time and retry since it takes some time for the swarm manager to register the swarm agents.**

Run a simple container

You can run a simple dummy container with the swarm-helloworld.sh script. This should do the following:

• Print information about your swarm:

Containers: 3
 Running: 3
 Paused: 0
 Stopped: 0
Images: 3
Server Version: swarm/1.2.3
Role: primary
Strategy: spread
Filters: health, port, containerslots, dependency, affinity, constraint
Nodes: 3
 agent1: 192.168.99.101:2376
  └ ID: OZKP:FR6W:THMU:MTAR:7Z2N:BOYZ:BD7O:I4WO:E7KF:D6IE:UXW7:CKO7
  └ Status: Healthy
  └ Containers: 1
  └ Reserved CPUs: 0 / 1
  └ Reserved Memory: 0 B / 1.021 GiB
  └ Labels: executiondriver=, kernelversion=4.4.13-boot2docker, operatingsystem=Boot2Docker 1.12.0-rc2 (TCL 7.1); HEAD : 52952ef - Fri Jun 17 21:01:09 UTC 2016, provider=virtualbox, storagedriver=aufs
  └ UpdatedAt: 2016-06-24T18:20:47Z
  └ ServerVersion: 1.12.0-rc2
 agent2: 192.168.99.102:2376
  └ ID: JZ2K:LH2K:KPLI:GN6E:C2NB:TMPS:5QOB:UYHA:7NO6:VBOP:HVUD:DL2J
  └ Status: Healthy
  └ Containers: 1
  └ Reserved CPUs: 0 / 1
  └ Reserved Memory: 0 B / 1.021 GiB
  └ Labels: executiondriver=, kernelversion=4.4.13-boot2docker, operatingsystem=Boot2Docker 1.12.0-rc2 (TCL 7.1); HEAD : 52952ef - Fri Jun 17 21:01:09 UTC 2016, provider=virtualbox, storagedriver=aufs
  └ UpdatedAt: 2016-06-24T18:21:05Z
  └ ServerVersion: 1.12.0-rc2
 agent3: 192.168.99.103:2376
  └ ID: OA3Q:Z6Y4:J2O2:ON33:SAXS:ZWKZ:6CH5:HBTW:3XZI:SQEY:XR5A:BAHV
  └ Status: Healthy
  └ Containers: 1
  └ Reserved CPUs: 0 / 1
  └ Reserved Memory: 0 B / 1.021 GiB
  └ Labels: executiondriver=, kernelversion=4.4.13-boot2docker, operatingsystem=Boot2Docker 1.12.0-rc2 (TCL 7.1); HEAD : 52952ef - Fri Jun 17 21:01:09 UTC 2016, provider=virtualbox, storagedriver=aufs
  └ UpdatedAt: 2016-06-24T18:20:46Z
  └ ServerVersion: 1.12.0-rc2
Plugins:
 Volume:
 Network:
Swarm:
 NodeID:
 IsManager: No
Security Options:
Kernel Version: 4.4.13-boot2docker
Operating System: linux
Architecture: amd64
CPUs: 3
Total Memory: 3.063 GiB
Name: 09f58374a52a
Docker Root Dir:
Debug Mode (client): false
Debug Mode (server): false
WARNING: No kernel memory limit support

• Run a dummy "hello-world" container on your swarm:

Hello from Docker.
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
 $ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker Hub account:
 https://hub.docker.com

For more examples and ideas, visit:
 https://docs.docker.com/engine/userguide/

• List out which container the "hello world" container ran on:

CONTAINER ID        IMAGE               COMMAND                  CREATED                  STATUS                              PORTS               NAMES
a1210cea4120        hello-world         "/hello"                 Less than a second ago   Exited (0) Less than a second ago                       agent1/nostalgic_darwin
f94f855affd4        swarm               "/swarm join --addr=1"   8 minutes ago            Up 8 minutes                        2375/tcp            agent3/elated_jones
f94f855affd4        swarm               "/swarm join --addr=1"   8 minutes ago            Up 8 minutes                        2375/tcp            agent2/boring_northcutt
348e7a0a17a4        swarm               "/swarm join --addr=1"   8 minutes ago            Up 8 minutes                        2375/tcp            agent1/cranky_keller