10分钟搞定！MiGPT持续集成全流程：从0到1搭建GitHub Actions自动部署

你还在手动编译部署MiGPT？频繁的版本更新让你疲于重复操作？本文将带你用GitHub Actions构建完整CI/CD流水线，实现代码提交即自动测试、打包、部署，彻底解放双手！

读完本文你将获得：

• 从零创建GitHub Actions工作流文件
• 配置自动构建Docker镜像的完整步骤
• 解决常见的持续集成失败问题
• 优化部署流程的实用技巧

工作流文件基础架构

GitHub Actions通过.github/workflows目录下的YAML文件定义自动化流程。虽然当前项目中尚未包含此目录，但我们可以创建标准的工作流配置文件。以下是MiGPT项目适用的基础CI/CD架构：

name: MiGPT CI/CD Pipeline

on:
  push:
    branches: [ main, dev ]
  pull_request:
    branches: [ main ]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'pnpm'
      - name: Install dependencies
        run: npm install -g pnpm && pnpm install
      - name: Run tests
        run: pnpm test

  build:
    needs: test
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      # 后续步骤将在下文详细展开

关键配置说明

• 触发条件：代码推送到main或dev分支，或创建PR到main分支时自动触发
• 运行环境：基于Ubuntu最新版，兼容x86/arm架构
• 依赖管理：使用pnpm缓存提高安装速度，与项目本地开发保持一致

Docker镜像自动构建流程

MiGPT的Docker多架构构建是持续集成的核心环节。以下是完整的自动构建配置，支持amd64、arm64和arm32v7三种架构：

build:
  needs: test
  runs-on: ubuntu-latest
  steps:
    - uses: actions/checkout@v4
    
    - name: Set up Docker Buildx
      uses: docker/setup-buildx-action@v3
      
    - name: Login to DockerHub
      uses: docker/login-action@v3
      with:
        username: ${{ secrets.DOCKERHUB_USERNAME }}
        password: ${{ secrets.DOCKERHUB_TOKEN }}
        
    - name: Build and push
      uses: docker/build-push-action@v5
      with:
        context: .
        push: true
        tags: yourusername/mi-gpt:latest
        platforms: linux/amd64,linux/arm64,linux/arm/v7
        cache-from: type=gha
        cache-to: type=gha,mode=max

配置要点解析

1. 多平台支持：通过platforms参数指定三种架构，适配不同设备
2. 缓存优化：使用GitHub Actions缓存(Docker Buildx)加速构建
3. 安全认证：通过GitHub Secrets存储DockerHub凭证，避免明文暴露

完整工作流文件实现

将以下内容保存为.github/workflows/ci-cd.yml，即可实现从代码测试到镜像推送的全自动化：

name: MiGPT CI/CD Pipeline

on:
  push:
    branches: [ main, dev ]
  pull_request:
    branches: [ main ]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'pnpm'
      - name: Install dependencies
        run: npm install -g pnpm@9.1.1 && pnpm install
      - name: Run tests
        run: pnpm build && pnpm test

  build:
    needs: test
    runs-on: ubuntu-latest
    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
    steps:
      - uses: actions/checkout@v4
      
      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3
      
      - name: Login to DockerHub
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKERHUB_USERNAME }}
          password: ${{ secrets.DOCKERHUB_TOKEN }}
      
      - name: Build and push
        uses: docker/build-push-action@v5
        with:
          context: .
          push: true
          tags: yourusername/mi-gpt:latest
          platforms: linux/amd64,linux/arm64,linux/arm/v7
          cache-from: type=gha
          cache-to: type=gha,mode=max
          
      - name: Deploy notification
        if: success()
        run: echo "✅ 新版本已成功推送至DockerHub"

常见问题解决方案

依赖安装失败

若出现pnpm install失败，检查Node.js版本是否符合要求。项目要求Node.js >=16，推荐使用20.14.0版本：

- name: Setup Node.js
  uses: actions/setup-node@v4
  with:
    node-version: '20.14.0'  # 明确指定版本而非使用latest

Docker构建超时

对于arm架构构建超时问题，可添加--progress=plain参数查看详细日志：

- name: Build and push
  uses: docker/build-push-action@v5
  with:
    # 其他参数不变
    build-args: |
      TARGETARCH=${{ matrix.arch }}
    progress: plain

数据库初始化错误

参考开发文档中的数据库重置命令，在工作流中添加：

- name: Fix database issues
  run: pnpm run db:reset

部署流程优化建议

多环境部署策略

通过分支名区分开发/生产环境，实现环境隔离：

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        include:
          - branch: dev
            tag: beta
          - branch: main
            tag: latest
    if: github.ref == format('refs/heads/{0}', matrix.branch)
    steps:
      # 其他步骤不变
      - name: Build and push
        with:
          tags: yourusername/mi-gpt:${{ matrix.tag }}

部署结果通知

添加钉钉/企业微信通知，实时掌握部署状态：

- name: Send notification
  uses: appleboy/dingtalk-action@master
  with:
    webhook: ${{ secrets.DINGTALK_WEBHOOK }}
    message: |
      🚀 MiGPT新版本已部署
      版本: ${{ github.sha }}
      时间: ${{ github.event.head_commit.timestamp }}

总结与下一步

通过本文配置的GitHub Actions工作流，你已实现MiGPT的全自动CI/CD流程。每次合并代码到main分支，系统会自动完成：

1. 代码检查与测试（基于package.json中的脚本）
2. 多平台Docker镜像构建（使用Dockerfile定义）
3. 镜像推送到仓库并可选部署通知

下一步建议：

• 配置自动版本号管理，使用语义化版本
• 添加代码质量检查(SonarQube)和安全扫描
• 实现自动回滚机制应对部署失败

收藏本文，下次配置持续集成时直接套用！如有问题欢迎在评论区交流，关注获取更多MiGPT高级教程。