Skip to content

从 cloudflare pages 迁移到 cloudflare worker

这个过程很折腾,之前已经有了 cloudflare page 服务,现在(2025-6-17)新建一个 page 时,必须要以 worker 的形式新建了。

在 monorepo 内部署一个简单的 page 页面

迁移注意事项:

  • 初始化包管理器 pnpm
  • 设置部署目录
  • 设置 wrangler 的其他配置

构建命令

bash
pnpm i && pnpm run build:docs:01star

目前 cloudflare worker 用的是默认包管理器和环境都是 bun,被构建页面的项目是 monorepo+pnpm 项目。所以需要初始化 pnpm 管理器。

但实际操作的时候,cloudflare 的云环境是包含有 pnpm 的,所以直接安装依赖即可。

安装完依赖,就直接打包项目。这里是专门在 monorepo 的根包内暴露出一个命令,来构建子包的页面。

部署命令

bash
npx wrangler deploy --assets=./docs/docs-01-star/docs/.vitepress/dist --compatibility-date 2025-06-15

设置好部署的静态资产位置,在部署 page 时,需要指定静态文件的位置,故需要设置 --assets 参数。

wrangler 还要求必填 --compatibility-date 参数。

这些可以在 wrangler 配置文件内完成配置。但是目前在 monorepo 内,不好实现 page 项目的分治处理,故不打算配置 wrangler.toml。就和之前给 monorepo 配置 vercel.json 一样。

构建监视路径

txt
docs/docs-01-star/*

在 monorepo 内,为了避免重复构建,实现有针对性的构建,这里配置目标的文件夹目录。

注意,这里并不是写 glob 语法。

贡献者

The avatar of contributor named as ruan-cat ruan-cat

页面历史