b01t/swarm-glue

swarm-glue 镜像文档

镜像概述

swarm-glue 是一个专为Docker Swarm集群设计的容器化工具，旨在实现Swarm集群在不同网络环境之间的无缝迁移。它通过自动化处理网络配置同步、节点重新加入、服务重新部署等关键流程，解决了Swarm集群跨网络环境迁移时的复杂配置问题，确保集群状态和服务可用性在迁移过程中不受影响。

核心功能和特性

• 网络配置迁移：自动同步Swarm集群的网络配置（包括overlay网络、桥接网络等）至目标网络环境
• 节点无缝过渡：支持Swarm节点在新网络环境下重新加入集群，保持节点身份和角色
• 服务状态保持：迁移过程中保留服务配置、副本数、资源限制等关键参数
• 数据持久化支持：兼容Docker volumes和bind mounts，确保数据在迁移过程中不丢失
• 轻量级设计：基于Alpine Linux构建，镜像体积小，资源占用低

使用场景和适用范围

• 企业网络架构调整：当企业内部网络规划变更（如网段调整、VLAN重构）时迁移Swarm集群
• 云服务提供商迁移：从一个云平台（如AWS）迁移Swarm集群至另一个云平台（如Azure）
• 数据中心搬迁：物理或虚拟数据中心迁移时保持Swarm集群服务连续性
• 多环境测试：在开发、测试、生产环境之间迁移Swarm集群进行验证

使用方法和配置说明

前提条件

• 源Swarm集群和目标网络环境均已配置Docker Engine（版本19.03+）
• 迁移执行节点需同时能访问源Swarm管理节点和目标网络环境
• 目标网络需开放Docker Swarm所需端口（2377/tcp, 7946/tcp/udp, 4789/udp）

环境变量配置

Docker Run 示例

bash
docker run -d \
  --name swarm-glue \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /path/to/certs:/certs \
  -e SOURCE_MANAGER="192.168.1.100:2377" \
  -e TARGET_NETWORK="10.10.0.0/24" \
  -e MIGRATE_VOLUMES="true" \
  docker.xuanyuan.run/b01t/swarm-glue:latest

Docker Compose 配置示例

yaml
version: '3.8'
services:
  swarm-glue:
    image: docker.xuanyuan.run/b01t/swarm-glue:latest
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./certs:/certs
    environment:
      - SOURCE_MANAGER=192.168.1.100:2377
      - TARGET_NETWORK=10.10.0.0/24
      - DOCKER_CERT_PATH=/certs
      - REDEPLOY_SERVICES=true
    restart: on-failure

迁移流程说明

1. 初始化连接：容器启动后首先验证与源Swarm管理节点的连接
2. 配置备份：导出源集群的网络配置、服务定义、节点信息等关键数据
3. 网络准备：在目标网络环境中创建匹配的网络结构
4. 节点迁移：引导Swarm节点加入新网络环境
5. 服务重建：基于备份配置在新集群中重新部署服务
6. 验证完成：检查服务健康状态和网络连通性，输出迁移报告

注意事项

• 迁移过程中建议暂停非关键服务，避免数据一致性问题
• 确保目标网络环境资源（CPU、内存、存储）满足源集群需求
• 迁移前建议备份Swarm集群状态（可使用docker swarm inspect导出）
• 对于大规模集群（>50节点），建议分批次迁移以减少风险