github.com/kobeld/docker@v1.12.0-rc1/docs/swarm/swarm-tutorial/index.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "Set up for the tutorial"
     4  description = "Getting Started tutorial for Docker Swarm"
     5  keywords = ["tutorial, cluster management, swarm"]
     6  [menu.main]
     7  identifier="tutorial-setup"
     8  parent="swarm-tutorial"
     9  weight=11
    10  advisory = "rc"
    11  +++
    12  <![end-metadata]-->
    13  
    14  # Getting Started with Docker Swarm
    15  
    16  This tutorial introduces you to the key features of Docker Swarm. It guides you
    17  through the following activities:
    18  
    19  * initializing a cluster of Docker Engines called a Swarm
    20  * adding nodes to the Swarm
    21  * deploying application services to the Swarm
    22  * managing the Swarm once you have everything running
    23  
    24  This tutorial uses Docker Engine CLI commands entered on the command line of a
    25  terminal window. You should be able to install Docker on networked machines and
    26  be comfortable running commands in the shell of your choice.
    27  
    28  If you’re brand new to Docker, see [About Docker Engine](../../index.md).
    29  
    30  ## Set up
    31  To run this tutorial, you need the following:
    32  
    33  * [three networked host machines](#three-networked-host-machines)
    34  * [Docker Engine 1.12 or later installed](#docker-engine-1-12-or-later)
    35  * [the IP address of the manager machine](#the-ip-address-of-the-manager-machine)
    36  * [open ports between the hosts](#open-ports-between-the-hosts)
    37  
    38  ### Three networked host machines
    39  
    40  The tutorial uses three networked host machines as nodes in the Swarm. These can
    41  be virtual machines on your PC, in a data center, or on a cloud service
    42  provider. This tutorial uses the following machine names:
    43  
    44  * manager1
    45  * worker1
    46  * worker2
    47  
    48  ###  Docker Engine 1.12 or later
    49  
    50  You must install Docker Engine on each one of the host machines. To use this
    51  version of Swarm, install the Docker Engine `v1.12.0-rc1` or later from the
    52  [Docker releases GitHub repository](https://github.com/docker/docker/releases).
    53  Alternatively, install the latest Docker for Mac or Docker for Windows Beta.
    54  
    55  Verify that the Docker Engine daemon is running on each of the machines.
    56  
    57  <!-- See the following options to install:
    58  
    59  * [Install Docker Engine](../../installation/index.md).
    60  
    61  * [Example: Manual install on cloud provider](../../installation/cloud/cloud-ex-aws.md).
    62  -->
    63  
    64  ### The IP address of the manager machine
    65  
    66  The IP address must be assigned to an a network interface available to the host
    67  operating system. All nodes in the Swarm must be able to access the manager at the IP address.
    68  
    69  >**Tip**: You can run `ifconfig` on Linux or Mac OSX to see a list of the
    70  available network interfaces.
    71  
    72  The tutorial uses `manager1` : `192.168.99.100`.
    73  
    74  ### Open ports between the hosts
    75  
    76  * **TCP port 2377** for cluster management communications
    77  * **TCP** and **UDP port 7946** for communication among nodes
    78  * **TCP** and **UDP port 4789** for overlay network traffic
    79  
    80  >**Tip**: Docker recommends that every node in the cluster be on the same layer
    81  3 (IP) subnet with all traffic permitted between nodes.
    82  
    83  ## What's next?
    84  
    85  After you have set up your environment, you're ready to [create a Swarm](create-swarm.md).
    86  
    87  <p style="margin-bottom:300px">&nbsp;</p>