Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

ビルドイメージ

最終更新 Markdown で表示Agent セットアップ

Cloudflare Pages のビルド環境は、Ruby、Node.js、Python、PHP、Go など、さまざまな言語に広く対応しています。

特定の言語バージョン（Node.js や Ruby など）が必要な場合は、ビルド設定の関連する環境変数を指定するか、ソースコードに該当ファイルを置くことで指定できます。

対応言語とツール

次の表で、Cloudflare Pages のビルドイメージに事前インストールされている言語とツールのバージョンと、事前インストール版の上書き に使える環境変数およびファイルを確認します。

言語とランタイム

ツールデフォルトバージョン対応バージョン環境変数ファイル
Go1.24.3Any versionGO_VERSION
Node.js22.16.0Any versionNODE_VERSION.nvmrc, .node-version
Bun1.2.15Any versionBUN_VERSION
Python3.13.3Any versionPYTHON_VERSION.python-version, runtime.txt
Ruby3.4.4Any versionRUBY_VERSION.ruby-version
ツールデフォルトバージョン対応バージョン環境変数ファイル
Go1.21.0Any versionGO_VERSION
Node.js18.17.1Any versionNODE_VERSION.nvmrc, .node-version
Bun1.1.33Any versionBUN_VERSION
Python3.11.5Any versionPYTHON_VERSION.python-version, runtime.txt
Ruby3.2.2Any versionRUBY_VERSION.ruby-version
ツールデフォルトバージョン対応バージョン環境変数ファイル
Clojure
Elixir1.71.7 only
Erlang2121 only
Go1.14.4Any versionGO_VERSION
Java88 only
Node.js12.18.0Any versionNODE_VERSION.nvmrc, .node-version
PHP5.65.6, 7.2, 7.4 onlyPHP_VERSION
Python2.72.7, 3.5, 3.7 onlyPYTHON_VERSIONruntime.txt, Pipfile
Ruby2.7.1Any version between 2.6.2 and 2.7.5RUBY_VERSION.ruby-version
Swift5.2.5Any 5.x versionSWIFT_VERSION.swift-version
.NET3.1.302

ツール

ツールデフォルトバージョン対応バージョン環境変数
Bundler2.6.9Corresponds with Ruby version
Embedded Dart Sass1.62.1Up to 1.62.1EMBEDDED_DART_SASS_VERSION
gem3.6.9Corresponds with Ruby version
Hugo0.147.7Any versionHUGO_VERSION
npm10.9.2Corresponds with Node.js version
pip25.1.1Corresponds with Python version
pipx1.7.1
pnpm10.11.1Any versionPNPM_VERSION
Poetry2.1.3
Yarn4.9.1Any versionYARN_VERSION
Zola0.22.1Any versionZOLA_VERSION
ツールデフォルトバージョン対応バージョン環境変数
Bundler2.4.10Corresponds with Ruby version
Embedded Dart Sass1.62.1Up to 1.62.1EMBEDDED_DART_SASS_VERSION
gem3.4.10Corresponds with Ruby version
Hugo0.118.2Any versionHUGO_VERSION
npm9.6.7Corresponds with Node.js version
pip23.2.1Corresponds with Python version
pipx1.2.0
pnpm8.7.1Any versionPNPM_VERSION
Poetry1.6.1
Yarn3.6.3Any versionYARN_VERSION
Zola0.22.1Any versionZOLA_VERSION
ツールデフォルトバージョン対応バージョン環境変数
Boot2.5.22.5.2
Bower
Cask
Composer
Doxygen1.8.6
Emacs25
Gutenberg(requires environment variable)Any versionGUTENBERG_VERSION
Hugo0.54.0Any versionHUGO_VERSION
GNU Make3.8.1
ImageMagick6.7.7
jq1.5
Leiningen
OptiPNG0.6.4
npmCorresponds with Node.js versionAny versionNPM_VERSION
pipCorresponds with Python version
PipenvLatest version
sqlite33.11.0
Yarn1.22.4Any version from 0.2.0 to 1.22.19YARN_VERSION
Zola(requires environment variable)Any version from 0.5.0 and upZOLA_VERSION

フレームワーク

特定バージョンのフレームワークを使うには、プロジェクトのパッケージマネージャー設定ファイルで指定します。 たとえば Gatsby を使う場合、package.json には次を含めます。

"dependencies": {
	"gatsby": "^5.13.7",
}

ビルド開始時、まだ キャッシュ されていなければ、npm install で Gatsby のバージョン 5.13.7 がインストールされます。

詳細設定

デフォルトバージョンを上書きする

ビルドシステムの言語とツールのデフォルトバージョンを上書きするには、環境変数で希望のバージョンを設定するか、プロジェクトにファイルを追加します。

環境変数でバージョンを設定する手順は次のとおりです。

  1. この表 で、その言語またはツールの環境変数名を確認します。
  2. Pages プロジェクトの Settings > Environment variables でダッシュボードに環境変数を追加するか、Wrangler で環境変数を追加 します。

または、プロジェクトにファイルを追加してバージョンを設定する手順は次のとおりです。

  1. この表 で、その言語またはツールのファイル名を確認します。
  2. 指定されたファイル名をプロジェクトのルートディレクトリに追加し、ファイルの内容として希望のバージョン番号を入れます。

たとえば、以前 v1 ビルドシステムで Node.js のデフォルトバージョンに依存していた場合、v2 へ移行するには、環境変数 NODE_VERSION = 12.18.0 を設定するか、内容が 12.18.0 の .node-version または .nvmrc ファイルをプロジェクトに追加して、Node.js 12.18.0 が必要であることを指定します。

依存関係のインストールをスキップする

次の環境変数を追加すると、自動の依存関係インストールを無効にし、代わりにカスタムのインストールコマンドを実行できます。

ビルド変数 値
SKIP_DEPENDENCY_INSTALL 1 または true

v3 ビルドシステム

v3 ビルドシステムは、デフォルトのツール、ライブラリ、言語を、2025 年 5 月時点の LTS バージョンに更新します。

v2 から v3 への移行

この新しいバージョンへ移行するには、ダッシュボードで Pages プロジェクトの設定を変更します。

  1. Cloudflare ダッシュボードで Workers & Pages ページを開きます。

    Workers & Pages を開く ↗

  2. Pages プロジェクトを選びます。

  3. Deployments > All deployments を開き、最新バージョンを選びます。

以前ビルドシステムのいずれかの言語またはツールのデフォルトバージョンに依存していた場合、v3 への移行時にビルドが失敗することがあります。修正するには、デフォルトバージョンを 上書き し、使いたいバージョンを指定します。

制限

v3 ビルドシステムでは、現在次の機能は使えません。

  • Node.js バージョンをコードネーム（hydrogen や lts/hydrogen など）で指定すること。
  • yarn.lock ファイルのバージョンから Yarn バージョンを検出すること。
  • pnpm-lock.yaml ファイルのバージョンに基づく pnpm バージョン検出。
  • package.json の "engines" から Node.js とパッケージマネージャーを検出すること。
  • pipenv と Pipfile のサポート。

ビルド環境

Cloudflare Pages のビルドは、gVisor ↗ コンテナで実行されます。

ビルド環境

Ubuntu 22.04.2

アーキテクチャx86_64
ビルド環境

Ubuntu 22.04.2

アーキテクチャx86_64
ビルド環境

Ubuntu 20.04.5

アーキテクチャx86_64

ビルドイメージの方針

ビルドイメージバージョンの非推奨化

現在 v1 または v2 ビルドイメージを使っている場合、プロジェクトは自動的に v3 へ移行されます。

  • v1 ビルドイメージ: Pages v1 ビルドイメージを使っている場合、プロジェクトは 2026 年 9 月 15 日に自動で v3 へ移行されます。
  • v2 ビルドイメージ: Pages v2 ビルドイメージを使っている場合、プロジェクトは 2027 年 2 月 23 日に自動で v3 へ移行されます。

非推奨日の 6 か月前に、Cloudflare Changelog ↗、ダッシュボード通知、メールで通知されます。

今後、v3 ビルドイメージは、次の方針に従って事前インストール済みソフトウェアのローリング更新を受けます。これ以上のビルドイメージバージョン変更はありません。

事前インストール済みソフトウェアの更新

事前インストール済みソフトウェア（言語とツール）は、サポート終了（EOL）の前に更新されます。これらの更新は、デフォルトバージョンを上書き していない場合にのみ適用されます。

  • マイナーバージョンの更新: 予告なしに、利用可能な最新のマイナーバージョンへ更新される場合があります。セマンティックバージョニングに従わないツール（Bun や Hugo など）では、破壊的変更を含む可能性のある更新に 3 か月前の通知があります。
  • メジャーバージョンの更新: 次の安定した長期サポート（LTS）バージョンへ、3 か月前の通知付きで更新されます。

通知方法（通知が必要な変更の場合）:

  • Cloudflare Changelog ↗
  • 更新を受けるプロジェクト向けのダッシュボード通知
  • プロジェクト所有者へのメール通知

特定バージョンを維持し、自動更新を避けるには、デフォルトバージョンを上書き します。

推奨事項

予期しないビルド失敗を避けるには、次を行います。

役に立ちましたか？