From 1cf12be904fbd9bc2bb4e654b99b28c2cd478ab3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=B5=85=E5=BF=B5?= Date: Tue, 22 Sep 2026 19:10:27 +0800 Subject: [PATCH] =?UTF-8?q?docs(g4):=20build-env=20incidents=20(Hub=20outa?= =?UTF-8?q?ge=20=E2=86=92=20server-side=20build;=20nginx:alpine=20entrypoi?= =?UTF-8?q?nt=20hang=20patch)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Code --- docs/plans/progress/G4-用户接口对接-验收记录.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/plans/progress/G4-用户接口对接-验收记录.md b/docs/plans/progress/G4-用户接口对接-验收记录.md index 1acd1ac..08da90b 100644 --- a/docs/plans/progress/G4-用户接口对接-验收记录.md +++ b/docs/plans/progress/G4-用户接口对接-验收记录.md @@ -110,6 +110,22 @@ - 既有登记沿用：UI-04 线 embed e2e/`embedSlots.spec.ts` displayMode 类型漂移为 线外残留（本迭代观察到 admin typecheck 同源 3 错，非本域文件）。 +## 4.8 构建环境事件与分页档位调优（2026-09-22 晚） + +- 分页档位调优（用户手改 + 单测同步）：默认每页 15、档位 [15,20,50,100]（80a7658）。 +- **事件 A：本机 Docker Hub 不可达**（TLS 握手超时持续 20+ 分钟，同日早些时候正常）。 + 应对：**构建挪到测试服务器**（其 Docker 配有国内加速器 docker.1ms.run/1panel.live， + 基础镜像可拉）：git archive HEAD 解包 scp → 服务器 docker build → 直接 up（免镜像 + 传输）。此路径已验证可用，Hub 再抽风时的标准预案。 +- **事件 B：服务器新拉的 `nginx:alpine`（当日最新 digest）entrypoint 卡死**—— + 10-listen-on-ipv6-by-default.sh 在该服务器挂起（本地构建缓存旧 digest 无此问题； + nginx 配置本身 nginx -t 通过）。**临时补丁**：构建期 + `RUN rm -f /docker-entrypoint.d/10-listen-on-ipv6-by-default.sh`（服务器侧 + web-patched.Dockerfile，产物即线上 admin-80a7658-20260922，已 healthy）。 + **待办**：仓库 Dockerfile 的 `FROM nginx:alpine` 钉具体版本（待本机 Hub 恢复统一 + 处理），并把补丁行正式化（或钉版本后确认无需补丁）。 +- 中途回滚一次（admin-eebf3b3 web）恢复服务后再上补丁版——停机窗口约 4 分钟。 + ## 5 残留与登记偏差 - **embed.e2e-spec 失败（既有，非本分支）**：API settings 响应含 UI-04 线新增