mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
40baa97ab1
this change improves the instructions for
swarm join-token and swarm init;
- only print the join-token command for workers
instead of for both managers and workers, to
prevent users from copying the wrong command.
An extra line is added to explain how to obtain
the manager token.
- print a message that a token was rotated
sucesfully if '--rotate' is used.
- add some extra white-space before / after
the join commands, to make copy/pasting
easier.
this change also does some refactoring of join-token;
- move flagname-constants together with other constants
- use variables for selected role ("worker" / "manager")
to prevent checking for them multiple times, and to
keep the "worker" / "manager" sting centralized
- add an extra blank line after "join-token" instructions
this makes it easier to copy, and cleans up the
code a tiny bit
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
(cherry picked from commit ebebd41769)
Signed-off-by: Tibor Vass <tibor@docker.com>
89 lines
2.5 KiB
Markdown
89 lines
2.5 KiB
Markdown
<!--[metadata]>
|
|
+++
|
|
title = "Create a swarm"
|
|
description = "Initialize the swarm"
|
|
keywords = ["tutorial, cluster management, swarm mode"]
|
|
[menu.main]
|
|
identifier="initialize-swarm"
|
|
parent="swarm-tutorial"
|
|
weight=12
|
|
+++
|
|
<![end-metadata]-->
|
|
|
|
# Create a swarm
|
|
|
|
After you complete the [tutorial setup](index.md) steps, you're ready
|
|
to create a swarm. Make sure the Docker Engine daemon is started on the host
|
|
machines.
|
|
|
|
1. Open a terminal and ssh into the machine where you want to run your manager
|
|
node. For example, the tutorial uses a machine named `manager1`.
|
|
|
|
2. Run the following command to create a new swarm:
|
|
|
|
```bash
|
|
docker swarm init --advertise-addr <MANAGER-IP>
|
|
```
|
|
|
|
In the tutorial, the following command creates a swarm on the `manager1`
|
|
machine:
|
|
|
|
```bash
|
|
$ docker swarm init --advertise-addr 192.168.99.100
|
|
Swarm initialized: current node (dxn1zf6l61qsb1josjja83ngz) is now a manager.
|
|
|
|
To add a worker to this swarm, run the following command:
|
|
|
|
docker swarm join \
|
|
--token SWMTKN-1-49nj1cmql0jkz5s954yi3oex3nedyz0fb0xx14ie39trti4wxv-8vxv8rssmk743ojnwacrr2e7c \
|
|
192.168.99.100:2377
|
|
|
|
To add a manager to this swarm, run 'docker swarm join-token manager' and follow the instructions.
|
|
```
|
|
|
|
The `--advertise-addr` flag configures the manager node to publish its
|
|
address as `192.168.99.100`. The other nodes in the swarm must be able
|
|
to access the manager at the IP address.
|
|
|
|
The output incudes the commands to join new nodes to the swarm. Nodes will
|
|
join as managers or workers depending on the value for the `--swarm-token`
|
|
flag.
|
|
|
|
2. Run `docker info` to view the current state of the swarm:
|
|
|
|
```bash
|
|
$ docker info
|
|
|
|
Containers: 2
|
|
Running: 0
|
|
Paused: 0
|
|
Stopped: 2
|
|
...snip...
|
|
Swarm: active
|
|
NodeID: dxn1zf6l61qsb1josjja83ngz
|
|
Is Manager: true
|
|
Managers: 1
|
|
Nodes: 1
|
|
...snip...
|
|
```
|
|
|
|
3. Run the `docker node ls` command to view information about nodes:
|
|
|
|
```bash
|
|
$ docker node ls
|
|
|
|
ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS
|
|
dxn1zf6l61qsb1josjja83ngz * manager1 Ready Active Leader
|
|
|
|
```
|
|
|
|
The `*` next to the node id indicates that you're currently connected on
|
|
this node.
|
|
|
|
Docker Engine swarm mode automatically names the node for the machine host
|
|
name. The tutorial covers other columns in later steps.
|
|
|
|
## What's next?
|
|
|
|
In the next section of the tutorial, we'll [add two more nodes](add-nodes.md) to
|
|
the cluster.
|