smcintyre/marshal

Marshal

一个小型容器，用于自动更新Docker Swarm栈内的服务，必须运行在Swarm主节点上。目前已在Docker Engine API 1.30.x版本上测试通过。

核心功能

• 自动检测栈内服务的镜像更新
• 支持配置刷新间隔
• 兼容私有镜像仓库
• 提供简单的部署与配置方式

使用场景

适用于Docker Swarm集群环境中，需要自动更新服务镜像的场景，减少手动更新的操作成本。

配置说明

基础配置

将smcintyre/marshal添加到栈的docker-compose.yml中：

yaml
version: '3'

services:
  my-service:
    # 你的服务配置
  marshal:
    image: smcintyre/marshal:1.3.1
    environment:
      STACK_NAME: 'my-stack'  # 栈名称
      REFRESH_INTERVAL: 30000  # 刷新间隔（毫秒）
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 挂载Docker套接字
    deploy:
      restart_policy:
        condition: any
        delay: 5s
        window: 15s

部署栈：

bash
docker stack deploy -c docker-compose.yml my-stack

服务会在镜像更新时自动重启更新。

私有镜像仓库支持

若需从私有仓库拉取镜像，需挂载主机的Docker配置文件（替换<user>为你的主机用户名）：

yaml
version: '3'

services:
  # 其他服务配置
  marshal:
    # 基础配置
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /home/<user>/.docker/config.json:/config.json  # 挂载私有仓库配置

开发指南

开发环境设置

bash
docker swarm init

运行测试栈

bash
# 启动本地镜像仓库
docker run -d -p 5000:5000 --restart always --name registry registry:2
# 构建、推送测试镜像
docker build -t localhost:5000/testing-marshal --no-cache ./test && docker push localhost:5000/testing-marshal && docker rmi localhost:5000/testing-marshal
# 构建Marshal镜像
docker build -t smcintyre/marshal:1.3.1 .
# 部署测试栈
docker stack deploy -c docker-compose.yml marshal-test
# 重新构建并推送测试镜像（触发更新）
docker build -t localhost:5000/testing-marshal --no-cache ./test && docker push localhost:5000/testing-marshal && docker rmi localhost:5000/testing-marshal
# 查看日志
docker service logs -f marshal-test_marshal
# 清理资源
docker stack rm marshal-test && docker rm -f registry