主题
升级、备份与恢复
升级流程
数据与二进制完全分离:数据库、日志、密钥都在 dataDir 下,替换二进制 不会碰它们。标准流程(systemd 形态):
bash
# 1) 停服(优雅停止:先停收请求,再等运行中的 Run 收尾)
systemctl stop deploy-server
# 2) 备份整个数据目录(务必包含 secret.key)
tar czf "deploy-backup-$(date +%F).tar.gz" -C /srv/deploy data
# 3) 替换二进制
install -m 0755 /tmp/deploy-server-new /usr/local/bin/deploy-server
# 4) 启动并验证
systemctl start deploy-server
systemctl is-active deploy-server
curl -fsS http://127.0.0.1:10055/api/v1/healthz注意事项:
- 尽量在没有运行中任务时升级。停服会等待收尾(HTTP 20 秒 + Run 最多 60 秒,unit 的
TimeoutStopSec=90兜底);被强杀的 Run 在下次启动时 自动标记为「中断」,不会永远挂着「运行中」; - 数据库结构由服务端启动时自动迁移,无需手工操作;
- Docker 形态的升级 = 备份数据卷 → 重建镜像 → 重建容器,见 06。
备份要点
一致性备份必须停服(SQLite 运行中直接拷文件可能拿到不一致快照):
bash
systemctl stop deploy-server
tar czf "deploy-backup-$(date +%F).tar.gz" -C /srv/deploy data
systemctl start deploy-server备份内容与优先级:
| 内容 | 必要性 | 丢失后果 |
|---|---|---|
data/deploy.db | 必须 | 用户、项目、运行历史、凭据密文全丢 |
data/secret.key | 必须 | 数据库里的 Secret/凭据密文永久不可解密 |
data/jwt.key | 建议 | 已签发 JWT 失效,重新登录即可 |
data/logs/ | 可选 | 历史日志丢失,可按保留策略取舍 |
workspaces/ | 单独备份 | 工作区里的代码与产物;如需保留应独立打包 |
工作区可能很大(node_modules、构建产物),建议与 dataDir 分开策略: dataDir 每日备份,工作区按需或只备份其中的本地配置。 备份文件本身含密钥与凭据密文,按服务器凭据同等保护,异地存放时加密。
恢复步骤
bash
# 1) 停服
systemctl stop deploy-server
# 2) 还原数据目录(覆盖或先移走旧目录)
tar xzf deploy-backup-2025-01-01.tar.gz -C /srv/deploy
# 3) 校正权限(密钥 0600,目录 0750)
chmod 750 /srv/deploy/data
chmod 600 /srv/deploy/data/jwt.key /srv/deploy/data/secret.key
# 4) 确认二进制存在且版本匹配,然后启动
systemctl start deploy-server
curl -fsS http://127.0.0.1:10055/api/v1/healthz- 恢复到新机器:先按 05 装好二进制与 unit,再还原数据目录; 对外地址变了就在系统设置里改
serverUrl,无需重启; - 只丢了
secret.key:数据库还能用(账号、项目、历史都在), 但 Secret 变量与 Git 凭据需逐项重新录入; - 工作区未备份:项目配置仍在,下次运行会按 Git 配置重新 clone, 但未入库的本地产物无法找回。
版本查看
bash
deploy-server version # 二进制版本(也接受 -v / --version)
curl -fsS http://127.0.0.1:10055/api/v1/healthz
# data 里含 version、uptimeSec、timeUI 的环境自检页与 deploy doctor 也会显示服务端版本。
日志保留与磁盘清理
- 自动清理:启动时一次、之后每 6 小时一次,删除超过
logRetentionDays(默认 30 天)的运行记录与日志文件;设0关闭。 可在系统设置热改; - 单文件上限:
logMaxBytes(默认 100MB)截断单次运行的超长日志, 防止个别任务刷爆磁盘; - 手动盘点:
du -sh /srv/deploy/data/logs/* | sort -h找出大户; 工作区与 docker 镜像/卷不在平台清理范围内,需自行维护。
目录结构与日志机制详见 02 数据目录与日志存储; 日志查看见日志与实时跟随。