安装冒烟与 Docker E2E
本文覆盖 Install Smoke、本地 Docker E2E 聚合及其可调参数、可复用的 live/E2E 工作流,以及发布路径上的各个组成部分。本文属于 发布验证工作流 索引的一部分。
安装冒烟测试¶
Install Smoke 工作流不再在拉取请求或 main 分支推送时运行。其夜间/手动包装器与发布验证都会调用只读的 install-smoke-reusable.yml 核心,每次运行都会在 GitHub 托管的运行器上执行完整的 install-smoke 流程:
- 根 Dockerfile 冒烟镜像会针对每个目标 SHA 构建一次,并以不可变工件的形式与工作流修订版及生产者尝试绑定。随后,CLI smoke、agents delete shared-workspace CLI smoke、container gateway-network E2E 和 bundled
matrixplugin build-arg smoke 都会加载该镜像。该插件冒烟会验证运行时依赖安装的镜像同步,并验证插件能否在无 entry-escape 诊断的情况下加载。 - QR 包安装以及安装器/更新 Docker 冒烟(包括 Rocky Linux 安装器通道,以及针对可配置的
update_baseline_versionnpm 基线的更新通道)作为独立作业运行,因此安装器相关工作不会排在根镜像冒烟之后等待。
缓慢的 Bun 全局安装与运行时冒烟由 run_bun_global_install_smoke 单独控制。它使用受信任的生命周期脚本安装候选版本,然后在 Bun 1.4 或更高版本下验证具有代表性的 CLI、本地 agent 和 Gateway 路径。它按夜间计划运行,来自发布检查的工作流调用默认启用,手动触发的 Install Smoke 也可以选择开启。常规 PR CI 仍会针对与 Node 相关的更改运行快速的 Bun 启动器回归通道。QR 和安装器 Docker 测试保留各自专注于安装的 Dockerfile。
Bun-only 运行时冒烟复用了经校验的候选 tarball,以及来自 setup-test-bun 的、校验和固定的 Bun fork。它在私有挂载命名空间中使用带记录功能的哨兵屏蔽系统 Node,保持宿主机不变;并使用与子 PID 关联的 spawn 跟踪,在安装、CLI、Gateway、node-host 配对、模拟的 agent 回合、Doctor、终端和浏览器等步骤中检测对 Node 的调用尝试。该通道会执行一次无 Node 的 bun install 尝试,并将 OPENCLAW_PACKAGE_BUN_LAUNCHER 设置为固定的 Bun 可执行文件;安装失败即通道失败,不会使用 Node 重试。安装过程会在 PATH 中为其他 Node 启动器放置哨兵,让 node 不出现在安装哨兵目录中,以便 Bun 注入其生命周期 shim。在冒烟测试隐藏 Node 之前,Node 仍可用于负载准备和验证。Bun-only 通道仅通过其自身的 run_bun_only_runtime_smoke 输入在 Release Checks(完整发布验证)中运行,绝不在夜间计划或手动 Install Smoke 触发中运行,并会跳过冻结目标。目前它仅作参考(continue-on-error):失败会记录在运行中,但不会阻塞发布。已知的 Node 需求位于 scripts/e2e/lib/bun-only-runtime/expected-node-blockers.json:未列出的 Node 调用尝试会失败;已列出但不再复现的阻塞项也会失败,直到其条目被删除。
本地 Docker E2E¶
pnpm test:docker:all 会预构建一个共享的 live-test 镜像,将 OpenClaw 作为 npm tarball 打包一次,并构建两个共享的 scripts/e2e/Dockerfile 镜像:
- 一个精简的 Node/Git 运行器,用于安装器/更新/插件依赖通道;
- 一个功能镜像,将同一个 tarball 安装到
/app,用于常规功能通道。
Docker 通道定义位于 scripts/lib/docker-e2e-scenarios.mts,规划器逻辑位于 scripts/lib/docker-e2e-plan.mts,而运行器只执行所选计划。调度器使用 OPENCLAW_DOCKER_E2E_BARE_IMAGE 和 OPENCLAW_DOCKER_E2E_FUNCTIONAL_IMAGE 为每个通道选择镜像,然后以 OPENCLAW_SKIP_DOCKER_BUILD=1 运行各通道。使用这些包镜像的 live 通道不需要单独的源码 live-test 镜像;而使用源码镜像的模型/后端通道仍会准备该镜像。
可调参数¶
| 变量 | 默认值 | 用途 |
|---|---|---|
OPENCLAW_DOCKER_ALL_PARALLELISM |
10 | 常规通道的主池槽位数。 |
OPENCLAW_DOCKER_ALL_TAIL_PARALLELISM |
10 | 对 Provider 敏感的尾部池槽位数。 |
OPENCLAW_DOCKER_ALL_LIVE_LIMIT |
9 | 并发 live 通道上限,以免 Provider 触发限流。 |
OPENCLAW_DOCKER_ALL_NPM_LIMIT |
5 | 并发 npm 安装通道上限。 |
OPENCLAW_DOCKER_ALL_SERVICE_LIMIT |
7 | 并发多服务通道上限。 |
OPENCLAW_DOCKER_ALL_START_STAGGER_MS |
2000 | 各通道启动之间的错峰间隔,以避免 Docker 守护进程创建风暴;设为 0 表示不错峰。 |
OPENCLAW_DOCKER_ALL_LANE_TIMEOUT_MS |
7200000 | 每个通道的兜底超时时间(120 分钟);选定的 live/尾部通道使用更严格的上限。 |
OPENCLAW_DOCKER_ALL_DRY_RUN |
unset | 设为 1 时仅打印调度器计划,不运行任何通道。 |
OPENCLAW_DOCKER_ALL_LANES |
unset | 以逗号分隔的精确通道列表;跳过清理冒烟,以便 agent 可以复现单个失败的通道。 |
即使通道的负载超过其有效上限,它仍可从空池启动,然后单独运行,直到释放容量。本地聚合会对 Docker 进行预检、移除过期的 OpenClaw E2E 容器、输出活动通道状态、持久化各通道耗时以按最长优先排序,并且默认在第一次失败后停止调度新的池化通道。
可复用的 live/E2E 工作流¶
仓库 E2E 以九个独立作业运行:四个按时长加权的 Gateway 分片、四个按时长加权的 Control UI 分片,以及独立的 agent-plugin Gateway 测试。两个独立的生产者会按照各自的 profile 各构建一次所选源码:Gateway 包/类型检查使用完整的 private-QA 构建,UI 和 agent-plugin 测试使用 CI 工件构建。消费者会精确恢复生产者工件,包括生成的插件资产和本地构建元数据,并安装各自的 Chromium 和沙箱前置依赖。每个组有四个测试槽位,因此耗时较长的 UI 分片可以同时启动,无需等待 Gateway 的声明或测试结果。某个生产者失败会阻塞其自身的消费者;其他诊断继续运行。
Gateway 分片保留现有的四个全新进程边界和双 worker 限制。每个 UI 分片以最多两个 worker 运行其捆绑文件,然后串行运行其私有服务器、真实 Gateway 和运行时预算文件。根调度器将两个项目中的文件分配到相同的四个加权分片。没有测试被过滤掉,现有的 90 分钟作业截止时间保持不变。本地 pnpm test:e2e 仍然顺序运行其套件命令;每个 UI 命令使用相同的项目策略。
这使每次调用减少七次构建,并将峰值测试并发从六提升到八。发布检查通过 gateway_repo_e2e_use_github_hosted_runners: false 将完整 Gateway 构建和四个 Gateway 测试分片路由到现有的 blacksmith-32vcpu-ubuntu-2404 配置。每次活动使用五个 Blacksmith 注册,同时最多四个 Gateway 测试 runner;UI、插件和其他 live 套件的路由保持不变。其他调用方将 Gateway 选项默认为 true,并保留其整体托管 runner 选择。独立的 Blacksmith 调用可以注册十一个 runner:两个 producer 和九个测试作业。producer 工件标识在仅 consumer 重试中保留;consumer 从不按自身当前尝试次数选择工件。
可复用的 live/E2E 工作流会询问 scripts/test-docker-all.mjs --plan-json 需要哪个包、镜像类型、live 镜像、lane 以及凭据覆盖。scripts/docker-e2e.mjs 随后将该计划转换为 GitHub 输出和摘要。它要么通过 scripts/package-openclaw-for-docker.mjs 打包 OpenClaw,要么下载当前运行的包工件,要么从 package_artifact_run_id 下载包工件,然后校验 tarball 清单。默认 no-push-artifact 路径通过 Blacksmith 的 Docker 层缓存构建带包摘要标签的 bare/functional 镜像,将精确的镜像字节打包为不可变工作流工件,并让每个 consumer 校验并加载该工件。existing-only 则要求显式的 docker_e2e_bare_image/docker_e2e_functional_image GHCR 引用,并且从不构建或推送。这些 registry 拉取使用每次尝试 180 秒的有界超时,以便卡住的流快速重试,而不是消耗 CI 关键路径的大部分时间。在计划验证成功后,openclaw-scheduled-live-checks.yml 将不可变的已测试镜像清单传递给独立的 package-write 发布者;只读 release 和 prerelease 调用方从不经过该 writer。
发布路径分块¶
Release Docker 覆盖运行更小的分块作业,并设置 OPENCLAW_SKIP_DOCKER_BUILD=1,使每个分块只校验并加载其所需的工件支持的镜像类型(或在显式 existing-only 复用时拉取它),并通过同一加权调度器执行多个 lane:
OPENCLAW_DOCKER_ALL_PROFILE=release-pathOPENCLAW_DOCKER_ALL_CHUNK=core | package-update-openai | package-update-restart-auth | package-update-onboarding | package-update-migrations | package-update-self-upgrade | plugins-runtime-plugins | plugins-runtime-services | plugins-runtime-install-a..h | openwebui
当前 release Docker 分块为 core、package-update-openai、package-update-restart-auth、package-update-onboarding、package-update-migrations、package-update-self-upgrade、plugins-runtime-plugins、plugins-runtime-services、从 plugins-runtime-install-a 到 plugins-runtime-install-h,以及 openwebui。package-update-openai 包含 live Codex 插件包 lane,它会安装候选 OpenClaw 包,从 codex_plugin_spec 或同引用 tarball 安装 Codex 插件(需显式批准 Codex CLI 安装),运行 Codex CLI 预检和同会话 agent 轮次,然后运行一个零重试的 medium-thinking 轮次,该轮次发送进度、读取随机化的工作区输入、写入其精确工件,并发送完成。plugins-runtime-core、plugins-runtime 和 plugins-integrations 仍然是聚合的插件/运行时别名。install-e2e lane 别名仍然是两个 provider 安装器 lane 的聚合手动重跑别名。
stable/full Docker core 分块包含 live-anthropic-cache。它通过候选包的 Anthropic provider 和托管传输发送八个有界请求,在临时运行时上下文越过两个真实工具结果和随后的用户轮次时检查会话缓存复用。缺少凭据、缓存标记不正确、缓存前缀变化或重复写入历史都会使 lane 失败且不重试。这补充了基于源码的 live 缓存下限;它不执行 Gateway 会话调度。调度器为该 lane 声明 anthropic-api-key,并且完整分块和定向 lane 的预检都特别要求 ANTHROPIC_API_KEY;OAuth 凭据仍被其他支持它的 Anthropic lane 接受。
首跳兼容 lane 共享 3,200 秒的内部容器预算和 3,500 秒的外部 lane 预算。托管 4-vCPU 运行 36506342273 在最终候选跳之前花费了约 1,558 秒;该跳另需 560 秒,断言约需 5 秒,预计完整 lane 约 2,125 秒。约 1.5 倍的慢速主机余量给出 3,200 秒,另有 300 秒用于主机侧工作。定向运行测量到每次更新约 540–720 秒;每个 lane 执行多次更新,因此这不是完整 lane 时长。在不变的 npm 权重上限五下,首跳 lane 权重为二,一次最多允许两个,以减少 npm 和磁盘争用。20 分钟、权重三的 survivor 可以与一个首跳 lane 重叠。self-upgrade 作业允许 210 分钟:三个 3,500 秒波次加上为 survivor 保守预留的 20 分钟以及为设置和工件预留的 10 分钟,总计 205 分钟,向上取整。定向首跳作业保留其 60 分钟作业预算。阶段和更新步骤时长会打印在 lane 日志中。
认证更新重启使用 3,420 秒容器预算和 3,720 秒(62 分钟)lane 预算。10 月 6–7 日的托管 release 检查在 1,678–2,290 秒内通过,并在恢复期间也触及了旧的 2,280 秒容器上限。对 2,290 秒应用约 1.5 倍的慢速主机余量得到 3,420 秒,另有 300 秒用于主机侧工作。其重启命令在托管运行 36506210440 中耗时 856 秒,在四核 Crabbox 上耗时 993 秒;993 × 1.5 给出 lane 特定的 1,500 秒命令超时。共享的 900 秒命令默认值保持不变。独立的 package-update-restart-auth 作业允许 75 分钟,与定向 restart-auth 作业一致,并在 lane 预算之外为设置和工件留出 13 分钟。其余 package-update-openai 作业允许 60 分钟。这些外层预算不会解决在重启后的 Gateway 变为健康后仍保持 pending 的恢复命令。
提供商中立的包检查运行在三个均衡的行中:入门和安装切换、通道/已发布迁移,以及自升级。这避免了将八个 npm 密集型通道串行化在一个 runner 的 npm 资源限制之后。聚合的 package-update-core 和 package-update 名称仍可用于手动运行。package-update-openai 行还会运行 root 管理的 VPS 升级;package-update-restart-auth 负责已认证更新重启证明。调度器资源限制保持不变。凭据预检失败仍会阻塞,同时以下诊断池会排空非实时通道;更早的设置失败和取消仍会阻止执行。
OpenWebUI 作为独立的 openwebui 块,在专用大磁盘 Blacksmith runner 上运行,只要稳定版或完整发布路径覆盖需要它,即使可复用工作流将受支持的作业路由到 GitHub 托管 runner。保持外部镜像拉取独立,可防止大型镜像与 plugins-runtime-services 中的共享包和插件镜像竞争;旧版聚合插件/运行时块仍包含 OpenWebUI,以兼容手动重跑。Bundled-channel 更新通道会针对瞬时 npm 网络故障重试一次。
每个块都会上传 .artifacts/docker-tests/,其中包含通道日志、计时、summary.json、failures.json、阶段计时、调度器计划 JSON、慢速通道表格以及每个通道的重跑命令。工作流 docker_lanes 输入会针对为该次运行准备好的镜像运行所选通道,而不是运行块作业,这将失败通道调试限制在一个目标 Docker 作业内;如果所选通道是实时 Docker 通道,目标作业会为此次重跑在本地构建实时测试镜像。重跑辅助工具会验证失败工件的精确所选目标 SHA,手动分发会重新打包该 ref,因为内部可复用工作流包元组不属于 workflow_dispatch 模式。生成的命令仅当这些输入由 GHCR 支持时,才包含准备好的镜像输入和 shared_image_policy=existing-only;会省略 runner 本地工件标签,以便全新 runner 重新构建它们。显式目标覆盖会丢弃恢复的 GHCR 镜像 ref,除非工件证明它们与覆盖匹配。工件生成的工作流定义 ref 也会被省略,因为完整发布的临时分支会被删除;除非操作员显式覆盖,否则分发使用仓库默认分支。
pnpm test:docker:rerun <run-id> # download Docker artifacts and print combined/per-lane targeted rerun commands
pnpm test:docker:timings <summary> # slow-lane and phase critical-path summaries
计划运行的实时/E2E 工作流每天运行完整发布路径 Docker 套件,并在其成功后,针对确切测试过的镜像工件调用显式发布者。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw