docs: record successful staging rollout

This commit is contained in:
linmeng
2026-07-28 18:09:44 +08:00
parent a7ff511f55
commit f430ebd2c8
+3 -3
View File
@@ -1578,8 +1578,8 @@
- 触发条件:`staging` push 后,Runner 使用 `registry.cn-hangzhou.aliyuncs.com/library/python:3.12-slim` 或对应 Node 地址解析基础镜像。
- 根因:阿里云 `library/*` 地址并非当前凭据可访问的公共镜像仓库,xiaoxin 直连 Docker Hub 超时;同时充值订单二维码条件渲染缺少右花括号,导致相邻 `payUrl` 条件 JSX 无法解析。
- 修复:工作流保持单 job 构建发布部署链路;checkout 使用 depth-1 浅拉取和网络超时;API/Web 使用实测可达的国内基础镜像,API 使用阿里云 APT/PyPI;补齐二维码条件渲染的 `}`;服务器 deploy 目录由 root 管理,因此上传后的目录创建、控制文件解包及 Docker 操作均使用免交互 sudo。
- 验证:run 1264 暴露 JSX 错误,本地修复后 `npm run build` 完整通过;run 1265 的双镜像均推送 ACR 成功并暴露普通 `tar` 权限错误;run 1266 证实 sudo 解包成功,随后暴露 sudo 清理 `API_IMAGE` / `WEB_IMAGE` 等临时环境,Compose 因而回落到本地默认镜像。已改为 `sudo env` 显式传值,继续用下一次运行闭环
- 防复发:staging Dockerfile 的基础镜像必须在 xiaoxin 完整 `docker pull` 验证;APT 与 Python 包源均基于 Runner 实测选择并设置有限重试/超时,避免网络异常无限占用工作流
- 验证:run 1264 暴露 JSX 错误,本地修复后 `npm run build` 完整通过;run 1265 暴露普通 `tar` 权限错误;run 1266 暴露 sudo 清理 Compose 镜像环境。最终 Gitea run 1267job 3795checkout、双镜像构建/ACR 推送、测试服务器部署全部成功;服务器 API/Web 均运行 `a7ff511f5520c5e2369e91ee3934989d34dedf5e` 且 healthy,外部 `/login=200`、未登录 `/api/account=401``/api/health=200`,健康响应部署 SHA 与目标一致
- 防复发:基础镜像必须在 xiaoxin 完整 pull 验证;APT/PyPI 基于 Runner 实测并设置有限超时;部署契约测试固定浅拉取、sudo 解包和 `sudo env` 镜像变量传递
- 相关记录:BUG-082、BUG-083、BUG-084
- 复发自:BUG-082
- 修复版本:待提交(本地可测
- 修复版本:`a7ff511`Gitea stagingrun 1267 已部署验证