跳转到正文

English core guides · 历史记录保留中文

决策 002:基础设施与应用发布分工 ​

状态: 已采纳。日期: 2026-08-09。

问题 ​

上游配置曾让 Terraform 和 Wrangler 同时管理 Worker 字段,部署工具相互覆盖,名称规则也需要两套配置同步。空 Worker 占位没有必要,因为应用部署可创建服务。

决策 ​

Terraform 只管理依赖资源:每个环境的两个 Hyperdrive,以及按需启用的上传存储桶。Wrangler 管理 Worker 名称、代码、静态资源、路由、域名、绑定、变量和应用秘密,同一字段不交给两个工具。

公开主机通过 Worker 自定义域名配置,基础设施无需同时管理相同 DNS。工具之间只传递非秘密的资源标识,例如 Hyperdrive ID 和存储桶名称。

备选方案 ​

Terraform 同时发布代码会使应用更新依赖基础设施变更,并复制 Wrangler 配置。只用命令创建依赖更简单,但缺少声明式重建和差异检查。按路径拆分同一主机的多个入口时,可重新选择路由和 DNS 方案。

影响 ​

应用发布不执行 Terraform,基础设施令牌只授予必要资源权限。代价是每个环境需要把生成的资源 ID 写入对应 Wrangler 配置,自定义域名方案也有主机归属限制。

上传基础设施可选配置不代表主站已经实现上传。参见 文件上传 和 基础设施规格。

供语言模型读取:llms.txt · llms-full.txt
采用 MIT 许可证。