docs: clarify env image registry fallback

This commit is contained in:
Codex
2026-06-02 01:20:05 +08:00
parent f2cfbee41d
commit 4ddea73629
+1 -1
View File
@@ -54,7 +54,7 @@ CI 的最小检查应覆盖:
容器镜像必须区分 env identity 与 source commit。`agentrun-mgr-env:<envIdentity>` 只包含 Bun runtime、生产依赖、Codex CLI、git/kubectl/node 等系统依赖和 boot 脚本,不 bake `src/``scripts/` 或某个业务 source commit。运行时通过 `AGENTRUN_BOOT_COMMIT` 从 git mirror 按完整 SHA 做 `git fetch --depth=1 origin <sha>`,再用 env image 内的 `node_modules` 启动 manager 或 runner。CI/CD 仍然只允许纯 Tekton + Argo CD,不因 Bun 工具链引入自定义 runner、长期 poller 或源分支生成物提交。
Env identity 的输入至少包含:Bun base image、系统包列表、`deploy/container/Containerfile``deploy/runtime/boot/*.sh``package.json``bun.lock``tsconfig.json`。只改业务 TS、文档、模板中不影响 runtime env 的内容时,planner 必须输出 `build=0 reuse=1 unsafeReuse=0`,并复用上一版 catalog 中同一 `envIdentity` 的 digest。
Env identity 的输入至少包含:Bun base image、系统包列表、`deploy/container/Containerfile``deploy/runtime/boot/*.sh``package.json``bun.lock``tsconfig.json`。只改业务 TS、文档、模板中不影响 runtime env 的内容时,planner 必须输出 `build=0 reuse=1 unsafeReuse=0`,并优先复用上一版 catalog 中同一 `envIdentity` 的 digest。若 GitOps catalog 因 mirror flush lag 暂时不可见,但 G14 registry 中已经存在同一 `agentrun-mgr-env:<envIdentity>` 且能用 schema2 HEAD 取到 digestplanner 可以把 registry digest 作为受控 fallback 复用;promotion 仍必须重新写入 catalog provenance,避免长期依赖隐式 registry 状态。
## 真相源