Wang Defa
ff86a4e2bf
- 简化 mond.service 配置，改为通过配置文件启动 - 优化 postinst 安装脚本，自动生成配置文件模板 - 优化 postrm 卸载脚本，正确清理数据目录 - 初始化 llmdoc 文档系统，包含项目概览、使用指南、架构说明和参考文档 - 更新 README.md 构建和配置说明 - 移除 .gitignore 中 llmdoc/ 的忽略规则
64 lines
1.3 KiB
Markdown
64 lines
1.3 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 流水线将自动处理
|
||
- 触发条件：新的版本标签推送
|
||
|
||
### 手动上传（备选）
|
||
```bash
|
||
# 构建 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 |