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

     1  <!--[metadata]>
     2  +++
     3  title = "Add nodes to the swarm"
     4  description = "Add nodes to the swarm"
     5  keywords = ["tutorial, cluster management, swarm"]
     6  [menu.main]
     7  identifier="add-nodes"
     8  parent="swarm-tutorial"
     9  weight=13
    10  +++
    11  <![end-metadata]-->
    12  
    13  # Add nodes to the swarm
    14  
    15  Once you've [created a swarm](create-swarm.md) with a manager node, you're ready
    16  to add worker nodes.
    17  
    18  1. Open a terminal and ssh into the machine where you want to run a worker node.
    19  This tutorial uses the name `worker1`.
    20  
    21  2. Run the command produced by the `docker swarm init` output from the
    22  [Create a swarm](create-swarm.md) tutorial step to create a worker node joined to the existing swarm:
    23  
    24      ```bash
    25      $ docker swarm join \
    26        --token  SWMTKN-1-49nj1cmql0jkz5s954yi3oex3nedyz0fb0xx14ie39trti4wxv-8vxv8rssmk743ojnwacrr2e7c \
    27        192.168.99.100:2377
    28  
    29      This node joined a swarm as a worker.
    30      ```
    31  
    32      If you don't have the command available, you can run the following command
    33      on a manager node to retrieve the join command for a worker:
    34  
    35      ```bash
    36      $ docker swarm join-token worker
    37  
    38      To add a worker to this swarm, run the following command:
    39  
    40          docker swarm join \
    41          --token SWMTKN-1-49nj1cmql0jkz5s954yi3oex3nedyz0fb0xx14ie39trti4wxv-8vxv8rssmk743ojnwacrr2e7c \
    42          192.168.99.100:2377
    43      ```
    44  
    45  3. Open a terminal and ssh into the machine where you want to run a second
    46  worker node. This tutorial uses the name `worker2`.
    47  
    48  4. Run the command produced by the `docker swarm init` output from the
    49  [Create a swarm](create-swarm.md) tutorial step to create a second worker node
    50  joined to the existing swarm:
    51  
    52      ```bash
    53      $ docker swarm join \
    54        --token SWMTKN-1-49nj1cmql0jkz5s954yi3oex3nedyz0fb0xx14ie39trti4wxv-8vxv8rssmk743ojnwacrr2e7c \
    55        192.168.99.100:2377
    56  
    57      This node joined a swarm as a worker.
    58      ```
    59  
    60  5. Open a terminal and ssh into the machine where the manager node runs and run
    61  the `docker node ls` command to see the worker nodes:
    62  
    63      ```bash
    64      ID                           HOSTNAME  STATUS  AVAILABILITY  MANAGER STATUS
    65      03g1y59jwfg7cf99w4lt0f662    worker2   Ready   Active
    66      9j68exjopxe7wfl6yuxml7a7j    worker1   Ready   Active
    67      dxn1zf6l61qsb1josjja83ngz *  manager1  Ready   Active        Leader
    68      ```
    69  
    70      The `MANAGER` column identifies the manager nodes in the swarm. The empty
    71      status in this column for `worker1` and `worker2` identifies them as worker nodes.
    72  
    73      Swarm management commands like `docker node ls` only work on manager nodes.
    74  
    75  
    76  ## What's next?
    77  
    78  Now your swarm consists of a manager and two worker nodes. In the next step of
    79  the tutorial, you [deploy a service](deploy-service.md) to the swarm.