Static Assets を使って Cloudflare Workers で Remix を動かす(二重ビルド無し)

Cloudflare Workers の Static Assets

https://developers.cloudflare.com/workers/static-assets/

Cloudflare Workers の Static Assets 対応によって、Cloudflare Pages を使わなくとも、静的コンテンツ配布時にリクエスト回数を消費せずに済むようになりました。これによって Remix を Cloudflare で使用する場合に、Pages を使わなければならない理由が減りました。対応機能の面で見れば、Pages から Workers に移行するメリットが増えたと言えるでしょう。

Cloudflare 公式の Remix テンプレートを使うと二重ビルドが発生する

https://developers.cloudflare.com/workers/frameworks/framework-guides/remix/

上記の Cloudflare の公式テンプレートを使うと、Remix を Vite でビルドした後、さらに Pages 用のコードを Workers に変換するため二重にビルドする処理が生成されます。最初から Workers 用のコードを作っておけばこの処理は不要です。今回は、Workers 対応のコードを作る形で進めます。

Workers で Remix を動かす

今回のコードのリポジトリ

https://github.com/SoraKumo001/cloudflare-workers-remix

• wrangler.toml

公式のテンプレートを使うとmain = "./build/worker/index.js"という記述になっています。これは一度 vite でビルドし、さらに wrangler で [[path]].ts をビルドして生成するものです。今回は[[path]].tsを直接呼び出すようにしています。正確に言うと直接呼び出しているように見えるファイルも、実際には wrangler が内部で esbuild していますが、そこはスルーしてください。

https://github.com/cloudflare/workers-sdk/blob/main/packages/create-cloudflare/templates-experimental/remix/templates/wrangler.toml

重要な点としては、assets = { directory = "./build/client" }で静的コンテンツのディレクトリを指定しています。これによって、静的コンテンツを Workers で配布することができます。

1#:schema node_modules/wrangler/config-schema.json
2name = "cloudflare-workers-remix"
3compatibility_date = "2024-09-25"
4main = "./functions/[[path]].ts"
5assets = { directory = "./build/client" }
6
7[observability]
8enabled = true

• functions/[[path]].ts

ファイル名は wrangler.toml の main に指定したファイル名と一致させれば、この名前である必要はありません。
公式テンプレートだと @remix-run/cloudflare-pages を使っており、これをさらにビルドする方式になっているので、@remix-run/cloudflare の方を使用して、fetch をエクスポートすることにより ./functions/[[path]].ts を wrangler から直接呼び出せるようにしています。

getLoadContext の処理を行う場合は、handler 実行直前の位置に置けば同様の結果が得られます。

1import {
2  AppLoadContext,
3  createRequestHandler,
4  ServerBuild,
5} from "@remix-run/cloudflare";
6import * as build from "../build/server";
7
8const handler = createRequestHandler(build as ServerBuild);
9
10const fetch = async (
11  request: Request,
12  env: AppLoadContext,
13  ctx: ExecutionContext
14) => {
15  return handler(request, {
16    cloudflare: {
17      env,
18      ctx: {
19        waitUntil: ctx.waitUntil ?? (() => {}),
20        passThroughOnException: ctx.passThroughOnException ?? (() => {}),
21      },
22      cf: request.cf!,
23      caches,
24    } as never,
25  });
26};
27
28export default {
29  fetch,
30};

• package.json の scripts

公式テンプレートだと二重ビルドしていますが、今回は vite のビルド一回だけで済んでいます。

1  "scripts": {
2    "build": "remix vite:build",
3    "deploy": "pnpm run build && wrangler deploy",
4    "dev": "remix vite:dev",
5    "start": "wrangler dev",
6  },

まとめ

既存のプロジェクトの場合も必要な場所だけ置き換えれば、比較的簡単に Pages から Workers へ移行することが可能です。今後の開発では機能的メリットを考えると、 Pages を使う理由は少なそうです。