Swarm 集群管理（超详细）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

在现代软件开发中，随着应用规模的扩大和用户需求的多样化，单一服务器的性能和稳定性已难以满足实际场景。如何高效管理分布式环境下的多个节点，实现资源的灵活调度与负载均衡，成为开发者必须面对的核心问题。Swarm 集群管理正是为解决这一挑战而生的技术方案。它通过容器化技术将多台机器整合为统一资源池，为开发者提供了一套轻量、易用的集群管理工具。无论是初创团队搭建微服务架构，还是企业优化现有系统，掌握 Swarm 集群管理都将显著提升开发效率与系统可靠性。

本文将从基础概念入手，逐步解析 Swarm 的核心原理、部署流程及实际应用场景，帮助读者构建完整的知识体系。

一、Swarm 集群管理的核心概念

1.1 什么是 Swarm？

Swarm 是 Docker 官方提供的容器编排引擎，其本质是一个去中心化集群管理系统。它允许开发者将多台 Docker 主机（物理机或虚拟机）组合成一个逻辑上的“超级计算机”，通过统一的 API 接口实现服务的部署、扩展和维护。

类比理解：
可以将 Swarm 想象为一支交响乐团。乐团指挥（Swarm Manager）负责协调所有乐手（Worker 节点），确保每个声部（服务实例）在正确的时间以合适的方式演奏（执行任务）。即使某个乐手临时缺席，指挥也能快速调整其他成员补位，保持整体演出流畅。

1.2 核心组件解析

Swarm 的架构包含以下关键角色：

• Manager 节点：负责集群的全局决策，如服务调度、任务分配、状态同步等。
• Worker 节点：执行具体任务，运行容器化服务。
• 任务（Task）：Swarm 中的最小执行单元，每个任务对应一个容器实例。

表格说明：
| 角色 | 功能描述 |
|---------------|--------------------------------------------------------------------------|
| Manager 节点 | 管理集群配置、服务状态及任务分配 |
| Worker 节点 | 执行分配的任务，运行容器并提供计算资源 |
| Task | 单个容器实例，由 Manager 分配到 Worker 上运行 |

1.3 核心优势

• 简单易用：基于 Docker 原生命令，学习曲线平缓。
• 弹性扩展：动态增减节点，支持水平扩容与自动故障转移。
• 服务发现：内置 DNS 服务，自动注册服务名称与 IP 地址映射。
• 滚动更新：支持渐进式部署，确保服务不中断。

二、Swarm 集群的部署与管理

2.1 部署准备工作

2.1.1 环境要求

• 每台节点需安装 Docker Engine 1.12 或更高版本。
• 确保节点间网络互通，且防火墙允许必要端口通信（默认 2377、7946、4789）。

2.1.2 初始化集群

通过以下命令创建 Manager 节点并启动 Swarm：

docker swarm init  

执行后，系统会返回一个加入 Worker 节点的指令，例如：

docker swarm join --token SWMTKN-... <manager-IP>:2377  

2.2 部署示例：Web 应用集群

2.2.1 编写服务定义文件

创建 docker-compose.yml，定义一个简单的 Nginx 服务：

version: '3.8'  
services:  
  web:  
    image: nginx:latest  
    ports:  
      - "80:80"  
    deploy:  
      replicas: 3  
      resources:  
        limits:  
          cpus: "0.5"  
          memory: 256M  

其中 deploy 块用于指定服务在 Swarm 中的部署策略，如副本数、资源限制等。

2.2.2 部署服务

使用 docker stack deploy 命令启动服务栈：

docker stack deploy -c docker-compose.yml my_web_stack  

Swarm 会自动将 3 个 Nginx 容器分布在可用 Worker 节点上，并通过负载均衡对外提供访问。

2.3 集群状态监控

通过以下命令查看集群状态与服务详情：

docker node ls  

docker service ls  

docker service logs my_web_stack_web --follow  

三、高级场景与优化技巧

3.1 服务发现与负载均衡

Swarm 内置 DNS 服务，当服务被创建时会自动分配一个 DNS 名称（如 task.<service-name>.<stack-name>）。其他服务可通过此名称直接调用，无需手动配置 IP 地址。

负载均衡实现：
Swarm 使用 Round-Robin 算法将请求分发到不同副本，开发者可通过 endpoint_mode 参数指定负载均衡模式：

deploy:  
  mode: replicated  
  endpoint_mode: dnsrr  # DNS Round-Robin  

3.2 滚动更新与回滚

更新服务时，Swarm 支持渐进式部署：

docker service update \  
  --image nginx:new_version \  
  --update-parallelism 1 \  
  --update-delay 10s \  
  my_web_stack_web  

若更新失败，可快速回滚到上一个稳定版本：

docker service rollback my_web_stack_web  

3.3 节点故障处理

当 Worker 节点宕机时，Swarm 会自动将任务迁移到其他健康节点。管理员可通过以下命令替换故障节点：

docker node update --availability drain <faulty-node-id>  

docker node rm <faulty-node-id>  

docker swarm join ...  

四、实际案例：电商系统集群搭建

4.1 场景描述

某电商平台需部署一个包含 Web 前端、订单服务和数据库的微服务架构，要求：

• Web 前端支持 1000+ 并发请求
• 订单服务需与数据库强一致
• 整体具备高可用性

4.2 集群设计

1. 节点规划：

   • 2 台 Manager 节点（主从模式）
   • 4 台 Worker 节点（分属不同可用区）

2. 服务配置：

   services:  
     web:  
       image: web-frontend:latest  
       ports:  
         - "80:80"  
       deploy:  
         replicas: 4  
         placement:  
           constraints: [node.role == worker]  # 仅在 Worker 节点运行  
   
     order-service:  
       image: order-service:1.0.0  
       deploy:  
         replicas: 2  
         update_config:  
           parallelism: 1  
   
     database:  
       image: mysql:8.0  
       deploy:  
         replicas: 1  
         placement:  
           max_replicas_per_node: 1  # 每节点最多运行一个实例  
   

4.3 部署与验证

1. 初始化集群并添加 Worker 节点。
2. 使用 docker stack deploy 部署服务栈。
3. 通过 curl 或浏览器访问 Web 端口，观察负载均衡效果。
4. 模拟节点故障，验证任务迁移是否正常。

五、常见问题与解决方案

5.1 节点加入失败

现象：Worker 节点无法通过 docker swarm join 加入集群。
排查步骤：

• 检查防火墙规则是否开放 2377、7946、4789 端口。
• 确认 Manager 节点的 IP 地址与 Worker 节点可达。

5.2 服务副本数未生效

现象：设置 replicas: 3 后实际只运行 1 个容器。
可能原因：

• 资源不足（CPU/内存限制过高）。
• 节点放置约束条件冲突。

5.3 网络通信异常

解决方案：

• 使用 docker network create 显式创建 overlay 网络：

  docker network create -d overlay my_overlay  
  

• 在服务配置中指定网络：

  networks:  
    - my_overlay  
  

结论

通过本文，我们系统地学习了 Swarm 集群管理 的核心概念、部署方法及进阶技巧。从基础的节点管理到复杂的高可用设计，Swarm 凭借其简洁的 API 和强大的功能，成为中小型团队构建分布式系统的首选工具。

对于开发者而言，掌握 Swarm 不仅是应对复杂架构的技术储备，更是提升系统设计能力的关键一步。建议读者通过动手实践，逐步尝试以下进阶操作：

1. 结合 Traefik 实现动态 HTTPS 反向代理。
2. 集成监控工具（如 Prometheus）实现集群状态可视化。
3. 探索自定义健康检查与故障转移策略。

随着经验的积累，Swarm 将帮助开发者从容应对从单节点到大规模集群的全场景挑战。