15
Cloudflare · workflow

cloudflare-deploy-runtime-smoke

15-cloudflare-deploy-runtime-smoke.md
☁️
P1 source: codex-sessions created: 2026-06-13
◉

WHAT IS THIS

定位

Cloudflare 部署和真实运行时 smoke workflow。它检查的不只是 wrangler deploy 成功，而是线上路由、R2 内容、DNS、浏览器 hydration、console/network 是否真的工作。

⚡

TRIGGERS

触发场景
▸Workers、Pages、R2、D1、KV、DNS、route 有改动。
▸静态站部署到 Worker/R2。
▸docs site、SPA、TanStack/Fumadocs 等存在客户端运行时。
▸部署成功但线上返回旧页面或 error boundary。
▸需要确认“部署成功”和“用户路径可用”是否一致。
↹

INPUT & OUTPUT

输入 / 产出
↘ INPUT
  • wrangler.jsonc
  • deploy script。
  • Cloudflare account、zone、route、bucket。
  • 本地 build command。
  • 关键线上 URL。
  • 浏览器 smoke 路径。
↗ OUTPUT
  • 部署前检查报告。
  • 部署日志摘要。
  • Runtime smoke 报告。
  • 失败根因和修复 patch。
🪜

STEPS

编排步骤
  1. 1
    读部署配置
    确认 Worker 名、route、bucket、compatibility date、bindings。
  2. 2
    检查资源存在
    查 R2 bucket、Worker、DNS record、route 权限。
  3. 3
    本地 build
    先跑 build，确认产物和 manifest。
  4. 4
    部署
    执行 deploy，记录 Worker version、uploaded assets、route 状态。
  5. 5
    HTTP smoke
    用 curl 检查根路径、关键页面、headers、status。
  6. 6
    浏览器 smoke
    用浏览器点击关键路径，抓 console、network、runtime error。
  7. 7
    双视口验证
    桌面和移动至少各一条主路径。
  8. 8
    根因分层
    失败时按 build、upload、Worker、route、DNS、runtime、client hydration 分层排查。
  9. 9
    判定适用边界
    如果目标不是 Cloudflare，而是 Electron、desktop renderer、local executor 或登录回调，转 →#22。如果目标是 agent tool 已成功但最终文案失败，转 →#19。
⚙

AGENT ROLES

Agent 分工
⚙
Config Agent
读 Wrangler 和资源。
⚙
Deploy Agent
执行部署。
⚙
Infra Verifier
查 Worker/R2/DNS/route。
⚙
Browser Verifier
抓 console/network。
⚙
Fix Agent
修代码或配置。
✓

ACCEPTANCE GATE

验收 gate
⊘

FAILURE HANDLING

失败处理
⊘
deploy 成功但线上旧页，优先查 route 和 DNS。
⊘
HTML 正确但点击后 error boundary，优先查客户端 runtime request。
⊘
wrangler 报 CLI 内部错但 version 已上传，查 deployment list，不直接重试覆盖。
⊘
token 权限不足时，明确缺哪个权限，不绕过。
⊘
线上 smoke 通过但业务状态没有变化时，不把它记为通过，补业务层状态验证或转 contract/runtime workflow。
⌘

TEMPLATE

smoke 模板
TEMPLATE
## Cloudflare Runtime Smoke

- Worker:
- Version:
- Route:
- DNS:
- Root URL:
- Key paths:
- Console errors:
- Network errors:
- Result: