Cloudflareで新しくサイトを作るなら、いまはWorkersを選ぶのが素直です。Cloudflare自身が「新規プロジェクトはPagesではなくWorkersで」と案内していて、PagesからWorkersへの移行ガイドも用意しています。
ただ、Pagesで動いている静的サイトを急いで移す必要はありません。私のブログ2つはPagesのままで、困っている点はいまのところありません。
管理画面で「Workers & Pages」と同じ場所に並んでいるのに、作り始めると設定ファイルもコマンドも違う。迷うのは当然です。
比べる軸は、静的ファイルの配信・サーバー側の処理・Git連携とプレビュー・無料枠・カスタムドメイン・wranglerの6つです。どんなときにどちらを選ぶかは、Pagesで2サイトを動かしている立場から書きます。
この記事でわかること
- Cloudflare PagesとWorkersの違いを6つの軸で並べた早見表
- Cloudflareが新規プロジェクトにWorkersを勧めている理由と、Pagesの今後
- Pages FunctionsとWorkersのスクリプトの書き方・無料枠の数え方の違い
- 外部DNSのドメインを使うならPagesが残る理由
- wranglerのコマンドの対応表と、PagesからWorkersへ移る手順
PARTS LIST /目次
Cloudflare PagesとWorkersの違いを先に結論から
Cloudflare Pagesは「Gitにつないで静的サイトを出す」ための製品です。Workersは「エッジ(利用者に近いCloudflareのサーバー)でプログラムを動かす」ための製品として始まりました。いまはWorkersに静的ファイルを配信する機能(Workers Static Assets)が入り、できることの多くが重なっています。
重なった結果、Cloudflareは新しい機能をWorkers側に集める方針を出しました。迷う理由は「機能の差」より「どちらに乗っておけば後で困らないか」のほうにあり、その答えはCloudflare自身が出しています。
Cloudflareは新規プロジェクトにWorkersを勧めている
CloudflareのWorkersのベストプラクティスのページは、はっきりした書き方です。新しいプロジェクトを始めるなら、PagesではなくWorkersを使うように、とあります。
同じページで、Workers Static Assetsは静的サイトを出すときの推奨の方法とも書かれています。Pagesを選ぶ理由は、少なくとも「新しく作るから」では見つけにくくなりました。
新規はWorkers、既存のPagesは動き続ける。Cloudflareの案内はこの2行に集約されます。
Pagesはなくならないが、新機能はWorkers側に来る
Pagesの終了は発表されていません。ベストプラクティスのページでも、Pagesは引き続き動くとしたうえで、新しい機能と最適化はWorkersに集中させると書いています。
実際、2026年9月22日に出た「Worker Previews」(ブランチごとのプレビュー環境)はWorkersの機能です。Pagesでは前からあったプレビューの仕組みを、Workers側で作り直した形です。
つまりPagesは「止まりはしないが、伸びもしない」側に回りました。今日動いているサイトに影響はなくても、3年後に欲しくなる機能はWorkersにしか来ない、と考えておくのが無難です。
6つの軸で見るPagesとWorkersの早見表
6つの軸で並べると、違いが出るのは「サーバー側の処理」「プレビュー」「ドメイン」の3つです。静的ファイルの配信と無料枠の考え方は、ほぼ同じです。
Cloudflare PagesとWorkersの違い(移行ガイドの対応表と、各製品の上限・料金のページから整理)
静的ファイルの配信はPagesもWorkersも無料・無制限
HTML・CSS・画像のような静的ファイルを返すだけなら、PagesでもWorkersでもお金はかかりません。どちらの料金のページにも、静的ファイルへのリクエストは無料で無制限と書かれています。
ファイル数の上限も、無料プランなら両方とも20,000個、1ファイル25MiBまでです。ブログを出すだけなら、枠の広さで選ぶ理由はありません。違いが出るのは、配信の「設定の書き方」です。
Workers Static Assetsとは何か
Workers Static Assetsとは、HTML・CSS・画像などのファイルをWorkerと一緒にアップロードする機能です。配信とキャッシュは、Cloudflareが受け持ちます。
リクエストが来ると、まずアップロードしたファイルの中から一致するものを探します。見つかればWorkerのコードは動かずにファイルを返し、見つからなければWorkerのスクリプトに回します。スクリプトが無ければ404です。
この順番のおかげで、静的なページへのアクセスは無料のまま、動的な処理だけがWorkersの枠を使います。Pagesの「静的ファイル+Functions」と、考え方は同じです。
ファイルに一致したリクエスト
Workerのコードは動かない。無料・無制限で、1日10万リクエストの枠も減らない
一致しなかったリクエスト
Workerのスクリプトに回る。ここから先はWorkersの料金と上限で数える
_headersと_redirectsはWorkersでもそのまま使える
Pagesで使っている _headers(レスポンスヘッダーの設定)と _redirects(転送の設定)は、Workers Static Assetsでもそのまま読まれます。置き場所は、配信するファイルのフォルダの中です。
私のブログでも、_headers にセキュリティヘッダーやキャッシュの設定を、_redirects にWordPress時代のURLの転送を書いています。転送のルールは86行あります。書き直しになると気が重い量ですが、ファイルごと持っていけるのは助かるところです。
上限はPagesでは _headers が100ルール、_redirects が静的2,000本・動的100本です。転送ルールの数の実数と余裕は、Cloudflare Pagesの無料枠の記事にまとめました。
404ページとSPAは自分で指定する
PagesとWorkersで地味に違うのが、存在しないURLへの答え方です。Pagesは 404.html があるかどうかを見て、自動で振る舞いを決めていました。Workersでは設定ファイルで指定します。
not_found_handling: "404-page": いちばん近い404.htmlを、ステータス404で返す(ブログ向け)not_found_handling: "single-page-application": 一致しないURLにもindex.htmlをステータス200で返す(ReactなどのSPA向け).assetsignoreを置く:node_modules・.DS_Store・.gitをアップロードから外す(Pagesは自動で外していた)
ブログを移すときに not_found_handling を書き忘れると、存在しないページの答え方がPagesのときと変わってしまいます。ソフト404で検索の評価を落とすのは避けたいので、移行の手順にも入れておきました。
サーバー側の処理:Pages FunctionsとWorkersの違い
動的な処理の書き方は、PagesとWorkersでいちばん差が出るところです。Pages Functionsはフォルダの構造で書き、Workersは1本のスクリプトに書きます。
どちらも中で動いているのはWorkersの仕組みで、料金もWorkersとして数えます。違うのは「書き方」と「使える機能の幅」です。お問い合わせフォームやAPIを1〜2本足したいだけなら、書き方の好みで選んでも困りません。
Pages Functionsはfunctionsフォルダの形がURLになる
Pages Functionsは、プロジェクトの functions フォルダに置いたファイルの場所が、そのままURLになります。/functions/helloworld.js なら example.com/helloworld で動く、という具合です。
// functions/api/hello.js → /api/hello で動く
export function onRequest(context) {
return new Response("hello");
}
ファイルを置くだけでURLが決まるのは、Next.jsのページの置き方に近くて覚えやすい作りです。
注意したいのは、functions フォルダがあると、何も指定しない限りすべてのリクエストでFunctionsが呼ばれる点です。静的なページのアクセスまで枠を食わないように、_routes.json で動かすパスを絞ります(include・excludeの合計100ルールまで)。
Workersは1本のスクリプトで受ける
Workersでは、main に指定した1本のスクリプトがリクエストを受けます。URLごとの振り分けは自分で書くか、Honoのようなルーターを使います。
// src/index.js(wrangler.jsonc の main に指定する)
export default {
async fetch(request, env) {
const url = new URL(request.url);
if (url.pathname === "/api/hello") {
return new Response("hello");
}
return env.ASSETS.fetch(request); // それ以外は静的ファイルへ
},
};
最後の env.ASSETS.fetch は、静的ファイルを返すための入り口です。Pagesでは自動で用意されていましたが、Workersでは設定ファイルの assets に "binding": "ASSETS" を書いたときだけ使えます。
書く量はPages Functionsより少し増えます。その代わり、Workersにしかない機能がそのまま使えます。
PagesとWorkersで使える機能の違い(移行ガイドの対応表から抜粋)
無料枠は1日100,000リクエストを共有する
動的な処理の無料枠は、PagesとWorkersで別々ではありません。Pages Functionsへのリクエストは、Workersの無料プランの枠(1日100,000リクエスト、1回あたりCPU時間10ミリ秒)から引かれます。数え直しは毎日UTCの0時、日本時間の朝9時です。
Workers側で枠を超えたときの動きは、設定によって変わります。run_worker_first で「先にWorkerを通す」と決めたパスは、無料枠を超えると静的ファイルに逃げず、429(Too Many Requests)を返します。
run_worker_first は、認証チェックなど「ファイルを返す前に必ず通したい」処理のための設定です。全パスに付けると、ただのHTMLのアクセスまでWorkerが動き、1日10万リクエストの枠から引かれます。無料枠を超えた日は、ブログ記事まで429で開けなくなります。付けるパスは絞り、静的なパスは先頭に「!/」を付けた除外パターンで外しておきます。
有料のWorkers Paidは月5ドルからです。月1,000万リクエストとCPU時間3,000万ミリ秒が含まれ、超えた分は100万リクエストごとに0.30ドルかかります。Workersの料金のページで、使う前に一度見ておくと安心です。
Git連携とプレビュー環境の違い
GitHubにpushしたら自動で出る、という使い方は両方でできます。差が出るのは、本番に出す前のプレビューの作り方と、ビルドの無料枠の数え方です。
Pagesは「ブランチを切ればプレビューが勝手にできる」手軽さが売りでした。Workersは2026年9月にPreviewsが入り、ようやく同じことができます。ただ、手軽さはまだPagesのほうが上です。
Pagesはブランチごとに自動でプレビューができる
PagesをGitHubかGitLabにつなぐと、本番以外のブランチにpushするたびにプレビュー用のURLができます。URLはコミットごとの <ハッシュ>.<プロジェクト名>.pages.dev と、ブランチ名の別名の2種類です。プルリクエストにもURLが貼られます。
プレビューは何も設定しないと誰でも開けます。見せたくない場合は、プロジェクトの設定からCloudflare Accessで閲覧を制限します。
注意点が1つあります。Pagesのプロジェクトは、作るときに「Git連携」か「直接アップロード(Direct Upload)」かを選び、あとから切り替えられません。直接アップロードで作ったプロジェクトをGit連携にしたくなったら、プロジェクトを作り直すことになります。
WorkersはWorkers BuildsとPreviewsで追いついた
Workersでは、Git連携を「Workers Builds」が受け持ちます。つなげる先はGitHub・GitLab・Cloudflareの Artifacts で、本番以外のブランチのビルドはPreviewを作るか更新します。
Previewsは、ブランチごとに本番と切り離した環境を、同じWorkerの下に作る機能です。URLは <プレビュー名>-<Worker名>.<サブドメイン>.workers.dev か、独自ドメインなら <プレビュー名>.app.example.com の形になります。
Workers Previewsの数と条件
- Workerあたりのプレビュー数は、無料プラン100個・有料プラン500個まで
- 1つのプレビューに残せるデプロイは100回まで
- wrangler 4.135.0以降が必要。手元のwrangler 4.155.0では
wrangler previewがopen beta(公開ベータ)と表示される - プレビューは本番の変数・シークレットを引き継がない。設定ファイルの
previewsブロックに書く
最後の「本番の設定を引き継がない」は、慣れるまで戸惑いそうな点です。Pagesは管理画面で本番用とプレビュー用の設定を分けて持ち、プレビュー用を一度入れればすべてのプレビューに効きます。
WorkersのPreviewsでは、変数は設定ファイルの previews ブロックに書き、シークレットは wrangler preview secret put などのコマンドで入れます。全プレビュー共通の設定(Base config)に入れたシークレットは、そのあとに作ったプレビューにしか効きません。既にあるプレビューで「なぜか動かない」となりやすいところです。
ビルドの無料枠はPagesが月500回、Workersが月3,000分
Cloudflare側でビルドする場合、無料枠の数え方が違います。Pagesは回数、Workers Buildsは時間で数えます。
ビルドの無料枠の比較(Pagesの上限のページとWorkers Buildsの上限と料金のページから)
1回3分のビルドなら、Workers Buildsの3,000分は月1,000回ぶんです。ビルドの短い静的サイトほど、Workers側のほうが回数に余裕があります。
どちらも、手元でビルドしてwranglerで直接アップロードすれば、ビルドの枠は使いません。私のブログはこの出し方です(詳しくは後半で書きます)。
カスタムドメインの違い:外部DNSならPagesが残る
独自ドメインの扱いは、Workersに移れない理由になりうる唯一の項目です。WorkersのカスタムドメインはネームサーバーをCloudflareに向けたドメインでしか使えず、外部のDNSで管理しているドメインには付けられません。
ドメインの登録先とDNSの管理先が別々になっていることは珍しくありません。移行を考える前に、自分のドメインのネームサーバーがどこを向いているかを確かめておきます。
Pagesは外部DNSのサブドメインでも付けられる
Pagesでは、blog.example.com のようなサブドメインなら、ドメインをCloudflareに移さなくても付けられます。外部のDNSにCNAMEレコードを足し、Pagesのプロジェクトを向けるだけです。
example.com のような頂点のドメイン(Apex)は、Pagesでもネームサーバーを Cloudflare に向ける必要があります。
PagesでCNAMEを使うときは、先にPagesの管理画面で「カスタムドメインを追加」を済ませてから、DNSにCNAMEを足します。順番を逆にすると、ドメインが解決できずに522エラーになります。
Workersはネームサーバーを Cloudflare に向けたドメインだけ
Workersでは、Cloudflareに登録したゾーン(ドメイン)に対して、カスタムドメインか「ルート」を設定します。ルートを使うと example.com/app/* のように、サイトの一部のパスだけをWorkerに任せることもできます。
この「一部のパスだけ」はPagesにはできない芸当です。既存のサイトの /api/ だけをWorkerで動かす、という使い方ができます。
Pagesのドメイン
外部DNSのサブドメインにCNAMEで付けられる。頂点のドメインはCloudflareのネームサーバーが必要。サイトの一部のパスだけに割り当てることはできない
Workersのドメイン
ネームサーバーがCloudflareのドメインだけ。その代わり、ルートでサイトの一部のパスだけを任せられる
wranglerの使い方の違い
wranglerはPagesにもWorkersにも使うCloudflareのコマンドラインツールで、1つのパッケージに両方のコマンドが入っています。Pages用のコマンドには pages が付く、と覚えておけばほぼ迷いません。
もう1つの違いは設定ファイルです。Pagesは設定ファイルが無くても出せますが、Workersは wrangler.jsonc(または wrangler.toml)に名前と日付を書くところから始まります。
PagesとWorkersのコマンド対応表
よく使うコマンドを並べると、次のようになります。手元のブログのリポジトリに入っているwrangler 4.155.0で、ヘルプを開いて引数を確かめました。
wranglerのコマンドの対応(Pages用は pages が付く)
バージョンとヘルプの出力は、次のとおりです。
npx wrangler --version
4.155.0
npx wrangler preview --help
wrangler preview [script]
👀 Create a Preview deployment of the current Worker [open beta]
COMMANDS
wrangler preview delete Delete a Preview and all its deployments [open beta]
wrangler preview secret Manage secrets for Worker Previews [open beta]
wrangler preview base-config Manage the Preview base config shared by Worker Previews [open beta]
wrangler deploy --help には --assets(静的ファイルのフォルダを指定する)と --dry-run(アップロードせずに検査だけする)があります。Workersに静的サイトを出すとき、最初に試すならこの2つです。
Workersで静的サイトを出す最小の設定ファイル
静的なファイルだけを出すなら、Workerのスクリプトは要りません。wrangler.jsonc に名前・日付・ファイルの場所を書けば足ります。
{
"name": "my-blog",
"compatibility_date": "2026-11-20",
"assets": {
"directory": "./dist",
"not_found_handling": "404-page"
}
}
compatibility_date は、Workersの動作をどの日付の仕様に合わせるかの指定です。新しいプロジェクトでは今日の日付にしておくと、最新の動作になります。既存のPages Functionsを移す場合は、Pages側で使っていた日付をそのまま使います。
Pagesの設定にあった pages_build_output_dir は、Workersでは assets の directory に置き換わります。
Workersに移ると代わりの手段が要る4つの機能
Workersのほうが機能は多い、と書いてきました。では、Pagesにできて、Workersにできないことはないのでしょうか。
移行ガイドの対応表を1行ずつ見ていくと、「そのままでは使えないが、代わりの手段がある」という印が付いた項目がいくつか残っています。Pagesで当たり前に使っていた機能ほど、移したあとに気づきやすいところです。
Workersで代わりの手段が要る機能(移行ガイドの対応表と、Static Assetsの料金と制限のページから)
Early HintsはLinkヘッダーを自分で送る
Early Hintsとは、HTMLを返す前に「このCSSを先に読んでおいて」とブラウザに知らせる仕組みです。表示の開始を少し早められます。
Pagesでは、何もしなくても使えます。Workersでは、ゾーンの設定でEarly Hintsをオンにしたうえで、Workerが Link ヘッダーを付けて返す必要があります。静的ファイルだけのサイトだと、このためだけにスクリプトを書くことになります。
ブランチごとのデプロイ設定はPagesほど細かくない
Pagesには、どのブランチをビルドするか、プレビューを作るかをブランチ名のパターンで決める設定(Branch Deploy Controls)があります。
Workers Buildsも本番以外のブランチでプレビューのビルドを流せますが、移行ガイドには「Pagesと同じ細かさはまだない」と書かれています。dependabot/* のようなブランチだけ外したい、といった運用をしている場合は、移す前に設定の画面を見比べておきます。
ブランチ名をそのまま好きなホスト名に向ける使い方も、Pagesのほうが自由です。WorkersのPreviewは <プレビュー名>.<ドメイン> の形に決まっています。
Pages Pluginsとファイルの場所でURLを決める書き方
Pages Pluginsは、認証やフォームの受け取りといった処理を、部品として functions に組み込む仕組みです。Workersには同じ名前の仕組みがありません。
既存のコードは、wranglerでPages FunctionsをまとめてWorkerに変換すれば動きます。新しく書き直すなら、自分のWorkerにコードを足すか、フレームワーク向けのプラグインを使います。ファイルの場所でURLを決める書き方が好きなら、移行ガイドが挙げているHonoXのようなフレームワークに移る手もあります。
Rangeリクエストは206ではなく200で返る
細かいところですが、動画や音声を置いているサイトでは効いてきます。Workers Static Assetsは、Range ヘッダー付きのリクエストにも、ファイル全体を 200 OK で返します。206 Partial Content は返らず、Content-Range・Accept-Ranges のヘッダーも付きません。
動画の途中から再生するような使い方では、ブラウザが毎回ファイル全体を受け取ることになります。必要なパスだけ run_worker_first でWorkerに通し、206を自分で返す、というのが案内されている回避策です。
私のブログにも、記事用のmp4の動画ファイルが3つあります。Workersに移すなら、動画の再生とシーク(途中への移動)を確かめる項目が増えます。
私の2ブログがPagesのままなのはなぜか
ここまで読むと「新規はWorkersなら、今のブログも移したほうがいいのでは」という疑問が残ります。
自分のブログの構成を見直してみると、Workersにしかない機能を1つも使っていませんでした。移行して得られるものより、DNSまわりを触り直す手間のほうが大きい、というのが今の判断です。
functionsフォルダの無い、完全に静的な構成
私のブログ(code-rebuildとsystradefx)は、2026年10月23日に移行しました。WordPressから、Astro+Cloudflare Pagesへの引っ越しです。移行の作業の大半はClaude Codeに任せ、私はCloudflareへの登録とネームサーバーの変更をしています。
サイトのリポジトリには functions フォルダも _worker.js も wrangler.toml もありませんでした。2サイトとも、Pages Functionsを1本も使っていない完全な静的サイトです。
記事を反映する仕組みは、手元のMacで npm run build を流し、できた dist を wrangler pages deploy dist --project-name … --branch … --commit-dirty=true で直接アップロードしていました。設定に持っているのは、Pagesのプロジェクト名・アカウントID・出すブランチの3つ(STATIC_CF_PROJECT など)だけ。本番以外のブランチに出すときは、検索に載らない設定でビルドしています。今日のビルド結果は2,737ファイルでした。
Cloudflare側でビルドしないので、Pagesの月500回の枠も、Workers Buildsの月3,000分も関係ありません。リクエストはすべて静的ファイルに一致するので、1日10万リクエストの枠も使っていません。
この構成なら、PagesとWorkersの差は「出すときのコマンド」と「設定ファイルの有無」くらいです。

Workersに移しても、ブログの見た目も速さも変わらない。変わるのはコマンドの名前くらい、というのが正直なところです。
移すなら直す場所は3つある
それでも、いつか移す日のために、直す場所を洗い出しておきました。自分のリポジトリで見つけたのは次の3つです。
_headersのpages.dev向けの行。本番と同じ中身がpages.devのURLでも見えるので、検索に載らないようX-Robots-Tag: noindexを付けています。Workersに移るとURLがworkers.devに変わるので、この行を書き直します- 記事を反映する仕組みのコマンド。
wrangler pages deployをwrangler deployに替え、wrangler.jsoncを足します - カスタムドメインの付け替え。Pagesのプロジェクトから外し、Workerに付け直します
3つめがいちばん怖いところです。移行のときはネームサーバーを切り替える前に、メール用のレコードを切り離す下準備が要りました。得るもののない状態で、あの作業をもう一度やる理由は今のところありません。メールの件はWordPressからAstroへの移行記事に書きました。
PagesとWorkersのどちらを選ぶか:場面別の判断
結局どちらを選ぶかは、「新しく作るのか」「サーバー側の処理が要るのか」「ドメインのDNSはどこか」の3つでほぼ決まります。
迷ったときの順番を図にすると、次のようになります。
flowchart TD
A["Cloudflareでサイトを出したい"] --> B{"新しく作る?"}
B -->|"はい"| C{"ドメインのDNSは<br>Cloudflare?"}
C -->|"はい"| W["Workers<br>(Static Assets)"]
C -->|"いいえ・移せない"| P["Pages"]
B -->|"いいえ・Pagesで稼働中"| D{"Workersだけの機能が<br>欲しい?"}
D -->|"はい"| M["Workersへ移行"]
D -->|"いいえ"| K["Pagesのまま"]
Workersを選んだほうがいい場面
次のどれかに当てはまるなら、Workersから始めるか、Workersへ移る価値があります。
- これから新しくサイトやアプリを作る(Cloudflareが勧めている側に乗っておく)
- 定期実行・Queueの受信・メールの受信・レート制限など、Workersにしかない機能を使う
- 既存のサイトの一部のパス(
/api/など)だけをWorkerに任せたい - 段階的なデプロイやログの保存(Workers Logs)で、本番の変更を慎重に出したい
- Viteのプラグイン(Cloudflare Vite plugin)で手元の開発と本番をそろえたい
Pagesのままでいい場面
反対に、次の場面では、急いで移す理由は見当たりません。
- Functionsを使わない静的なサイトが、問題なく動いている
- ドメインを外部のDNSで管理していて、Cloudflareに移せない(サブドメインのCNAMEで付けている)
- ブランチごとのプレビューを、設定なしで使い続けたい
- 移行のためにDNSやメールの設定を触り直す余裕がない
私のブログが当てはまるのは1つめです。
AstroやNext.jsなどのフレームワークを使う場合
フレームワークを使っている場合は、静的に書き出しているか、サーバー側で描画しているかで話が変わります。
静的に書き出すだけなら、できたフォルダ(Astroなら dist)を配信するだけなので、PagesでもWorkersでも同じように出せます。私のブログのAstroもアダプターを入れていない静的な書き出しで、出し方はフォルダのアップロードだけです。
サーバー側で描画する(SSR)場合は、フレームワークごとのアダプターがPages向けかWorkers向けかを確かめます。移行ガイドでも、Pages専用のアダプターはWorkers向けのものに置き換えるよう書かれています。これから作るなら、最初からWorkers向けのアダプターを選んでおくと、あとで付け替えずに済みます。ドメインはCloudflareのネームサーバーに向けているので、2つめの理由で移れないわけではありません。
PagesからWorkersへ移行する手順
移ると決めたら、Cloudflareの移行ガイドに沿って進めます。静的なサイトなら、作業は次の6ステップです。
順番で大事なのは、Workerで動作を確かめてから、最後にドメインを付け替えることです。Pagesのプロジェクトを消すのは、本番のアクセスがすべてWorkerに移ったあとにします。
step
1wrangler.jsoncを書く
name と compatibility_date を書き、Pagesの pages_build_output_dir を assets の directory に置き換えます。404ページを使うなら not_found_handling に "404-page" を指定します。
step
2.assetsignoreを置く
配信するフォルダに .assetsignore を置き、node_modules・.DS_Store・.git を外します。Pagesでは自動で外れていたものです。
step
3Functionsがあれば変換する
functions フォルダがある場合は、npx wrangler pages functions build --outdir=./dist/worker/ でWorkerの形に変換し、main に出力先(例: ./dist/worker/index.js)を指定します。ミドルウェアや _routes.json を使っていたなら、run_worker_first を true にします。
step
4コマンドを置き換えて動作を確かめる
wrangler pages dev を wrangler dev に、wrangler pages deploy を wrangler deploy に替えます。まず workers.dev のURLで、ページ・転送・404の答え方を確かめます。
step
5Git連携を付け替える
Git連携で出していた場合は、リポジトリをWorkers Buildsにつなぎ、Pagesのプロジェクト側の自動デプロイを止めます。両方で出し続けると、どちらが本番か分からなくなります。
step
6カスタムドメインを移し、Pagesのプロジェクトを消す
Workerにカスタムドメインを付け、本番のアクセスがすべて移ったのを確かめてから、npx wrangler pages project delete でPagesのプロジェクトを消します。
バージョンと静的ファイルのずれに注意
Workersでは、デプロイした版ごとに静的ファイルを持ちます。段階的なデプロイを使うと、古い版のHTMLが新しい版にしかないファイルを読みに行く、といったずれが起きることがあります。リリースの手順を変える前に、移行ガイドの「Version skew and static assets」の節を読んでおきます。
よくある質問
Q1. Cloudflare PagesとWorkersは何が違いますか?
Pagesは静的サイトとPages Functionsを出す製品、Workersはエッジでスクリプトを動かす製品です。いまはWorkersでも静的ファイルを配信でき、定期実行やログの保存などWorkersにしかない機能もあります。外部DNSのサブドメインに付けられるのはPagesだけです。
Q2. 新しく作るならPagesとWorkersのどちらがいいですか?
Workersです。CloudflareはWorkersのベストプラクティスのページで、新しいプロジェクトにはPagesではなくWorkersを使うよう案内しています。新しい機能と最適化もWorkers側に集められます。
Q3. Cloudflare Pagesは終了しますか?
終了は発表されていません。Pagesは引き続き動くとされています。ただし新機能はWorkersに集中するので、Pagesに新しい機能が増えることはあまり期待できません。
Q4. PagesとWorkersの無料枠はどう違いますか?
静的ファイルの配信は、どちらも無料・無制限です。動的な処理は、Pages FunctionsもWorkersも同じ1日100,000リクエストの枠を分け合います。Cloudflare側のビルドは、Pagesが月500回、Workers Buildsが月3,000分です。
Q5. PagesからWorkersへの移行は必須ですか?
必須ではありません。Functionsを使わない静的サイトで困っていないなら、Pagesのままで問題ありません。Workersにしかない機能が欲しくなったときに、移行ガイドに沿って移せば足ります。
Q6. 外部DNSのドメインはWorkersで使えますか?
使えません。Workersのカスタムドメインは、ネームサーバーをCloudflareに向けたドメインだけが対象です。外部DNSのままなら、サブドメインにCNAMEで付けられるPagesを使います。
Q7. Pages Functionsはそのまま Workers で動きますか?
functions フォルダの書き方のままでは動きません。npx wrangler pages functions build でWorkerの形に変換し、設定ファイルの main に指定すれば動きます。新しく書くなら、Honoのようなルーターで1本のスクリプトにまとめる方法もあります。
PagesとWorkersの違いを知ったうえでの選び方(まとめ)
PagesとWorkersの違いは、静的なサイトを出すだけならほとんど表に出ません。差が出るのはサーバー側の処理・プレビュー・ドメインで、方針の面ではWorkersが先を行きます。
【要点まとめ】
- Cloudflareは新規プロジェクトにWorkersを勧めている。Pagesは動き続けるが、新機能はWorkers側に来る
- 静的ファイルの配信は両方とも無料・無制限。
_headersと_redirectsもWorkersでそのまま使える - 動的な処理の無料枠は、Pages FunctionsとWorkersで1日100,000リクエストを共有する
- プレビューの手軽さと外部DNSのサブドメインは、いまもPagesが上
- ビルドの無料枠はPagesが月500回、Workers Buildsが月3,000分。手元でビルドすれば、どちらも使わない
私のブログはPagesのまま動かしています。Workersにしかない機能が欲しくなったら、そのとき移行を考えます。最初に欲しくなるのが定期実行なのか、ログの保存なのかは、まだ分かりません。
どちらも無ければ、Workersへ移すかどうかは「欲しい機能が出てきたとき」に決めれば十分です。Cloudflareで新しく作る予定があるなら、そちらはWorkersから始めてみてください。
続きを追う:X(@Tom_Java_Tech) / RSS
途中経過は、また書きます。
