This is an outdated guide, please find latest version on our main website now!
In this post I’d like to show how quickly one can get up-and-running using Weave with Docker Machine and Docker Swarm. This was made possible with our latest v0.10.0 release, which has many improvements, including the ability to communicate with remote Docker hosts. This guide builds on what was learned from a previous post, where I demonstrated how to use Weave with Docker Machine on a single host.
To follow this guide you will need to obtain the binaries for
If you are using OS X, then you can install these tools with Homebrew, via
brew install docker docker-machine docker-swarm
You will need to download and install VirtualBox manually as well, if you haven’t done it yet. Please be sure to install latest version of Machine (v0.2.0), as there are some bugs in the previous release. You also want to use latest
boot2docker VM image; you will get it if you haven’t used Docker Machine previously on your computer, otherwise you should delete the cached ISO image located in
~/.docker/machine/cache/boot2docker.iso before you proceed.
First, we need a few scripts. To get them, run
git clone https://github.com/errordeveloper/weave-demos cd weave-demos/quartet
Now, we’ll provision a cluster of 3 VMs. The following script will make sure all 3 VMs join the Swarm, and sets up the Weave network and WeaveDNS.
If you’ve followed my previous guide, you’ll need to clear the VMs you’ve previously created. Check the output of
docker-machine ls, and delete them with
docker-machine rm -f <vm-name>.
Next, we need to make sure the right environment variables are set to talk to the Swarm master.
eval `docker-machine env --swarm dev-1`
Although Weave 0.10.0 can interact with remote Docker hosts, it doesn’t yet work out of the box. So, I created a small script that does the right thing. Our “Hello, Weave!” server can be launched like this:
./scripts/weave-run-on-swarm.sh 10.5.2.1/24 --hostname=hola.weave.local errordeveloper/hello-weave
And our client container can be launched in a very similar way:
./scripts/weave-run-on-swarm.sh 10.5.2.2/24 --hostname=test.weave.local --name=test-client --tty --interactive errordeveloper/curl
Now, let’s test it out:
> docker attach test-client test:/# ping -c 3 hola.weave.local PING hola.weave.local (10.5.2.1): 56 data bytes 64 bytes from 10.5.2.1: seq=0 ttl=64 time=0.187 ms 64 bytes from 10.5.2.1: seq=1 ttl=64 time=0.119 ms 64 bytes from 10.5.2.1: seq=2 ttl=64 time=0.057 ms --- hola.weave.local ping statistics --- 3 packets transmitted, 3 packets received, 0% packet loss round-trip min/avg/max = 0.057/0.121/0.187 ms test:/# curl hola.weave.local:5000 Hello, Weave! test:/#
You can easily move the entire setup to run on a public cloud, with any of the many providers already available with Docker Machine.
For example, you can follow part of the Azure guide (setup steps 1, 2, and 3), and then set
DOCKER_MACHINE_DRIVER like this:
export DOCKER_MACHINE_DRIVER=" --driver azure --azure-subscription-id=SubscriptionID --azure-subscription-cert=mycert.pem "
Clean-up your local VMs, and re-run the cluster setup.
docker-machine rm -f dev-1 dev-2 dev-3 ./scripts/setup-swarm-only-cluster.sh eval `docker-machine env --swarm dev-1` ../scripts/weave-run-on-swarm.sh ... # what do you want to run?
Next, I am planning to post a full guide on how to use Weave with Machine, Swarm and Compose altogether.