小冈接手知识库 · 生产运维心智卡（2026-09-05）

依据：B1 执行关窗记录（fa261b3）+ deploy.sh/migrate.sh/backup-to-cos.sh 源码梳理。

原则：生产永不自动——一切生产写操作（部署/迁移/修账）等刘总人工令；staging 走 push 钩子自动。

一、环境拓扑

环境	位置	端口	部署方式
生产	服务器 /srv/kailash（容器 kailash-app / kailash-pg）	8088（反代 api.kailashi.cn）	`./scripts/deploy.sh`（人工令）
staging	服务器 /srv/kailash-staging	8089（Tailscale 100.64.1.230）	push 钩子 post-receive 自动
DB 生产	容器 kailash-pg，用户 yos，库 kailash	—	迁移永不自动（marked 表）
DB staging	kailash-staging-pg，库 kailash_staging	—	migrate.sh 自动跑未执行迁移

二、部署三步（deploy.sh）

本地 clean+提交 → git push origin main
git archive main backend → ssh 服务器解到 TARGET → docker compose 重建容器
健康检查（注意绑址缺陷已登记：127.0.0.1→100.64.1.230；生产 migrate 需 DEPLOY_WITH_MIGRATIONS=1）

B1 已踩坑（关窗后登记待修 4 项）：

deploy.sh 同步清单缺 backend/scripts（B1 手工 rsync 补位才炸过）——待修
backup.sh 库名误写 yos→kailash（cron 曾产生 0 字节 dump）——待修
migrate.sh stdin 通道缺陷（sudo docker exec -i 吞脚本静默 exit 0）→ 正解=scp 到服务器本地执行
staging_smoke N4 硬编码 merchant_id=7（跨环境地雷，宜参数化）

三、迁移纪律

台账：schema_migrations（filename/sha256/marked）；migrate.sh 按 marked 跳过
生产执行顺序：先核对台账差集（只读 psql docker exec kailash-pg psql -U yos -d kailash -c "SELECT * FROM schema_migrations ORDER BY filename"）→ 列影响面 → 刘总令 → 执行（scp 后本地跑）→ 台账核验
回滚：pg_dump 锚点（B1 落 /srv/kailash/backups/kailash-B1-*.dump 516K）+ 镜像回退两级预案

四、B1 关键结论（接手即用）

生产 routers 40→53（B1 后=full）；镜像此前停 08-30 旧版（B1 前生产=08-30 版本——凡 09-04 前「生产 404」都是这个原因）
smoke 生产 25/26（唯一 FAIL=N4 fixture 假设；等价复跑 PASS）——生产 smoke 可跑、N4 例外已知
E2E B2 全站回归=staging 跑（B1 关窗后解锁）
上线日流程：B1 复走（快照/部署/迁移/抽验/冒烟）+48h 灰度观察

五、发版提醒（客户端）

微信小程序发版 checklist 必含：3ace656（request.ts {ok,data} 解包兼容）——代码在但未发布不生效
发版前：staging smoke 26/26 + E2E B2 + verify-c.sh 全绿

六、SSH/凭据速记

ssh kailash（主机别名）/ KAILASH_HOST 可覆盖；生产 SSH key：kailash.pem（沙箱无，服务器上操作需在小齐/阿仁环境或刘总授权通道）
服务器路径：/srv/kailash（生产）、/srv/kailash-staging；备份 /srv/kailash/backups/