Files
mond/llmdoc/guides/how-to-release.md
Wang Defa ff86a4e2bf
All checks were successful
Build and Release Mond / build-and-test (arm64) (push) Successful in 4s
Build and Release Mond / build-and-test (amd64) (push) Successful in 14s
Build and Release Mond / release (push) Successful in 37s
feat: 优化 Debian 打包配置并初始化项目文档系统
- 简化 mond.service 配置,改为通过配置文件启动
- 优化 postinst 安装脚本,自动生成配置文件模板
- 优化 postrm 卸载脚本,正确清理数据目录
- 初始化 llmdoc 文档系统,包含项目概览、使用指南、架构说明和参考文档
- 更新 README.md 构建和配置说明
- 移除 .gitignore 中 llmdoc/ 的忽略规则
2025-12-24 08:59:06 +08:00

1.3 KiB
Raw Blame History

如何发布 Mond 项目

1. 准备工作

前提条件

  • 已配置 Gitea 仓库
  • 具备仓库管理员权限
  • 已安装必要的构建工具

2. 创建 Release

方法一GitHub/Gitea Web 界面

  1. 导航到仓库 Releases 页面
  2. 点击 "New Release"
  3. 选择目标分支
  4. 输入语义化版本标签(例如 v1.2.3
  5. 填写发布说明

方法二:命令行

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 流水线将自动处理
  • 触发条件:新的版本标签推送

手动上传(备选)

# 构建 Debian 包
./debian/build-deb.sh

# 上传到包仓库
dput ppa:your-ppa-name/mond mond_1.2.3_amd64.changes

5. 发布后验证

  1. 检查 GitHub/Gitea Releases
  2. 验证包管理仓库的可用性
  3. 测试不同平台的安装
  4. 确认 systemd 服务正常运行

注意事项

  • 遵循语义化版本Semantic Versioning
  • 每次发布前运行完整的测试套件
  • 更新 CHANGELOG.md