Merge remote-tracking branch 'origin/master' into feat/pixel_art

docs/technical/【开发运维】Jenkins容器预览部署控制面技术方案-2026-08-15.md

@@ -45,6 +45,8 @@ SpacetimeDB 与 OTLP 不映射宿主端口；Jenkins 通过受控 Compose 网络
 
 SpacetimeDB 2.7 CLI 发布到受控 Compose 网络地址时固定使用 `--yes=remote,migrate,break-clients`，避免 Jenkins 等待非本地目标交互确认；该预览路径不传 `--delete-data`。Jenkins 同时固定 `GENARRATIVE_PREVIEW_WEB_HOST=192.168.35.82`，不得用默认路由自动探测结果生成页面链接，以免 VPN 或容器网卡地址泄漏到同事可见 URL。
 
+预览 Compose override 将 SpacetimeDB 内存上限设为 `2g`。基础 loadtest Compose 的 `896m` 是压测采样口径，当前完整模块首次发布和实例化会超过该上限；预览环境若沿用该值，容器会被 cgroup OOM 杀死并使模块上传中断。该覆盖只作用于分支预览实例，不修改生产或压测基线。
+
 ## Jenkins 参数与产物
 
 固定 Job：`shared/Genarrative-Preview-Deployer`。

scripts/check-preview-deployer.mjs

@@ -106,6 +106,11 @@ assertIncludes(
   'ports: !reset []',
   '预览 compose override 必须取消 SpacetimeDB 和 OTLP 宿主端口映射。',
 );
+assertIncludes(
+  deployer,
+  'spacetimedb:\n    mem_limit: 2g\n    ports: !reset []',
+  '预览 SpacetimeDB 必须覆盖压测基线内存限制，避免模块首次加载时 OOM。',
+);
 assertIncludes(
   deployer,
   '^preview-[0-9a-f]{16}$',

scripts/jenkins-preview-deployer.sh

@@ -301,6 +301,7 @@ services:
       context: ${GENARRATIVE_PREVIEW_SOURCE_DIR}
       dockerfile: ${GENARRATIVE_PREVIEW_CONTROLLER_ROOT}/deploy/container/api-server.Dockerfile
   spacetimedb:
+    mem_limit: 2g
     ports: !reset []
   otelcol:
     ports: !reset []