从 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_TABLE
和 NEXT_CACHE_D1_REVALIDATIONS_TABLE
。
D1 表现在使用固定名称 tags
和 revalidations
。
CLI 变更
CLI 之前通过 opennextjs-cloudflare
调用,现在需要指定强制命令:
opennextjs-cloudflare build
等同于之前执行opennextjs-cloudflare
opennextjs-cloudflare populateCache local
用于填充local
或remote
缓存opennextjs-cloudflare preview
用于填充本地缓存并启动开发服务器opennextjs-cloudflare deploy
用于填充远程缓存并部署
您需要更新 package.json
中的 scripts
:
"preview": "opennextjs-cloudflare build && opennextjs-cloudflare preview",
"deploy": "opennextjs-cloudflare build && opennextjs-cloudflare deploy",