Hotdry.
归档
ai-systems

用 Cloudflare 全栈落地高可用 vibe-coding 平台：提示即代码与边缘部署一体化

基于 VibeSDK 与 Cloudflare 边缘原生服务，给出可扩展的 vibe-coding 平台架构、灰度与回滚参数，以及生产级部署清单。

要让「一句话生成可用应用」真正落地，必须在「AI 生成」与「生产部署」之间打通一条零摩擦通道。Cloudflare 开源的 VibeSDK 把整条链路搬到了边缘：提示→AI 代理→分阶段代码生成→容器沙箱预览→一键推送到 Workers for Platforms。本文基于官方实现，给出可直接套用的架构要点、性能参数与灰度回滚策略，帮助你在 30 分钟内跑出第一个可扩展的 vibe-coding 平台。

整体架构：边缘原生 + 租户级隔离

VibeSDK 把「平台控制面」与「用户生成面」彻底分离：

  1. 控制面（Platform Worker）

    • 负责登录、鉴权、模板仓库、AI Gateway 统一计费。
    • 跑在标准 Workers，支持 Gradual Deployment，可回滚 100 个历史版本。

  2. 生成面（User App Workers）

    • 每生成一次应用，即在 dispatch namespace 内创建独立 Worker，天然租户隔离。
    • 资源配额受 SANDBOX_INSTANCE_TYPE 控制，默认 standard-3（2 vCPU / 12 GiB / 16 GB 磁盘）。

  3. 数据面

    • 元数据：D1（SQLite），单表上限 10 万行 / 1 GB，已足够存放百万级项目索引。
    • 文件：R2 桶按 app-id/ 前缀隔离，模板与构建缓存分离存储。
    • 会话：KV 存 WebSocket 句柄，TTL 设为 3600 s，避免 Durable Objects 常驻内存溢出。

  4. AI 执行层

    • 通过 AI Gateway 统一调用 Gemini/Anthropic/OpenAI，默认超时 30 s；若首 token > 5 s 即触发降级切换模型。

生成流程：五阶段迭代与错误自愈

AI 代理把单次需求拆成 5 个原子阶段，每阶段输出文件集合与校验报告：

  • Plan：输出 blueprint.json，含依赖拓扑与文件哈希。
  • Foundation：生成 package.json、锁文件与 .dev.vars 模板。
  • Core：完成 React 路由、核心 hooks、类型声明。
  • Style：注入 Tailwind 主题变量，输出 global.css。
  • Optimize：运行 ESLint + tsc，若出现 Error 则回退到上一阶段并补全缺失依赖；连续 3 次失败即转人工审核。

阶段产物先写入 D1 的 builds 表（status=running），全部校验通过后再把状态置为 success，并触发容器镜像构建；如某阶段失败，平台自动把日志与 diff 返回前端，用户可在聊天窗口继续迭代。

沙箱与性能：容器实例选型与并发上限

Cloudflare Containers 提供 5 档性能：

类型 vCPU 内存 磁盘 并发建议 场景
lite 1/16 256 MiB 2 GB ≤5 体验 / 内测
standard-1 1/2 4 GiB 8 GB ≤20 轻量生产
standard-3 2 12 GiB 16 GB ≤100 默认推荐
standard-4 4 12 GiB 20 GB ≤200 高 CPU 场景
  • 环境变量：SANDBOX_INSTANCE_TYPE=standard-3（部署时作为 Build Var 注入）。
  • 并发上限：MAX_SANDBOX_INSTANCES=100，与 CPU 核数 1:1 配比，防止 OOM。
  • 冷启动：容器首次拉起约 800 ms，后续请求复用实例，P99 响应 <120 ms。

灰度与回滚：Gradual Deployment + 自动熔断

平台 Worker 作为入口，必须支持热升级。Cloudflare 原生提供 Gradual Deployments，可直接在 Wrangler 3.40+ 使用：

# 发布新版本但不全量
wrangler versions upload

# 5% 流量灰度，10 分钟后自动检查指标
wrangler deployments create --version-id=<new> --percent=5

# 若错误率 >1% 或 p99 延迟上涨 >20%，立即回滚
wrangler rollback --version-id=<old>

建议分四阶段：5%→25%→50%→100%，每阶段观察 10 min；若任意指标触发阈值即自动回退。用户生成的 Worker 无需灰度，因为每个应用已处于独立 dispatch namespace，天然具备单元级隔离。

生产级部署清单

  1. 账号准备

    • Workers Paid 计划（≥50 USD / 月）（必需）
    • Workers for Platforms 订阅（按容器实例计费）
    • Advanced Certificate Manager（若使用一级子域 *.code.example.com）

  2. DNS 预置 在目标 Zone 添加两条记录：

    A     code.example.com     192.0.2.1  Proxied
CNAME *.code              code.example.com  Proxied

    其中 192.0.2.1 为占位 IP，Cloudflare 会自动颁发通配符证书。

  3. 密钥与变量（按优先级排列）

    • Build Variables（Dashboard 设置）
      • GOOGLE_AI_STUDIO_API_KEY：必需，AI 主模型
      • SANDBOX_INSTANCE_TYPE=standard-3
      • MAX_SANDBOX_INSTANCES=100
    • Worker Secrets（wrangler secret put）
      • JWT_SECRET：≥32 位随机串
      • SECRETS_ENCRYPTION_KEY：用于加密用户 OAuth Token
      • WEBHOOK_SECRET：GitHub 导出回调验签

  4. 监控与告警

    • Workers Analytics Engine 记录 ai_generate_duration、sandbox_cold_start 两条自定义指标。
    • 错误率 >1% 或冷启动 >1 s 即触发 PagerDuty；灰度阶段若连续 3 个采样点异常即自动回滚。

  5. 成本预估（月 1 万次生成，平均单次 3 min）

    • 容器费用：standard-3 × 100 并发 × 0.05 USD / 小时 × 150 小时 ≈ 750 USD
    • AI Gateway 调用：Gemini 1.5 Pro 输入 8k tokens × 1 万次 × 0.0025 USD/1k ≈ 200 USD
    • 合计 ≈ 950 USD，折合单次生成 0.095 USD，随并发线性扩展。

小结

VibeSDK 把「提示即代码」拆成可观测、可回滚、可并发的边缘流水线：Durable Objects 保存 AI 状态，容器沙箱保证安全，dispatch namespace 实现租户隔离，Gradual Deployment 负责平台层灰度。只要按上文参数设置实例规格、并发上限与回滚阈值，你就能在 30 分钟内交付一个可横向扩展、生产可用的 vibe-coding 平台 —— 让业务人员自己「说」出工具，而工程师专注在平台本身的高可用与成本优化。

资料来源

  • Cloudflare VibeSDK 官方仓库与部署文档，2025-12
  • Cloudflare Docs «Gradual deployments»，2025-11
  • Cloudflare Changelog «Worker version rollback limit increased from 10 to 100»，2025-09
查看归档