swoldanski/shepherd

Shepherd

镜像概述

Shepherd是一个Docker Swarm服务，用于在服务的基础镜像更新时自动触发服务更新，无需手动操作即可维持服务镜像的最新状态。

核心功能

• 自动检测服务基础镜像的更新并触发服务更新
• 支持自定义更新检查间隔（默认5分钟）
• 可通过黑名单排除不需要自动更新的服务
• 支持私有镜像仓库的认证配置

使用场景

• Docker Swarm集群中需要自动更新服务镜像的场景
• 持续集成/持续部署（CI/CD）流程中，镜像构建完成后自动更新线上服务
• 保持集群内服务镜像版本一致，减少手动维护成本

配置说明

基础部署

bash
docker service create --name shepherd \
                      --replicas 1 \
                      --constraint "node.role==manager" \
                      --mount type=bind,source=/var/run/docker.sock,target=/var/run/docker.sock,ro \
                      mazzolino/shepherd

自定义配置

• 调整更新间隔：通过SLEEP_TIME变量设置（单位支持m/minutes、h/hours等）
• 排除服务：通过BLACKLIST_SERVICES变量设置需要排除的服务名称（空格分隔）
• 私有仓库认证：设置REGISTRY_HOST、REGISTRY_USERNAME、REGISTRY_PASSWORD变量

示例（带自定义配置）：

bash
docker service create --name shepherd \
                      --constraint "node.role==manager" \
                      --env SLEEP_TIME="5m" \
                      --env BLACKLIST_SERVICES="shepherd my-other-service" \
                      --env REGISTRY_HOST=myreg.azurecr.io \
                      --env REGISTRY_USERNAME=myreg \
                      --env REGISTRY_PASSWORD=passwordforprivateregistry \
                      --mount type=bind,source=/var/run/docker.sock,target=/var/run/docker.sock,ro \
                      mazzolino/shepherd

工作原理

Shepherd通过移除服务镜像的当前摘要来触发更新，Docker会自动解析镜像标签、检查仓库中的新版本，并按照Swarm的滚动更新策略更新运行中的容器任务，确保服务更新过程中无明显 downtime（对于复制型服务）。 ===END===