QQgit/docs/DEPLOY.md

51 lines
2.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 部署说明(阶段 6,需 QQ 批准后才做)
本文件只是操作手册,`scripts/deploy.sh` 默认是**预演**,不加 `--yes` 绝不会动线上。
## 一、前提
1. 已在本地/镜像里打开 `preview/index.html`,日夜两种模式都看过,认可配色与留白。
2. 仓库已按实际版本打候选标签 `vX.Y.Z-rcN`(`git tag -l` 可查)。
3. QQ 明确说过「可以部署」。
## 二、预演(随时可做,零风险)
```bash
cd ~/projects/Gitea-font
./scripts/deploy.sh
```
它会列出将被复制的文件清单、备份路径与后续动作,然后退出,线上不变。
## 三、真部署
```bash
./scripts/deploy.sh --yes # 复制 custom/ + 重启
./scripts/deploy.sh --yes --patch-ini # 另外把 app.ini 的 [ui] 主题切成 qq 系列
```
`--patch-ini` 做的事:把 `DEFAULT_THEME` 改为 `qq-auto`,并在 `THEMES` 后追加
`qq-auto,qq-light,qq-dark`(原有主题全部保留,可随时在用户设置里切回)。
原 `app.ini` 会备份成 `/etc/gitea/app.ini.bak-<时间戳>`。
## 四、回滚
部署脚本会完整备份 `custom/`(包含三套 `theme-qq*.css`)和 `app.ini`,并在重启或 HTTP 健康检查失败时自动回滚。人工回滚统一使用:
```bash
./scripts/rollback.sh --list
./scripts/rollback.sh /var/backups/gitea-custom-<时间戳>.tar.gz
```
`rollback.sh` 会先校验归档、再备份当前状态、停止服务,并通过 `rsync --delete` 精确恢复。旧版本部署脚本生成的备份缺少 QQ 主题,默认拒绝;只有确认承担主题缺失风险时才可附加 `--allow-incomplete`。
## 五、部署后自查清单
- [ ] `https://git.qyhhh.top/` 首页 logo 变成蓝白 Git-Q,圆外无白框
- [ ] 浏览器标签页 favicon 是新的小圆章
- [ ] 顶栏、按钮、链接全部蓝白,无绿色残留
- [ ] 代码块字体为 JetBrains Mono
- [ ] 系统浅色/深色切换时,主题自动跟随(`qq-auto`)
- [ ] 用户设置里仍能选回 `github-auto` 等旧主题(说明没破坏原有主题)
- [ ] 无 500 错误、无模板解析报错(`journalctl -u gitea -n 50 --no-pager`)