プロジェクト全体で共有するキャッシュを使い、依存関係とビルド出力をビルド間でキャッシュすることで、Pages のビルド時間を短縮できます。
Pages プロジェクトでビルドキャッシュを有効にしたあと、最初のビルドがキャッシュに保存されます。以降のビルドは、別の設定をしていない限り、キャッシュから復元します。
有効にすると、ビルドキャッシュは各ビルドのデータを自動で検出してキャッシュします。自動で保存・復元されるディレクトリは、フレームワーク を参照してください。
ビルドキャッシュには V2 ビルドシステム 以降が必要です。V1 から更新するには、V2 ビルドシステムの移行手順 を参照してください。
Pages は、次のパッケージマネージャーのグローバルキャッシュディレクトリをキャッシュします。
| パッケージマネージャー | キャッシュされるディレクトリ |
|---|---|
| npm ↗ | .npm |
| yarn ↗ | .cache/yarn |
| pnpm ↗ | .pnpm-store |
| bun ↗ | .bun/install/cache |
一部のフレームワークは、ビルド時に中間のビルド出力や依存関係を入れるキャッシュディレクトリを提供します。Pages は使用中のフレームワークを自動検出し、このディレクトリを以降のビルドで再利用できるようキャッシュします。
次のフレームワークは、ビルド出力のキャッシュに対応しています。
| フレームワーク | キャッシュされるディレクトリ |
|---|---|
| Astro | node_modules/.astro |
| Docusaurus | node_modules/.cache、.docusaurus、build |
| Eleventy | .cache |
| Gatsby | .cache、public |
| Hugo | .cache |
| Next.js | .next/cache |
| Nuxt | node_modules/.cache/nuxt |
| SvelteKit | node_modules/.cache/imagetools |
ビルドキャッシュには、次の制限があります。
- 保持期間: キャッシュは、最後に読み取った日から 7 日後に削除されます。読み取られていないキャッシュ成果物は、作成から 7 日後に削除されます。
- ストレージ: 各プロジェクトに 10 GB が割り当てられます。プロジェクトのキャッシュがこの上限を超えると、最も長く読み取られていない成果物から自動で削除されます。
ビルドキャッシュを有効にするには、次の手順を実行します。
-
Cloudflare ダッシュボードで Workers & Pages を開きます。
Workers & Pages を開く ↗ -
Pages プロジェクトを探します。
-
Settings > Build > Build cache を開きます。
-
Enable を選び、ビルドキャッシュを有効にします。
ビルドの問題をデバッグするときなど、必要に応じてプロジェクトのビルドキャッシュを削除できます。ビルドキャッシュを削除するには、次の手順を実行します。
-
Cloudflare ダッシュボードで Workers & Pages を開きます。
Workers & Pages を開く ↗ -
Pages プロジェクトを探します。
-
Settings > Build > Build cache を開きます。
-
Clear Cache を選び、ビルドキャッシュを削除します。