简化 Debian 发布流程并添加项目文档系统
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 文件
This commit is contained in:
2025-12-25 10:18:07 +08:00
parent 76aac67b71
commit 9afe4a8649
28 changed files with 1297 additions and 31 deletions

View File

@@ -0,0 +1,59 @@
# 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推送时触发发布流程