通过GitHub仓库自动更新Docker容器的技术方案咨询

核心逻辑 #

通过GitHub Actions自动构建Docker镜像并推送到镜像仓库，远程设备拉取新镜像重启容器，全程自动化完成更新，比手动传输EXE和依赖包高效得多。

具体实现步骤 #

1. 准备镜像仓库 #

• 选用Docker Hub或私有镜像仓库（如Harbor），创建专属仓库存放项目镜像。
• 进入GitHub仓库的Settings > Secrets and variables > Actions，添加镜像仓库的用户名（DOCKER_USERNAME）和密码/令牌（DOCKER_PASSWORD），避免明文泄露敏感信息。

2. 编写Dockerfile #

确保Dockerfile能正确打包你的Python项目，示例模板：

# 选择适配项目的Python基础镜像
FROM python:3.10-slim

# 设置工作目录
WORKDIR /app

# 先复制依赖文件，利用Docker缓存减少构建时间
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制项目代码
COPY . .

# 定义项目启动命令
CMD ["python", "main.py"]

3. 配置GitHub Actions自动构建推送 #

在项目根目录创建.github/workflows/docker-build.yml文件，内容如下：

name: Build and Push Docker Image

on:
  push:
    branches: [ main ]  # 监听main分支的代码推送

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4

      - name: 登录镜像仓库
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_PASSWORD }}

      - name: 构建并推送镜像
        uses: docker/build-push-action@v5
        with:
          context: .
          push: true
          tags: ${{ secrets.DOCKER_USERNAME }}/your-project-name:latest  # 替换为你的镜像标签

此后每次往main分支推送代码，GitHub会自动完成镜像构建并推送到仓库。

4. 远程设备配置更新脚本 #

在远程设备上创建update-project.sh脚本，赋予执行权限：

#!/bin/bash
# 拉取最新镜像
docker pull your-docker-username/your-project-name:latest
# 停止旧容器
docker stop your-container-name
# 删除旧容器
docker rm your-container-name
# 启动新容器
docker run -d --name your-container-name your-docker-username/your-project-name:latest

可以用cron定时执行脚本实现定期更新，或者配置webhook（比如GitHub推送后调用远程设备接口触发脚本）实现实时更新。

5. 进阶优化点 #

• 用版本号标签（如v1.0.0）代替latest，便于后续版本回滚。
• 用docker-compose管理容器，更新时只需执行docker-compose pull && docker-compose up -d，操作更简洁。
• 给镜像仓库配置webhook，触发远程设备自动执行更新脚本，无需定时轮询。

内容的提问来源于stack exchange，提问作者Dann