修复预览部署可选提交参数

修复 Checkout 阶段在严格 shell 下展开未定义 COMMIT_HASH 的失败增加预览流水线参数归一化防回归门禁同步预览部署参数合同与项目决策文档
2026-08-15 17:59:27 +08:00
parent 7400c706f8
commit d2366bc40a
4 changed files with 40 additions and 3 deletions
@@ -56,6 +56,8 @@ SpacetimeDB 与 OTLP 不映射宿主端口；Jenkins 通过受控 Compose 网络

 分支名只允许数字、字母、点、下划线、短横线和斜杠，不允许首尾斜杠或连续点号。Jenkins 必须复用 `scripts/jenkins-checkout-source.sh`，验证 commit 真实属于目标远端分支；SPA 和代理服务的输入校验不能代替流水线校验。

+`COMMIT_HASH` 是真正可选的参数：控制服务应显式传空字符串，但 Jenkins 也必须兼容首次参数尚未物化、旧构建重跑等没有该环境变量的调用。每个独立 `sh` 步骤都要在 `set -u` 下用空值默认完成归一化，不能依赖前一个 `sh` 中的局部赋值。`DEPLOY` 缺少 `SOURCE_BRANCH` 必须在动态 checkout 前失败关闭；分支明确而 commit 为空时，仍由 `scripts/jenkins-checkout-source.sh` 解析为该目标分支的远端最新提交，不得回退到控制器 `master` 或跳过分支归属校验。
+
 每次运行归档 `preview-result.json`，至少包含：

 ```json