Files
xxxigcc-proxy/llmdoc/architecture/release-process.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.6 KiB

发布流程架构

1. 身份与目的

  • 名称: xxxigcc-proxy 发布流程
  • 目的: 定义软件包分发和版本管理的标准流程

2. 包管理注册表

2.1 Generic Package Registry

架构路径:.gitea/workflows/ci.yaml:125-135

特点

  • 存储 tar.gz 二进制包
  • 直接可下载链接
  • 版本化管理

上传逻辑

  • 基于 curl 的 PUT 请求
  • 使用 Build Token 认证
  • 上传路径:/api/packages/{owner}/generic/{product_name}/{version}/{filename}

2.2 Debian Package Registry

架构路径:.gitea/workflows/ci.yaml:137-152

特点

  • 通用稳定版仓库
  • 支持所有 Debian/Ubuntu 发行版
  • 单一 stable 发行版代号

上传逻辑

  • 使用 curl 的 PUT 请求
  • 上传到通用稳定版仓库
  • 上传路径:/api/packages/{owner}/debian/pool/stable/main/upload

3. Release 生成策略

3.1 Release 内容

架构路径:.gitea/workflows/ci.yaml:154-159

发布说明生成

  • 使用 Python 动态生成 Markdown 格式
  • 包含多种下载方式说明
  • 提供仓库和直接下载链接

3.2 Release 创建

架构路径:.gitea/workflows/ci.yaml:161-188

创建流程

  • 使用 Gitea API 创建 Release
  • 处理重复 Release 的情况
  • 生成 Release JSON payload

3.3 附件上传

架构路径:.gitea/workflows/ci.yaml:190-204

上传策略

  • 上传 tar.gz 和 .deb 文件
  • 作为 Release 附件
  • 使用 multipart/form-data

4. 安装指南生成

生成通用 Debian 仓库的安装说明,包括:

  • GPG 密钥下载
  • 仓库添加(使用 stable 发行版代号)
  • 包安装命令
  • 支持所有 Debian/Ubuntu 发行版