flsi/container-update

Docker容器更新工具

本工具灵感来源于Watchtower项目（https://github.com/containrrr/watchtower%EF%BC%89%EF%BC%8C%E7%94%A8%E4%BA%8E%E7%AE%80%E5%8C%96Docker%E5%AE%B9%E5%99%A8%E7%9A%84%E6%9B%B4%E6%96%B0%E7%AE%A1%E7%90%86%E6%B5%81%E7%A8%8B%E3%80%82

镜像概述

该工具仅支持Docker Hub（docker.io）的公开镜像，采用***方式访问 registry，默认监听端口为8225。

核心功能

• 检查容器是否存在更新（返回IsStale状态标识）
• 从本地或Docker Hub拉取最新镜像
• 通过API接口更新指定容器
• 提供状态查询、镜像拉取、容器更新的标准化API

使用场景

• 需要定期或手动更新Docker容器的场景
• 管理多容器环境，希望简化更新操作的用户
• 需通过API集成容器更新功能到现有系统的场景

配置说明

部署示例

bash
docker run --name=container-update \
  --net=controls \
  --log-opt max-size=30m \
  --restart=unless-stopped \
  -l com.flexlink.container-update=true \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -it -p 8225:8225 \
  -d flsi/container-update:latest

参数说明：

• --net=controls：指定容器所属网络（可根据实际需求调整）
• --log-opt max-size=30m：限制日志文件最大大小
• --restart=unless-stopped：容器退出时自动重启（手动停止除外）
• -v /var/run/docker.sock:/var/run/docker.sock：挂载Docker守护进程套接字，实现与Docker引擎的交互
• -p 8225:8225：将容器端口映射到主机端口

API接口

1. 获取容器状态
   [GET] /v1/status

   • 返回：200（包含容器列表及IsStale状态）；404（错误信息）

2. 拉取新镜像
   [POST] /v1/fetch

   • 功能：在本地和Docker Hub查找最新镜像
   • 返回：200（"ok"）；404（错误信息）

3. 更新指定容器
   [POST] /v1/update?name={your_container}

   • 要求：容器名称需以"/"开头（例如："/registry"）
   • 返回：200（"ok"）；404（错误信息）

构建说明

需使用Golang 1.10及以上版本编译：

bash
GOOS=linux GOARCH=amd64 go build --ldflags '-s -w -extldflags "-static"' -o container-update