直接复用docker-compose.yml迁移到Swarm关键在于补全deploy块并确保version≥"3.8"，需显式声明overlay网络、移除container_name、用服务名替代硬编码host、以configs/secrets替代明文挂载，并通过docker stack deploy部署。
直接复用 docker-compose.yml 文件就能迁移到 Swarm，关键在 deploy 块的写法是否符合 Swarm 要求。Compose 本地运行时 ignore 的 deploy 配置，在 Stack 部署时会被 Swarm 解析并生效——迁移不是重写，而是补全和校准。
确认 Compose 文件版本兼容 Swarm
必须使用 version "3.8" 及以上（推荐 "3.9"），低版本如 "2.x" 不支持 deploy、configs、secrets 等 Swarm 必需字段：
- 检查当前文件开头：version: "3.9"（非 "2.4" 或 "3.0"）
- 若原文件是 v2，需升级 services 下的语法：例如 container_name 不被 Swarm 支持，应移除；depends_on 不控制启动顺序，改用 healthcheck + restart_policy 配合依赖服务就绪逻辑
- volumes 和 networks 定义需显式声明 driver: overlay（Swarm 默认网络类型），bridge 类型仅限本地测试
补全 deploy 块：从“运行容器”转向“管理服务”
deploy 不是可选项，而是 Swarm 中服务生命周期的控制中枢。每个 service 下都应包含最小可用配置：
- replicas：指定实例数（如 replicas: 3），替代 compose up -d --scale web=3 的手动操作
- placement：约束调度，例如只在 worker 节点运行：placement: { constraints: ["node.role==worker"] }
-
resources：设置内存/CPU 限制，防止节点过载：
resources:
limits:
memory: 512M
cpus: '0.5' -
update_config：启用滚动更新，避免停机：
update_config:
parallelism: 1
delay: 10s
failure_action: rollback
替换本地机制为 Swarm 原生能力
很多开发时靠脚本或约定实现的功能，Swarm 已内置，无需保留旧逻辑：
- 服务发现：删掉所有硬编码的 host（如 database:5432），改用服务名（database:5432）——Swarm DNS 自动解析
- 配置与密钥：用 configs/secrets 替代 volume 挂载明文文件，例如：
configs:
- db-config
secrets:
- db-password
并在顶层定义 configs & secrets 块，通过 docker config create / docker secret create 注入 - 健康检查：healthcheck 必须定义，Swarm 依赖它判断实例是否就绪，否则滚动更新可能失败
部署与验证：一条命令完成集群上线
不再执行 docker-compose up，而是用 stack 命令触发集群编排：
- 确保已初始化 Swarm：docker swarm init（单节点测试）或加入多节点集群
- 部署命令：docker stack deploy -c docker-compose.yml myapp
- 验证服务状态：docker service ls（看 REPLICAS 是否达到预期）、docker service logs myapp_web（查启动日志）
- 测试服务发现：进入某容器执行 ping database，应能解析到虚拟 IP；curl http://myapp_web:80 应返回响应
