Advisory: This site contains documentation for the v1.12 release candidate version of Docker Engine. For the Docker Engine v1.11 docs, see https://docs.docker.com/v1.11/. Docker for Mac and Docker for Windows are currently in Beta.
This tutorial introduces you to the features of Docker Engine Swarm mode. You may want to familiarize yourself with the key concepts before you begin.
The tutorial guides you through the following activities:
This tutorial uses Docker Engine CLI commands entered on the command line of a terminal window. You should be able to install Docker on networked machines and be comfortable running commands in the shell of your choice.
If you’re brand new to Docker, see About Docker Engine.
To run this tutorial, you need the following:
The tutorial uses three networked host machines as nodes in the swarm. These can be virtual machines on your PC, in a data center, or on a cloud service provider. This tutorial uses the following machine names:
You must install Docker Engine on each one of the host machines. To use swarm
mode, install the Docker Engine
v1.12.0-rc1 or later from the Docker releases
GitHub repository. Alternatively,
install the latest Docker for Mac or Docker for Windows Beta.
Advisory: Some multi-node features may not work for Docker for Mac Beta and Docker for Windows Beta. We’re working on the multi-node features for GA.
Verify that the Docker Engine daemon is running on each of the machines.
The IP address must be assigned to an a network interface available to the host operating system. All nodes in the swarm must be able to access the manager at the IP address.
Because other nodes contact the manager node on its IP address, you should use a fixed IP address.
Tip: You can run
ifconfigon Linux or Mac OS X to see a list of the available network interfaces.
The tutorial uses
After you have set up your environment, you’re ready to create a swarm.