Docker Swarm按实例索引将应用部署到对应节点的实现方案

报错原因 #

Docker Swarm 的 placement.constraints 字段不支持 Go 模板变量（如 {{.Task.Slot}}），只有 hostname、volume 路径等少数字段支持模板渲染，直接将 node{{.Task.Slot}} 写入约束会被判定为无效值，导致报错。

可行解决方案 #

方案1：节点标签 + 独立服务（适合实例数较少的场景）

给每个目标节点添加对应标签，然后为每个实例创建独立服务，通过标签约束指定部署节点。

1. 给节点打标签（替换为你的实际节点名）：

docker node update --label-add app-slot=1 node1
docker node update --label-add app-slot=2 node2
docker node update --label-add app-slot=3 node3
docker node update --label-add app-slot=4 node4
docker node update --label-add app-slot=5 node5

2. 修改 docker-compose.yml，每个实例对应一个服务：

version: "3.8"

services:
  app1:
    image: app:latest
    hostname: "app1"
    networks:
      - app-net
    volumes:
      - "/data/shared/app1/config:/app/config"
    deploy:
      replicas: 1
      update_config:
        parallelism: 1
        delay: 10s
      restart_policy:
        condition: any
      placement:
        constraints:
          - "node.labels.app-slot==1"

  app2:
    image: app:latest
    hostname: "app2"
    networks:
      - app-net
    volumes:
      - "/data/shared/app2/config:/app/config"
    deploy:
      replicas: 1
      update_config:
        parallelism: 1
        delay: 10s
      restart_policy:
        condition: any
      placement:
        constraints:
          - "node.labels.app-slot==2"

  # 依次添加 app3、app4、app5，结构与上述一致
networks:
  app-net:
    driver: overlay

方案2：脚本生成 compose 文件（适合实例数较多的场景）

通过脚本自动生成包含 N 个独立服务的 compose 文件，避免手动重复编写。

1. 创建生成脚本 generate-compose.sh：

#!/bin/bash

# 定义实例数量
INSTANCE_COUNT=5

# 写入基础配置
cat << EOF > docker-compose-generated.yml
version: "3.8"

services:
EOF

# 循环生成每个服务的配置
for i in $(seq 1 $INSTANCE_COUNT); do
cat << EOF >> docker-compose-generated.yml
  app$i:
    image: app:latest
    hostname: "app$i"
    networks:
      - app-net
    volumes:
      - "/data/shared/app$i/config:/app/config"
    deploy:
      replicas: 1
      update_config:
        parallelism: 1
        delay: 10s
      restart_policy:
        condition: any
      placement:
        constraints:
          - "node.hostname==node$i"
EOF
done

# 添加网络配置
cat << EOF >> docker-compose-generated.yml
networks:
  app-net:
    driver: overlay
EOF

2. 执行脚本并部署：

chmod +x generate-compose.sh
./generate-compose.sh
docker stack deploy -c docker-compose-generated.yml app-stack

方案3：全局服务 + 节点标签（适合动态调整节点数的场景）

如果允许每个节点对应一个实例，且实例配置可通过节点标识区分，可使用全局服务配合节点标签实现自动部署。

1. 给目标节点添加统一标签：

docker node update --label-add app-target=true node1
docker node update --label-add app-target=true node2
# 给所有需要部署实例的节点添加该标签

2. 使用全局服务配置：

version: "3.8"

services:
  app:
    image: app:latest
    hostname: "app{{.Node.Hostname}}"
    environment:
      - INSTANCE_ID={{.Node.Hostname}}
    networks:
      - app-net
    volumes:
      - "/data/shared/{{.Node.Hostname}}/config:/app/config"
    deploy:
      mode: global
      placement:
        constraints:
          - "node.labels.app-target==true"
      update_config:
        parallelism: 1
        delay: 10s
      restart_policy:
        condition: any

networks:
  app-net:
    driver: overlay

这种方式下，每个带 app-target=true 标签的节点会自动部署一个实例，实例的配置目录与节点主机名绑定，无需手动指定实例编号。

内容的提问来源于stack exchange，提问作者Enissay