Elastic Beanstalk で Node.js ソリューションスタックを新しいバージョンに更新するにはどうすればよいですか?

簡単な説明

現在のノードバージョンが、アップグレードまたはダウングレード先のソリューションスタック (ターゲットソリューションスタック) のノードバージョンでサポートされていない場合、更新が失敗することがあります。

更新が失敗した場合、次のようなエラーが発生する場合があります。

=============
"Failed Environment update activity. Reason: Configuration validation exception: Invalid option value: '4.8.4' (Namespace: 'aws:elasticbeanstalk:container:nodejs', OptionName: 'NodeVersion'): Value is not one of the allowed values: 
[4.8.7, 4.9.1, 5.12.0, 6.15.1, 6.16.0, 6.17.0, 6.17.1, 7.10.1, 8.14.0, 8.15.0, 8.15.1, 8.16.0, 8.16.1, 8.16.2, 8.17.0, 10.14.1, 10.15.0, 10.15.1, 10.15.3, 10.16.0, 10.16.1, 10.16.2, 10.16.3, 10.17.0, 10.18.0, 10.18.1, 10.19.0, 12.14.0, 12.14.1, 12.15.0, 12.16.1]".
=============

このエラーを解決するには、次のいずれかのオプションを選び実行します。

• ブルー/グリーンデプロイを実行し、新しい環境を作成します。
• 既存の環境を使用する場合は、次の 解決方法 セクションで説明する手順に基づき、先に Node.js ノードバージョンを更新してから、ソリューションスタックを更新します。

解決方法

重要: 次のステップは、廃止された Amazon Linux AMI (Amazon Linux 1 とも呼ばれます) ベースのソリューションスタックについてのみ有効です。Amazon Linux 2 ベースのソリューションスタックについては、ノードバージョンは、一致するソリューションスタックの新しい環境を作成することによってのみ変更できます。Amazon Linux 2 プラットフォームで Node.js のバージョンを設定する方法の詳細については、「Specifying Node.js dependencies with a package.json file」(package.json ファイルで Node.js の依存関係を指定する) を参照してください。

1. Elastic Beanstalk コンソールを開きます。
2. ナビゲーションペインで、[環境] をクリックした後、使用している環境を選択します。
3. ご自身の環境に関するナビゲーションペインセクションで、[設定] をクリックします。
4. [カテゴリ] 列の [ソフトウェア] 行で、[編集] をクリックします。
5. [Node.js バージョン] で、ご自身のターゲットソリューションスタックがサポートしているノードバージョンを選択します。
   重要: このノードバージョンは、現在のソリューションスタックとターゲットソリューションスタックの両方でサポートされている必要があります。例えば、Elastic Beanstalk 環境が実行される 64 ビット Amazon Linux 2018.03 v4.5.1 での Node.js が、ソリューションスタックにノードバージョンの 8.11.3 を実行している場合、アップグレード先のターゲットソリューションスタックもノードバージョン 8.11.3 をサポートする必要があります。各タイプのソリューションスタックでサポートされているノードバージョンについては、「Node.js プラットフォーム履歴」をご参照ください。
6. [適用] をクリックし、ノードバージョンのアップグレードまたはダウングレードを実行します。
7. 使用しているターゲットソリューションスタックと同じプラットフォームバージョンへのアップグレードまたはダウングレードを行います。