Skip to content

升级、备份与恢复 ​

升级流程 ​

数据与二进制完全分离:数据库、日志、密钥都在 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、time

UI 的环境自检页与 deploy doctor 也会显示服务端版本。

日志保留与磁盘清理 ​

  • 自动清理:启动时一次、之后每 6 小时一次,删除超过 logRetentionDays(默认 30 天)的运行记录与日志文件;设 0 关闭。 可在系统设置热改;
  • 单文件上限:logMaxBytes(默认 100MB)截断单次运行的超长日志, 防止个别任务刷爆磁盘;
  • 手动盘点:du -sh /srv/deploy/data/logs/* | sort -h 找出大户; 工作区与 docker 镜像/卷不在平台清理范围内,需自行维护。

目录结构与日志机制详见 02 数据目录与日志存储; 日志查看见日志与实时跟随。