moby/docs/swarm/swarm-tutorial/index.md

Getting started with swarm mode

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:

• initializing a cluster of Docker Engines in swarm mode
• adding nodes to the swarm
• deploying application services to the swarm
• managing the swarm once you have everything running

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.

Set up

To run this tutorial, you need the following:

• three networked host machines
• Docker Engine 1.12 or later installed
• the IP address of the manager machine
• open ports between the hosts

Three networked host machines

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:

• manager1
• worker1
• worker2

Docker Engine 1.12 or later

To use swarm mode, you must install Docker Engine on each one of the host machines. Alternatively, install the latest Docker for Mac or Docker for Windows.

Note: Docker for Mac and Docker for Windows let you use single-node features of swarm mode, like creating a swarm and creating a service. Multi-node features like joining additional nodes and scaling a service are not available.

Verify that the Docker Engine daemon is running on each of the machines.

The IP address of the manager machine

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 ifconfig on Linux or Mac OS X to see a list of the available network interfaces.

The tutorial uses manager1 : 192.168.99.100.

Open ports between the hosts

• TCP port 2377 for cluster management communications
• TCP and UDP port 7946 for communication among nodes
• TCP and UDP port 4789 for overlay network traffic

What's next?

After you have set up your environment, you're ready to create a swarm.