本页内容

  • 前置条件
  • 安装 Docker
  • 配置防火墙
  • 初始化 Swarm Manager
  • 向 Swarm 添加 Worker 节点
  • 在 Docker Swarm 上管理服务
  • 在 Docker Swarm 上扩展服务
  • 在 Docker Swarm 上删除服务
  • 结语

Docker Swarm 是一套构建于 Docker Engine 之上的容器编排系统。它允许你使用多台服务器创建并部署一个由 Docker 节点组成的集群。Docker Swarm 简化了将容器化应用以服务形式进行部署的过程。Docker Swarm 提供了一种简单直接的方式来管理和编排容器。

Docker Swarm 为应用提供了高可用性。在 Docker Swarm 中,你可以在多个被称为 "worker nodes"(工作节点)的节点上运行单个应用或服务。还有一个被称为 "Swarm Manager"(Swarm 管理器)的节点,负责对 Docker Swarm 进行集中式管理和编排。

本教程将向你展示如何在 Debian 11 服务器上搭建 Docker Swarm。你将安装 Docker、配置 UFW(Uncomplicated Firewall)、初始化 "Swarm Manager" 并添加 "Nodes"(节点)。你还将学习使用 Docker Swarm 部署应用的基本方法。

前置条件

要完成本教程,你需要多台 Debian 11 服务器,以及一个具有 sudo/root 管理员权限的非 root 用户。

在本演示中,我们将使用三台 Debian 11 服务器,具体信息如下:

Hostname    IP Address        Used as
-------------------------------------
manager     192.168.5.100     Swarm Manager
node1       192.168.5.120     Node
node2       192.168.5.121     Node

在满足了所有这些先决条件之后,你就可以开始动手了。

安装 Docker

Debian 默认软件源提供了 Docker 的安装包。但是,为了确保你安装的是最新版本的 Docker,你将通过 Docker 官方软件源来安装 Docker。

此外,你必须在所有的 Debian 服务器上都安装 Docker。

在添加软件源之前,运行以下 apt 命令来安装一些基础软件包。当系统提示你确认安装时,输入 Y 并按下 ENTER(回车键)。

sudo apt install apt-transport-https ca-certificates curl gnupg lsb-release -y

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

在安装完基础软件包之后,使用以下命令添加 Docker 软件源的 GPG 密钥。通过该命令,你将新建目录 " /etc/apt/keyrings " 并将 Docker 软件源的 GPG 密钥保存在其中。

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

接下来,使用以下命令为 Debian Linux 系统添加 Docker 软件源。

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

现在,通过以下 apt 命令更新并刷新你的软件包索引。

sudo apt update

你将看到新的 Docker 软件源正在被更新。

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

接下来,使用以下 apt 命令安装 Docker 软件包。系统会要求你确认安装,输入 Y 确认,并按下 ENTER 继续。

sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

安装完 Docker 之后,运行以下命令来启动并启用 ' docker ' 服务。这样 'docker' 就会在系统启动时自动运行。

sudo systemctl start docker
sudo systemctl enable docker

最后,通过以下 systemctl 命令验证 ' docker ' 服务。

sudo systemctl status docker

如果 ' docker ' 服务正在运行,你应该会看到类似下面截图的输出:

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

此外,如果你打算使用非 root 用户来进行部署,你必须将你的用户加入到 ' docker ' 用户组,并允许该用户运行 Docker 容器。

sudo usermod -aG docker user

配置防火墙

如果你要将 Docker Swarm 部署到生产环境,你必须在所有节点之间配置防火墙。在本示例中,你将使用 UFW 作为 Debian 服务器的默认防火墙。

以下是你必须开放才能让 Docker Swarm 正常工作的端口:

  • TCP 端口 2377,用于集群管理通信——如果你部署了多个 Swarm Manager,则会用到此端口。
  • TCP 和 UDP 端口 7946,用于节点之间的通信——适用于 Swarm 环境中的所有节点。
  • UDP 端口 4789,用于 overlay 网络流量。

使用以下 apt 命令在 Debian 系统上安装 UFW。

sudo apt install ufw -y

UFW 安装完成后,运行以下 ' ufw ' 命令来添加 " OpenSSH " 应用配置文件。然后启动并启用 UFW。

在此过程中,系统会要求你确认是否运行并启用 UFW 防火墙。输入 y 确认,并按下 ENTER 继续。

sudo ufw allow "OpenSSH"
sudo ufw enable

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

现在运行以下 ufw 命令,为 Docker Swarm 开放一些端口。

sudo ufw allow 2377/tcp
sudo ufw allow 7946/tcp
sudo ufw allow 7946/udp
sudo ufw allow 4789/udp

最后,通过以下 ufw 命令验证服务器上已启用的 UFW 规则列表。请确保 Docker Swarm 所需的所有端口都已在 UFW 上启用并可用。

sudo ufw status

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

至此,你已安装好 Docker 并配置好 UFW。接下来让我们初始化 Swarm Manager。

初始化 Swarm Manager

Swarm Manager 是 Docker Swarm 部署的核心。它负责管理工作集群(swarm)自身的状态,且对管理器节点的数量没有限制。部署多个 Swarm Manager 将创建一个具备容错能力的环境。

Swarm Manager 是与 docker Engine 集成在一起的集群管理组件。它提供声明式服务模型、服务扩展、服务期望状态、负载均衡以及滚动更新。

在本示例中,你将把一个节点初始化为 Swarm Manager。

要初始化 Swarm Manager,运行以下 docker 命令。在本示例中,Swarm manager 将运行在 IP 地址 192.168.5.30 上。Docker Swarm 环境中容器的网络将是 10.20.0.0/16 。

docker swarm init --advertise-addr 192.168.5.30 --default-addr-pool 10.20.0.0/16

当 Swarm Manager 初始化完成后,你将看到如下输出。同时,你还可以看到用于将节点加入到 Swarm manager 的详细令牌(token)。

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

现在,运行以下 docker 命令来验证 Swarm 模式是否已启用。

docker info

在下面的截图中,你可以看到 Swarm 模式为 " active "(已激活),IP 地址池为 " 10.20.0.0/16 "。此外,Docker Swarm 上当前可用的节点数为 " 1 "。

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

你可以通过下面的 docker 命令验证 Docker Swarm 上的节点列表。你应该会看到当前 Docker Swarm 上只有一个节点,即 Swarm Manager。

docker node ls

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

向 Swarm 添加 Worker 节点

Worker 节点是容器被执行和运行的所在。在 worker 节点上,每台服务器都必须安装 Docker Engine,而且 worker 节点还可以被提升为 Swarm Manager。

要添加一个 worker 节点,你可以使用 "docker swarm join" 命令,后面跟上你在初始化 Swarm Manager 时生成的令牌(token)。

通过下面的 " docker swarm join " 命令,将 ' node1 ' 和 ' node2 ' 服务器都添加到 Docker Swarm 中。你可以将令牌替换为你初始化 Swarm Manager 时生成的令牌。

docker swarm join \
--token SWMTKN-1-5tui5dveqw6n2b0m6suut0w7nf9w0wb5jyvfhmykb4jdehps1j-ag99f7750mmnim6ao5yp0x3s2 \
192.168.5.30:2377

当节点被添加后,你将收到类似 " This node joined a swarm as a worker "(此节点作为 worker 加入了一个 swarm)的输出消息。

以下是在 ' node1 ' 和 ' node2 ' 服务器上你都会看到的输出。

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

此外,如果你丢失了用于加入 worker 节点的 swarm 令牌,你可以使用以下命令查看。

docker swarm join-token worker

最后,回到 " manager "(管理器)服务器,通过下面的 " docker " 命令验证你 Docker Swarm 环境中的节点列表。

docker node ls

在下面的截图中,你可以看到 " node1 " 和 " node2 " 都已添加到 Docker Swarm 中,状态为 " Ready "(就绪),docker engine 版本为 " 20.10.18 "。

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

Docker Swarm 部署已完成,现在你可以将容器化的应用部署到 Swarm 中了。

在 Docker Swarm 上管理服务

Service(服务)是 Docker Swarm 上应用部署的术语。它是你微服务的镜像,可以是一个 HTTP 服务器、数据库服务器,或者是将在你 Docker Swarm 上运行的其他应用。

要在 Docker Swarm 中创建一个服务,你必须指定将要使用的镜像、将要暴露的端口,以及副本(replica)的数量。

在部署好 Docker Swarm 之后,你现在将学习把你的服务部署到 Docker Swarm 的基本操作。

通过如下 "docker service create" 命令创建一个名为 "test-httpd" 的新服务。

在本示例中,你将创建一个副本数为 1、在 Swarm 节点上暴露 "8000" 端口的新服务 "test-httpd"。你将要使用的镜像是 "httpd:alpine"。

docker service create --replicas 1 --name test-httpd -p 8000:80 httpd:alpine

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

一旦 "test-httpd" 服务开始运行,使用以下命令进行验证。你应该会看到 "test-httpd" 服务正在运行,副本数为 1,并暴露了 TCP 端口 8000。

docker service ls

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

现在,运行以下命令查看 "test-httpd" 服务的详细信息。

docker service inspect test-httpd
docker service inspect --pretty test-httpd

在下方你可以看到 "test-httpd" 服务的详细信息,其中包括副本数量、对外端口、你所使用的基础镜像等。

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

你也可以通过如下 "docker service ps" 命令查看 "test-httpd" 服务上正在运行的容器。

docker service ps test-httpd

你可以看到 "test-httpd.1" 容器正运行在 "manager"(管理器)服务器上。

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

现在通过下面的 ufw 命令在所有的服务器上开放 "8000" 端口。

sudo ufw allow 8000/tcp

然后,使用如下 curl 命令验证 "test-httpd" 服务。"192.168.5.30" 是 Swarm Manager 的 IP 地址,而 "test-httpd" 服务运行在 8000 端口上。

curl 192.168.5.30:8000
curl -I 192.168.5.30:8000

你将看到 "test-httpd" 服务的默认 index.html 页面。

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

在 Docker Swarm 上扩展服务

现在你将学习如何在 Docker Swarm 上扩展你的服务。

运行以下命令,将 "test-httpd" 服务扩展到 3 个副本。

docker service scale test-httpd=3

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

现在使用以下命令验证 "test-httpd" 服务上正在运行的容器。你应该会在 "test-http" 服务上看到三个不同的容器,它们分别运行在 manager、node1 和 node2 服务器上。

docker service ps test-httpd

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

最后,运行以下 docker 命令验证 node1 和 node2 服务器上正在运行的容器。你应该会看到名为 "test-httpd.随机名称" 的容器在两台服务器上都在运行。此外,你还可以看到该容器可通过 TCP 端口 8000 访问。

在 node1 上检查容器。

docker ps
curl node1:8000

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

在 node2 上检查容器。

docker ps
curl node2:8000

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

在 Docker Swarm 上删除服务

现在是时候通过删除你部署到 Docker Swarm 上的服务来清理你的环境了。

运行以下命令,从 Docker Swarm 中移除并删除 "test-httpd" 服务。

docker service rm test-httpd

然后,通过下面的 "docker service inspect" 命令验证 "test-httpd" 服务。你应该会看到该服务已被删除。

docker service inspect test-httpd

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

此外,你也可以通过下面的 docker 命令验证,查看你的 Swarm 上正在运行的容器和镜像列表。

你应该会看到容器已被移除,而 httpd:alpine 镜像在所有服务器上都仍然可用。

docker ps
docker images

在 Debian 11 系统上完整搭建 Docker Swarm 集群详细教程

结语

在本教程中,你已经使用三台 Debian 11 服务器部署了 Docker Swarm。你还学习了在 Linux 服务器上安装 Docker Engine 的基础操作,以及在 Debian 系统上配置 UFW 防火墙的基本方法。最后,你还学习了通过 "docker service" 命令将应用部署到 Docker Swarm 的基本操作。

从这里开始,你现在可以将带有全部依赖项的容器化应用部署到 Docker Swarm 中了。你还可以添加更多的 Swarm Manager,以构建你 Docker Swarm 环境的高可用性。