コンテンツにスキップ

ビルドキャッシング

ビルドキャッシングを有効にすることで、依存関係やビルド出力をビルド間で復元し、Pagesのビルド時間を改善します。ビルドキャッシングをPagesプロジェクトで有効にした後の最初のビルドはキャッシュに保存されます。その後のすべてのビルドは、特に設定がない限り、キャッシュから復元されます。

要件

ビルドキャッシングには、V2ビルドシステム以上が必要です。V1からの更新については、V2ビルドシステムの移行手順を参照してください。

設定

ビルドキャッシングを有効にする

Cloudflareダッシュボードでビルドキャッシングを有効にするには:

  1. Cloudflareダッシュボードにログインし、アカウントを選択します。
  2. アカウントホームで、Workers & Pagesを選択します。
  3. 概要で、Pagesプロジェクトを選択します。
  4. 設定 > ビルドとデプロイ > ビルドキャッシュに移動し、ビルドキャッシュを有効にするを選択します。

キャッシュをクリアする

ビルドの問題をデバッグする際など、必要に応じてプロジェクトのビルドキャッシュをクリアできます。ビルドキャッシュをクリアするには:

  1. Cloudflareダッシュボードにログインし、アカウントを選択します。
  2. アカウントホームで、Workers & Pagesを選択します。
  3. 概要で、Pagesプロジェクトを選択します。
  4. 設定 > ビルドとデプロイ > ビルドキャッシュに移動します。
  5. キャッシュをクリアを選択して、ビルドキャッシュをクリアします。

ビルドキャッシングの仕組み

ビルドキャッシングが有効になると、ビルドからのデータを自動的に検出してキャッシュします。どのディレクトリが自動的に保存され、ビルドキャッシュから復元されるかを確認するには、フレームワークを参照してください。

パッケージマネージャー

パッケージマネージャーのキャッシュは、依存関係のインストールを迅速化するために自動的にビルドキャッシュに保存されます。Pagesは、以下のパッケージマネージャーのグローバルキャッシュディレクトリをキャッシュします:

フレームワーク

フレームワークからのビルド出力をキャッシュすることで、次回のビルド時間を短縮できます。ビルドキャッシュは以下のフレームワークをサポートしています:

フレームワークキャッシュされるディレクトリ
Astronode_modules/.astro
Docusaurusnode_modules/.cache, .docusaurus, build
Eleventy.cache
Gatsby.cache, public
Next.js.next/cache
Nuxtnode_modules/.cache/nuxt

制限

このベータ期間中、以下の制限が課せられます:

  • 保持: キャッシュは最終読み取り日から7日後に削除されます。未読のキャッシュアーティファクトは作成から7日後に削除されます。
  • ストレージ: 各プロジェクトには10GBが割り当てられます。この制限を超えると、プロジェクトは最も最近読まれていないアーティファクトを自動的に削除し始めます。

フィードバック

サポートしてほしいパッケージマネージャーやフレームワークがあれば、Cloudflare Developer DiscordのPagesチャンネルでお知らせください。