怎么通过 Docker Compose 实现基于标签的容器集群调度指南-Docker-PHP中文网

docker compose 本身不支持标签调度，仅通过 docker stack deploy 在 swarm 集群中结合 deploy.placement.constraints 才能实现基于节点标签的调度；单机 docker compose up 忽略约束。

怎么通过 docker compose 实现基于标签的容器集群调度指南

Docker Compose 本身不支持基于标签（label-based）的容器调度，它是一个面向单机、声明式编排的工具，所有服务默认在本地 Docker 引擎上启动，不涉及节点选择、资源约束或标签匹配逻辑。真正的标签调度属于集群编排系统（如 Docker Swarm 或 Kubernetes）的能力。

但你可以通过组合使用 Docker Compose + Docker Swarm 模式，在 Swarm 集群中利用 deploy.placement.constraints 基于节点标签实现调度控制。以下是清晰可行的实践路径：

✅ 明确前提：Compose ≠ 调度器，Swarm 才管调度

docker-compose.yml 是配置文件格式，可被 docker compose（CLI v2+）或 docker stack deploy 解析；
只有 docker stack deploy 命令会将 Compose 文件提交给 Swarm manager，并触发调度逻辑；
单用 docker compose up 启动的服务，无论加多少 label，都不会触发跨节点调度。

✅ 在 Swarm 集群中用 Compose 实现标签调度

1. 给 Swarm 节点打标签（Label）

在目标节点（如 worker1）执行：

docker node update --label-add env=prod worker1
docker node update --label-add disk=ssd worker1
docker node update --label-add role=cache worker2

✅ 标签格式为 key=value，支持多组；可通过 docker node inspect <node></node> 查看。

2. 在 docker-compose.yml 中声明调度约束

使用 deploy.placement.constraints 字段（仅 Swarm mode 生效）：

version: "3.8"
services:
  redis-cache:
    image: redis:7-alpine
    deploy:
      placement:
        constraints:
          - node.labels.env == "prod"
          - node.labels.disk == "ssd"
      replicas: 2

  api-server:
    image: myapp/api:v1.2
    deploy:
      placement:
        constraints:
          - node.role == "manager"  # 内置角色也可约束
          - node.labels.role == "backend"

⚠️ 注意：

OpenClaw Docker Setup
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...

下载

constraints 是数组，多个条件是 AND 关系；

node.labels.xxx 访问节点标签，node.role 是 Swarm 内置属性；

replicas 和 placement 必须配合 deploy 块使用，普通 docker compose up 会忽略它们。

3. 部署到 Swarm 集群（关键步骤）

确保已在 manager 节点初始化 Swarm：

docker swarm init --advertise-addr <manager_ip></manager_ip>

然后部署：

docker stack deploy -c docker-compose.yml myapp

✅ 此时 Swarm scheduler 会根据 constraints 匹配带对应标签的节点，并仅在满足条件的节点上启动容器。

4. 验证调度结果

# 查看服务实际运行在哪几个节点
docker service ps myapp_redis-cache

# 查看节点标签是否生效
docker node ls --format "table {{.Hostname}}\t{{.Status}}\t{{.Availability}}\t{{.Labels}}"

❌ 常见误区澄清

不要在 service 级别加 labels: 字段试图做调度
labels: 是容器元数据（用于日志、监控、服务发现），不影响调度位置。
depends_on 不等于调度依赖
它只控制启动顺序，不决定容器部署到哪台机器。
scale 命令（如 docker compose up --scale web=3）不支持标签调度
它只在单机上启动多个副本，仍由本地引擎分配，无节点选择能力。