yuban-server/deploy/PRODUCTION_ROLLOUT.md

server.yuban.co 生产发布清单

当前 DNS 指向华为云公网地址 121.37.7.67。本清单只描述发布和验证步骤，不包含任何账号、密钥或自动登录脚本。

发布前

1. 备份 /etc/yuban-server.env 和持久任务目录。
2. 确认服务器为 Node.js 22+，并能执行 ffmpeg、ffprobe。
3. 配置持久绝对路径 JOB_STORE_DIR；不能放在版本发布时会被替换的目录中。
4. 设置 MAX_JOB_CONCURRENCY=2、MAX_JOB_ATTEMPTS=5、JOB_RETENTION_MS=2592000000。
5. 设置 CANONICAL_PERSISTENCE_ENABLED=true，并在服务器环境变量中提供 PARSE_MASTER_KEY；该密钥不得进入 Git、网页或日志。
6. 记录本次 SERVICE_VERSION 和 GIT_SHA，便于从 /health 确认实际运行版本。

灰度发布

1. 先执行 npm test 和 npm run check。
2. 发布新版本，但保留上一版本镜像或目录以便快速回滚。
3. 重启服务后确认 GET https://server.yuban.co/health 返回新版本、workerReady=true、storeReady=true。
4. 用测试账号提交一条短录音，验证 queued → running → completed，以及 ChatVoice 回读的 hash、字数和 long_complete 一致。
5. 人工模拟一次可重试失败，验证任务进入 retry_wait 并自动增加 attempt；模拟永久失败后调用 /retry，必须得到新的 jobId。
6. 再用 30 分钟录音验收，确认页面离开后任务仍继续、故事任务从 waiting_for_transcript 自动推进。

观察与回滚

• 至少观察 24 小时：任务成功率、retry_wait 数量、最终失败码、平均排队时间、任务目录磁盘占用、Parse 回读失败率。
• 日志只记录 jobId、attempt、stage、错误码和耗时，不得记录音频 URL、Session Token、逐字稿或 Parse Master Key。
• 若权威落库异常，可先关闭 CANONICAL_PERSISTENCE_ENABLED 并回滚服务版本；持久任务目录不可删除，前端仍可通过已有 jobId 恢复查询。