# Swarm集群管理

### 简介

Docker Swarm 是 Docker 的集群管理工具。它将 Docker 主机池转变为单个虚拟 Docker 主机。 Docker Swarm 提供了标准的 Docker API，所有任何已经与 Docker 守护程序通信的工具都可以使用 Swarm 轻松地扩展到多个主机。

支持的工具包括但不限于以下各项：

* Dokku
* Docker Compose
* Docker Machine
* Jenkins

### 原理

如下图所示，swarm 集群由管理节点（manager）和工作节点（work node）构成。

* **swarm mananger**：负责整个集群的管理工作包括集群配置、服务管理等所有跟集群有关的工作。
* **work node**：即图中的 available node，主要负责运行相应的服务来执行任务（task）。

![](/files/eaBGz2jsDYdEWuKVOhhq)

## 使用

以下示例，均以 Docker Machine 和 virtualbox 进行介绍，确保你的主机已安装 virtualbox。

### 1、创建 swarm 集群管理节点（manager）

创建 docker 机器：

```
$ docker-machine create -d virtualbox swarm-manager
```

![](/files/Ina0pdoQLT00cgG1KJf0)

初始化 swarm 集群，进行初始化的这台机器，就是集群的管理节点。

```shell
docker-machine ssh swarm-manager
$ docker swarm init --advertise-addr 192.168.99.107 #这里的 IP 为创建机器时分配的 ip。
```

![](/files/nvhS7VeQYVy8Zg048vEB)

以上输出，证明已经初始化成功。需要把以下这行复制出来，在增加工作节点时会用到：

docker swarm join --token SWMTKN-1-4oogo9qziq768dma0uh3j0z0m5twlm10iynvz7ixza96k6jh9p-ajkb6w7qd06y1e33yrgko64sk 192.168.99.107:2377

### 2、创建 swarm 集群工作节点（worker）

这里直接创建好俩台机器，swarm-worker1 和 swarm-worker2 。

![](/files/1escXp3bKGf5EdyCPlM3)

分别进入两个机器里，指定添加至上一步中创建的集群，这里会用到上一步复制的内容。

![](/files/5Gp7YQVxTEGRK2kAGltu)

以上数据输出说明已经添加成功。

上图中，由于上一步复制的内容比较长，会被自动截断，实际上在图运行的命令如下：

```shell
docker@swarm-worker1:~$ docker swarm join --token SWMTKN-1-4oogo9qziq768dma0uh3j0z0m5twlm10iynvz7ixza96k6jh9p-ajkb6w7qd06y1e33yrgko64sk 192.168.99.107:2377
```

### 3、查看集群信息

进入管理节点，执行：docker info 可以查看当前集群的信息。

```shell
docker info
```

![](/files/co5piEVMUnGXIhoZROtu)

通过画红圈的地方，可以知道当前运行的集群中，有三个节点，其中有一个是管理节点。

### 4、部署服务到集群中

**注意**：跟集群管理有关的任何操作，都是在管理节点上操作的。

以下例子，在一个工作节点上创建一个名为 helloworld 的服务，这里是随机指派给一个工作节点：

```
docker@swarm-manager:~$ docker service create --replicas 1 --name helloworld alpine ping docker.com
```

![](/files/BgrJZ4vlv35nkyRZI77g)

### 5、查看服务部署情况

查看 helloworld 服务运行在哪个节点上，可以看到目前是在 swarm-worker1 节点：

```shell
docker@swarm-manager:~$ docker service ps helloworld
```

![](/files/rPG99l2foeG095ZWvY86)

查看 helloworld 部署的具体信息：

```shell
docker@swarm-manager:~$ docker service inspect --pretty helloworld
```

![](/files/Jcskh9ejxX7KbrFNXVuj)

### 6、扩展集群服务

我们将上述的 helloworld 服务扩展到俩个节点。

```shell
docker@swarm-manager:~$ docker service scale helloworld=2
```

![](/files/BvvYAUf4FGouEHZpRNgV)

可以看到已经从一个节点，扩展到两个节点。

![](/files/JKTGVA2gL5xCDQdwexEy)

### 7、删除服务

```shell
docker@swarm-manager:~$ docker service rm helloworld
```

![](/files/FhevFeTrU7zDB0wPRFPl)

查看是否已删除：

![](/files/GrmK4eVlMfOcTuTuqhQI)

### 8、滚动升级服务

以下实例，我们将介绍 redis 版本如何滚动升级至更高版本。

创建一个 3.0.6 版本的 redis。

```shell
docker@swarm-manager:~$ docker service create --replicas 1 --name redis --update-delay 10s redis:3.0.6
```

![](/files/pxYLjaoCANN6JrssSwph)

滚动升级 redis 。

```shell
docker@swarm-manager:~$ docker service update --image redis:3.0.7 redis
```

![](/files/Ap7fIxAcQUOfrdlcjT8z)

看图可以知道 redis 的版本已经从 3.0.6 升级到了 3.0.7，说明服务已经升级成功。

### 9、停止某个节点接收新的任务

查看所有的节点：

```shell
docker@swarm-manager:~$ docker node ls
```

![](/files/VYIexumYAwIRIBO5Tgxo)

可以看到目前所有的节点都是 Active, 可以接收新的任务分配。

停止节点 swarm-worker1：

![](/files/Scn6jmSqR74wt3A4FtdE)

**注意**：swarm-worker1 状态变为 Drain。不会影响到集群的服务，只是 swarm-worker1 节点不再接收新的任务，集群的负载能力有所下降。

可以通过以下命令重新激活节点：

```shell
docker@swarm-manager:~$  docker node update --availability active swarm-worker1
```

![](/files/t2tOkQYhM9Dm327VRJZX)

## 参考资料

* [第三方博客](https://www.cnblogs.com/lihi9998/p/18893360)
* [官网](https://docs.docker.com/reference/cli/docker/swarm/)
* [容器化的选择讨论](https://www.zhihu.com/question/312917608)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tuonioooo-notebook.gitbook.io/docker/usage/docker-swarm.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.