More than 1 year has passed since last update.

Netlify のビルドイメージを Xenial から Focal へ移行した

Posted at 2022-10-04

ある日、Netlify UI の Build image selection に以下の警告が出るようになりました。

After November 15, 20022, the Xenial build image will not be supported. To avoid build failure, select another build image.

2022 年 11 月 15 日以降、Xenial ビルドイメージを使用したビルドはすべて失敗するようになるみたいです！
新しいビルドイメージ Focal に移行する必要があります。

Xenial ってなに？

Xenial や Focal というのは、 Ubuntu のバージョンです。

バージョン	コードネーム	読み方
16.04 LTF	Xenial	ジニアル
20.04 LTS	Focal	フォウカル

本番環境を汚さずに、事前に Focal で動作確認がしたかったので、方法を調べました。
Netlify 公式の移行ガイドがとても丁寧だったので、ほぼそのまま手順を日本語で記載します！

まず、Netlify UI の Deploys ページから、現在公開されているデプロイ（通常、最新の本番用デプロイ）を選択します。
デプロイのログページの上部で、Lock publishing to this deploy ボタンをクリックします。デプロイがロックされると、公開済みサイトを変更せずに新しいデプロイを実行できます。
Deploy settings ボタンをクリックし、 Build image selection までスクロールし、 Focal ビルドイメージを選択します。
Deploy ページに戻り、 Trigger deploy ボタンをクリックします。
新しいデプロイのビルドが開始されます。成功したら、 Preview deploy をクリックして、そのバージョンのサイトを表示します。サイトが正常に動作している場合は、設定完了です！ Deploy ページに戻り、 Unlock to start auto publishing をクリックして、ビルドを正常に実行し続け、新しいビルドイメージを使用できるようにします。
デプロイに失敗したり、サイトが正常に動作しない場合は、トラブルシューティングを行う必要があります。トラブルシューティングを行う時間がない場合は、Xenial イメージに切り戻して、再度 Unlock to start auto publishing を実行します。

本記事作成にあたり、以下のサイトを参考にさせていただきました。ありがとうございました。