决策 002:基础设施与应用发布分工
状态: 已采纳。日期: 2026-08-09。
问题
上游配置曾让 Terraform 和 Wrangler 同时管理 Worker 字段,部署工具相互覆盖,名称规则也需要两套配置同步。空 Worker 占位没有必要,因为应用部署可创建服务。
决策
Terraform 只管理依赖资源:每个环境的两个 Hyperdrive,以及按需启用的上传存储桶。Wrangler 管理 Worker 名称、代码、静态资源、路由、域名、绑定、变量和应用秘密,同一字段不交给两个工具。
公开主机通过 Worker 自定义域名配置,基础设施无需同时管理相同 DNS。工具之间只传递非秘密的资源标识,例如 Hyperdrive ID 和存储桶名称。
备选方案
Terraform 同时发布代码会使应用更新依赖基础设施变更,并复制 Wrangler 配置。只用命令创建依赖更简单,但缺少声明式重建和差异检查。按路径拆分同一主机的多个入口时,可重新选择路由和 DNS 方案。
影响
应用发布不执行 Terraform,基础设施令牌只授予必要资源权限。代价是每个环境需要把生成的资源 ID 写入对应 Wrangler 配置,自定义域名方案也有主机归属限制。