pier13/docker-puller

Docker Puller 镜像说明

概述

Docker Puller是一个用Go语言编写的轻量工具，用于更新Docker容器至最新镜像版本。它会拉取指定镜像，停止并移除运行该镜像的容器，再用新镜像重新创建并启动容器，同时保留原有容器的环境变量、端口映射、卷和名称等配置。该工具支持命令行直接操作或Web服务触发更新，适用于需要手动控制容器更新时机的场景。

核心功能

1. 容器更新：拉取最新镜像并重建容器，保留原有配置。
2. Web服务触发：启动Web服务器，通过POST请求（带API密钥验证）触发镜像更新。
3. 命令行直接更新：无需启动Web服务，直接通过命令行指定镜像进行更新。
4. 私有仓库认证：支持配置私有Docker仓库的用户名和密码，用于拉取私有镜像。

使用场景

• 需要手动触发容器更新而非自动定期检查的场景（区别于Watchtower的自动轮询）。
• 通过Webhook集成到CI/CD流程中，在镜像构建完成后自动更新容器。
• 管理多个容器，需要统一控制更新时机的场景。

配置说明

Web服务配置

• API密钥：通过-apikey参数设置，用于验证Web请求的合法性，建议使用HTTPS确保密钥安全。
• 监听地址：通过-addr参数指定Web服务监听地址（默认：:8080）。

仓库认证配置

• 用户名：-user参数指定私有仓库用户名。
• 密码：-pass参数指定私有仓库密码。

安装部署

Docker容器部署

bash
sudo docker run -d \
    --name docker-puller \
    -e PULLER_APIKEY=XBockFfigDu14cvg7UEyNM \
    -e PULLER_USER=johndoe \
    -e PULLER_PASS=S3cretp4ssw0rd \
    -p 8080:8080 \
    -v /var/run/docker.sock:/var/run/docker.sock \
    --restart="unless-stopped" \
    pier13/docker-puller

独立二进制使用

启动Web服务

bash
docker-puller -apikey XBockFfigDu14cvg7UEyNM -user johndoe -pass S3cretp4ssw0rd

通过Curl触发更新：

bash
curl -X POST "https://docker.example.com/update?key=XBockFfigDu14cvg7UEyNM&image=portainer/portainer"

命令行直接更新

bash
docker-puller -image portainer/portainer