github.com/portworx/docker@v1.12.1/docs/swarm/swarm-tutorial/index.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "Set up for the tutorial"
     4  description = "Getting Started tutorial for Docker Engine swarm mode"
     5  keywords = ["tutorial, cluster management, swarm mode"]
     6  [menu.main]
     7  identifier="tutorial-setup"
     8  parent="swarm-tutorial"
     9  weight=11
    10  +++
    11  <![end-metadata]-->
    12  
    13  # Getting started with swarm mode
    14  
    15  This tutorial introduces you to the features of Docker Engine Swarm mode. You
    16  may want to familiarize yourself with the [key concepts](../key-concepts.md)
    17  before you begin.
    18  
    19  The tutorial guides you through the following activities:
    20  
    21  * initializing a cluster of Docker Engines in swarm mode
    22  * adding nodes to the swarm
    23  * deploying application services to the swarm
    24  * managing the swarm once you have everything running
    25  
    26  This tutorial uses Docker Engine CLI commands entered on the command line of a
    27  terminal window. You should be able to install Docker on networked machines and
    28  be comfortable running commands in the shell of your choice.
    29  
    30  If you’re brand new to Docker, see [About Docker Engine](../../index.md).
    31  
    32  ## Set up
    33  
    34  To run this tutorial, you need the following:
    35  
    36  * [three networked host machines](#three-networked-host-machines)
    37  * [Docker Engine 1.12 or later installed](#docker-engine-1-12-or-later)
    38  * [the IP address of the manager machine](#the-ip-address-of-the-manager-machine)
    39  * [open ports between the hosts](#open-ports-between-the-hosts)
    40  
    41  ### Three networked host machines
    42  
    43  The tutorial uses three networked host machines as nodes in the swarm. These can
    44  be virtual machines on your PC, in a data center, or on a cloud service
    45  provider. This tutorial uses the following machine names:
    46  
    47  * manager1
    48  * worker1
    49  * worker2
    50  
    51  ###  Docker Engine 1.12 or later
    52  
    53  To use swarm mode, you must [install Docker Engine](../../installation/index.md)
    54  on each one of the host machines. Alternatively, install the latest Docker for
    55  Mac or Docker for Windows.
    56  
    57  >**Note**: Docker for Mac and Docker for Windows let you use single-node
    58  features of swarm mode, like creating a swarm and creating a service. Multi-node
    59  features like joining additional nodes and scaling a service are not available.
    60  
    61  Verify that the Docker Engine daemon is running on each of the machines.
    62  
    63  ### The IP address of the manager machine
    64  
    65  The IP address must be assigned to an a network interface available to the host
    66  operating system. All nodes in the swarm must be able to access the manager at the IP address.
    67  
    68  Because other nodes contact the manager node on its IP address, you should use a
    69  fixed IP address.
    70  
    71  >**Tip**: You can run `ifconfig` on Linux or Mac OS X to see a list of the
    72  available network interfaces.
    73  
    74  The tutorial uses `manager1` : `192.168.99.100`.
    75  
    76  ### Open ports between the hosts
    77  
    78  * **TCP port 2377** for cluster management communications
    79  * **TCP** and **UDP port 7946** for communication among nodes
    80  * **TCP** and **UDP port 4789** for overlay network traffic
    81  
    82  ## What's next?
    83  
    84  After you have set up your environment, you're ready to [create a swarm](create-swarm.md).