Files
xxxigcc-proxy/llmdoc/architecture/cicd-pipeline.md
Wang Defa 9afe4a8649
All checks were successful
Build and Release / build-and-test (arm64, alpine) (push) Successful in -13s
Build and Release / build-and-test (amd64, alpine) (push) Successful in -6s
Build and Release / build-and-test (arm64, ubuntu) (push) Successful in -7s
Build and Release / build-and-test (amd64, ubuntu) (push) Successful in 7s
Build and Release / release (push) Successful in 21s
简化 Debian 发布流程并添加项目文档系统
- 将 Debian 包仓库从 bookworm/trixie 双发行版改为通用 stable 仓库
- 新增完整的 llmdoc 文档系统,包含架构、指南和参考文档
- 更新 README.md 和部署指南以反映新的仓库配置
- 添加 .gitignore 文件
2025-12-25 10:18:07 +08:00

1.5 KiB
Raw Permalink Blame History

CI/CD 流水线架构

1. 身份与目的

  • 名称: xxxigcc-proxy 自动化构建和发布流水线
  • 目的: 自动化构建、测试和发布跨平台二进制包和 Debian 安装包

2. 核心组件

2.1 构建作业 (build-and-test)

架构路径:.gitea/workflows/ci.yaml:15-93

主要职责

  • 多架构amd64、arm64构建
  • 多发行版Ubuntu、Alpine构建
  • 构建二进制文件
  • 打包 tar.gz 文件
  • 构建 Debian 安装包
  • 上传构建产物

关键步骤

  1. 代码检出
  2. 设置 Docker Buildx
  3. 构建二进制文件(docker buildx build
  4. 打包和测试(创建 tar.gz
  5. 构建 Debian 包(仅 Ubuntu
  6. 上传构建产物

2.2 发布作业 (release)

架构路径:.gitea/workflows/ci.yaml:95-212

主要职责

  • 下载构建产物
  • 上传包到包管理器
  • 创建 GitHub/Gitea Release
  • 生成发布说明
  • 上传发布附件

关键步骤

  1. 下载构建产物
  2. 上传到 Generic Package Registry
  3. 上传到 Debian Package Registry
  4. 创建 Release
  5. 上传 Release 附件

3. 设计原理

多架构构建

  • 使用 Docker Buildx 实现跨平台构建
  • 支持 AMD64 和 ARM64 架构
  • 针对不同架构和发行版生成独立构建

包管理策略

  • Generic Package Registry存储 tar.gz 包
  • Debian Package Registry使用通用 stable 发行版,支持所有 Debian/Ubuntu 发行版
  • 自动生成安装和下载说明

4. 触发机制

  • 代码推送到 main/develop 分支
  • 标签Tag推送时触发发布流程