Cloudflare Pages の node バージョンを変更する方法

2023.07.15 に更新記事は 2 分で読めます
サムネイル画像

この記事では Cloudflare Pages で実行されている Node.js のバージョンを変更する方法について解説しています。

問題

このブログは Cloudflare Pages でホスティングしているのですが、先日デプロイ時に以下のエラーに遭遇しました。

error [email protected]: The engine "node" is incompatible with this module. Expected version ">=12.22.0". Got “12.18.0"
error Found incompatible module.
info Visit https://yarnpkg.com/en/docs/cli/install for documentation about this command. 
Error during Yarn install

Cloudflare Pages ではデフォルトで node v12.18.0 が使用されているため、 node のバージョンを変更する必要があるようです。

node-12.18.0

バージョン変更方法

Cloudflare Pages のデプロイしたい Pages を選択後に「設定」→「環境変数」から 変数名をNODE_VERSION、値を v16.14.2 のように設定すればデプロイ時にそのバージョンを使用してくれるように変更されます。

cloudflare-pages-node-version

この状態でデプロイしてみるとログから実際に指定した node バージョンが使用されていることが確認できます。

node-version

また、アプリケーションレベルで node のバージョン管理をしたい場合は package.json と同じ階層で .nvmrc.node-version を追加して node のバージョンを記述することで変更する方法もあるようです。

https://developers.cloudflare.com/pages/platform/build-configuration

プロフィールアイコン

Syuu

フロントエンドが好きなWEBエンジニア Next.js / React / TypeScript

SHARE