简化 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
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:
59
llmdoc/architecture/cicd-pipeline.md
Normal file
59
llmdoc/architecture/cicd-pipeline.md
Normal 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)推送时触发发布流程
|
||||
Reference in New Issue
Block a user