flopon/swarmconstraint

Swarmconstraint

监控Docker Swarm中指定节点的可用性，并通过调整节点标签响应状态变化，优化服务调度约束。

背景

Docker Swarm的放置约束为“硬约束”：若所有满足服务约束的节点宕机，服务将停止运行，且需至少一个节点满足约束才能重新调度。

核心功能

• 实时监控Docker Swarm节点的可用性状态；
• 根据监控节点的状态变化，自动启用/禁用目标节点的指定标签；
• 支持命令行参数或JSON配置文件两种设置方式。

使用场景

适用于跨多数据中心部署Docker Swarm的场景：希望服务优先在某数据中心运行，当该中心节点不可用时，自动调整标签让服务可在其他数据中心调度，保障服务连续性。

配置说明

参数说明

命令行参数（除prefix外均可多次使用）：

• --watch：需监控可用性的节点；
• --label：需调整的节点标签；
• --toggle：需修改标签的目标节点；
• --prefix：禁用标签时添加的前缀（仅允许一次）；
• 可指定JSON配置文件路径替代命令行参数。

配置文件示例（JSON格式）：

json
{
  "watch": ["node1", "node4"],
  "toggle": ["node2"],
  "label": ["secondary"],
  "prefix": "disable"
}

部署示例

Docker Run命令

需挂载Docker Socket以访问Swarm集群信息：

bash
docker run -d \
  --name swarmconstraint \
  --volume /var/run/docker.sock:/var/run/docker.sock \
  flopon/swarmconstraint \
  --watch node1 --watch node4 --label secondary --toggle node2 --prefix disabled

Docker Compose配置

yaml
version: '3.8'
services:
  swarmconstraint:
    image: flopon/swarmconstraint
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    command: ["--watch", "node1", "--watch", "node4", "--label", "secondary", "--toggle", "node2", "--prefix", "disabled"]
    restart: unless-stopped