Cloudflare
历史版本
从0.5迁移到0.6

从 0.5 迁移到 0.6 版本

@opennextjs/cloudflare@0.6.0 引入了更多缓存选项。

代码库进行了重构,包含一些破坏性变更,请阅读以下内容来更新您的应用:

覆盖文件位置变更

Cloudflare 的覆盖文件现在位于 @opennextjs/cloudflare/overrides

  • 增量缓存覆盖:@opennextjs/cloudflare/overrides/incremental-cache/...
  • 标签缓存覆盖:@opennextjs/cloudflare/overrides/tag-cache/...
  • 队列覆盖:@opennextjs/cloudflare/overrides/queue/...

例如,KV 增量缓存覆盖现在可以通过 @opennextjs/cloudflare/overrides/incremental-cache/kv-incremental-cache 导入。

环境变量和绑定

我们更新了名称以保持一致性:

  • NEXT_CACHE_WORKERS_KV -> NEXT_INC_CACHE_KV
  • NEXT_CACHE_R2_... -> NEXT_INC_CACHE_R2_...
  • NEXT_CACHE_D1 -> NEXT_TAG_CACHE_D1
  • NEXT_CACHE_DO_... -> NEXT_TAG_CACHE_DO_...
  • NEXT_CACHE_DO_REVALIDATION -> NEXT_CACHE_DO_QUEUE
  • NEXT_CACHE_REVALIDATION_WORKER -> WORKER_SELF_REFERENCE

移除了 NEXT_CACHE_D1_TAGS_TABLENEXT_CACHE_D1_REVALIDATIONS_TABLE。 D1 表现在使用固定名称 tagsrevalidations

CLI 变更

CLI 之前通过 opennextjs-cloudflare 调用,现在需要指定强制命令:

  • opennextjs-cloudflare build 等同于之前执行 opennextjs-cloudflare
  • opennextjs-cloudflare populateCache local 用于填充 localremote 缓存
  • opennextjs-cloudflare preview 用于填充本地缓存并启动开发服务器
  • opennextjs-cloudflare deploy 用于填充远程缓存并部署

您需要更新 package.json 中的 scripts

"preview": "opennextjs-cloudflare build && opennextjs-cloudflare preview",
"deploy": "opennextjs-cloudflare build && opennextjs-cloudflare deploy",