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