Wang Defa
b491d8af32
- 去除多发行版支持（bookworm、trixie），改为 stable 单一发行版 - 更新 CI 配置：Debian 包统一上传到 debian/pool/stable/main - 简化 Release 说明生成脚本 - 更新安装指南、发布指南和 CI/CD 架构文档 - 补充系统设计和配置参考文档
64 lines
1.4 KiB
Markdown
64 lines
1.4 KiB
Markdown
# 如何发布 Mond 项目
|
||
|
||
## 1. 准备工作
|
||
|
||
### 前提条件
|
||
- 已配置 Gitea 仓库
|
||
- 具备仓库管理员权限
|
||
- 已安装必要的构建工具
|
||
|
||
## 2. 创建 Release
|
||
|
||
### 方法一：GitHub/Gitea Web 界面
|
||
1. 导航到仓库 Releases 页面
|
||
2. 点击 "New Release"
|
||
3. 选择目标分支
|
||
4. 输入语义化版本标签（例如 `v1.2.3`）
|
||
5. 填写发布说明
|
||
|
||
### 方法二：命令行
|
||
```bash
|
||
git tag -a v1.2.3 -m "Release version 1.2.3"
|
||
git push origin v1.2.3
|
||
```
|
||
|
||
## 3. 配置 Gitea Secrets
|
||
|
||
### 必需的 Secrets
|
||
- `REGISTRY_USERNAME`: 包仓库用户名
|
||
- `REGISTRY_PASSWORD`: 包仓库认证令牌
|
||
- `GPG_PRIVATE_KEY`: 用于签名的 GPG 私钥
|
||
- `GPG_PASSPHRASE`: GPG 私钥密码
|
||
|
||
### 设置步骤
|
||
1. 进入仓库设置
|
||
2. 选择 "Secrets"
|
||
3. 添加每个必需的 Secret
|
||
|
||
## 4. 包管理仓库上传
|
||
|
||
### 自动上传
|
||
CI 流水线将自动上传到以下位置：
|
||
- **Generic Package Registry**：通用软件包仓库
|
||
- **Debian Package Registry**：stable 发行版
|
||
|
||
触发条件：新的版本标签推送
|
||
|
||
### 上传目标
|
||
所有 Debian 包统一上传到：
|
||
- 发行版：stable
|
||
- 组件：main
|
||
- 路径：`debian/pool/stable/main`
|
||
|
||
## 5. 发布后验证
|
||
|
||
1. 检查 GitHub/Gitea Releases
|
||
2. 验证包管理仓库的可用性
|
||
3. 测试不同平台的安装
|
||
4. 确认 systemd 服务正常运行
|
||
|
||
## 注意事项
|
||
|
||
- 遵循语义化版本（Semantic Versioning）
|
||
- 每次发布前运行完整的测试套件
|
||
- 更新 CHANGELOG.md |