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 包仓库从 bookworm/trixie 双发行版改为通用 stable 仓库 - 新增完整的 llmdoc 文档系统，包含架构、指南和参考文档 - 更新 README.md 和部署指南以反映新的仓库配置 - 添加 .gitignore 文件
59 lines
1.5 KiB
Markdown
59 lines
1.5 KiB
Markdown
# 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）推送时触发发布流程 |