Amazon Linux AMI (AL1) から AL2 または AL2023 への移行
Elastic Beanstalk アプリケーションが Amazon Linux AMI プラットフォームブランチに基づいていている場合について、このセクションでアプリケーションの環境を Amazon Linux 2 または Amazon Linux 2023 に移行する方法を説明します。Amazon Linux AMI
Amazon Linux 2023 は Amazon Linux 2 よりも新しいので、Amazon Linux 2023 に移行することを強くお勧めします。Amazon Linux 2 オペレーティングシステムは Amazon Linux 2023 よりも前にサポート終了となるため、Amazon Linux 2023 に移行すれば、より長いサポート期間を利用できるというメリットがあります。
着目すべきは、Elastic Beanstalk Amazon Linux 2 プラットフォームと Amazon Linux 2023 プラットフォームの間には高度な互換性があるという点です。ただし、インスタンスメタデータサービスバージョン 1 (IMDSv1) オプションのデフォルト、pkg-repo インスタンスツールのサポート、いくつかの Apache HTTPd 設定など、一部に違いがあります。詳細については、「Amazon Linux 2023」を参照してください。
相違点と互換性
AL2023/AL2 ベースのプラットフォームブランチは、既存のアプリケーションに対して下位互換性があるとは限りません。アプリケーションコードが新しいプラットフォームバージョンに正常にデプロイされた場合でも、オペレーティングシステムとランタイムの違いにより、動作やパフォーマンスが異なる場合があるという点を認識しておくことも重要です。
Amazon Linux AMI と AL2023/AL2 は同じ Linux カーネルを共有しますが、初期化システム、libc
バージョン、コンパイラツールチェーン、およびさまざまなパッケージが異なります。詳細については、「Amazon Linux 2 に関するよくある質問
Elastic Beanstalk サービスでは、プラットフォーム固有のバージョンのランタイム、ビルドツール、およびその他の依存関係も更新されました。
したがって、時間をかけて開発環境でアプリケーションを徹底的にテストし、必要な調整を行うことをお勧めします。
一般的な移行プロセス
本番稼働用に移行する準備ができたら、Elastic Beanstalk では、アップグレードを実行するために Blue/Green デプロイが必要です。ブルー/グリーンデプロイ手順での移行に推奨する一般的なベストプラクティス手順は次のとおりです。
移行テストの準備
アプリケーションをデプロイしてテストを開始する前に、このトピックの後に記載されている「すべての Linux プラットフォームに関する考慮事項」の情報を確認してください。また、それに続く「プラットフォーム固有の考慮事項」セクションで、ご使用のプラットフォームに該当する情報を確認してください。このコンテンツのうち、ご使用のアプリケーションと設定のセットアップに当てはまる、または当てはまる可能性のある特定の情報を書き留めておいてください。
高レベル移行ステップ
-
AL2 または AL2023 プラットフォームブランチをベースにした新しい環境を作成します。AL2023 プラットフォームブランチに移行することをお勧めします。
-
ターゲットの AL2023/AL2 環境にアプリケーションをデプロイします。
新しい環境のテストと調整を繰り返し行っている間、既存の本番環境は引き続きアクティブで影響を受けません。
-
新しい環境でアプリケーションを徹底的にテストします。
-
ターゲットの AL2023/AL2 環境を本番環境に移行させる準備が完了したら、2 つの環境の CNAME を入れ替えて、新しい環境にトラフィックをリダイレクトします。
より詳細な移行手順とベストプラクティス
ブルー/グリーンデプロイ手順の詳細については、「Elastic Beanstalk を使用したブルー/グリーンデプロイ」を参照してください。
より具体的なガイダンスと詳細なベストプラクティス手順については、「Blue/Green method」を参照してください。
移行計画に役立つその他のリファレンス
以下のリファレンスには、移行を計画するための追加情報があります。
-
「Amazon Linux 2023 ユーザーガイド」の「Amazon Linux 2 と Amazon Linux 2023 の比較」
-
「Amazon Linux 2023 ユーザーガイド」の「Amazon Linux 2023 とは」
-
「AWS Elastic Beanstalk プラットフォーム」の「Elastic Beanstalk でサポートされているプラットフォーム」
すべての Linux プラットフォームに関する考慮事項
次の表に、AL2023/AL2 へのアプリケーションの移行を計画する際に注意すべき考慮事項を示します。これらの考慮事項は、特定のプログラミング言語やアプリケーションサーバーに関係なく、任意の Elastic Beanstalk Linux プラットフォームに適用されます。
エリア | 変更と情報 |
---|---|
設定ファイル |
AL2023/AL2 プラットフォームでは、以前と同じように設定ファイルを使用でき、すべてのセクションは同じように動作します。ただし、特定の設定は、以前の Amazon Linux AMI プラットフォームと同じように機能しない場合があります。例:
環境インスタンスでカスタムコードを実行するには、プラットフォームフックを使用することをお勧めします。 AWS CloudFormation リソースへのリファレンスが必要なスクリプトについては、 |
プラットフォームフック |
AL2 プラットフォームは、実行可能ファイルを追加して環境のインスタンス上のディレクトリをフックすることで、環境のプラットフォームを拡張する新しい方法を導入します。以前の Linux プラットフォームバージョンでは、カスタムプラットフォームフックを使用していた可能性があります。これらのフックは、マネージドプラットフォーム用に設計されておらず、サポートされていませんでしたが、場合によっては便利な方法で動作する可能性があります。AL2023/AL2 プラットフォームバージョンでは、カスタムプラットフォームフックは機能しません。すべてのフックを新しいプラットフォームフックに移行する必要があります。詳細については、「プラットフォームフック」を参照してください。 |
サポートされているプロキシサーバー |
AL2023/AL2 プラットフォームのバージョンは、Amazon Linux AMI プラットフォームバージョンでサポートされている各プラットフォームと同じリバースプロキシサーバーをサポートします。ECS および Docker プラットフォームを除いて、AL2023/AL2 プラットフォームのすべてのバージョンは、デフォルトのリバースプロキシサーバーとして nginx を使用しています。Tomcat、Node.js、PHP、Python のプラットフォームも、代替として Apache HTTPD をサポートします。このセクションの説明の通り、すべてのプラットフォームでプロキシサーバーの設定が一貫して有効にされています。ただし、プロキシサーバーの設定は、Amazon Linux AMI の設定とは少し異なります。すべてのプラットフォームの相違点は次のとおりです。
プラットフォーム固有のプロキシ設定の変更については、プラットフォーム固有の考慮事項 を参照してください。AL2023/AL2 プラットフォームでのプロキシ設定については、「リバースプロキシの設定」を参照してください。 |
プロキシ設定の変更 |
各プラットフォームに固有のプロキシ設定の変更に加えて、すべてのプラットフォームに共通に適用されるプロキシ設定の変更があります。環境を正確に設定するには、両方を参照することが重要です。
|
インスタンスプロファイル |
AL2023/AL2 プラットフォームでは、インスタンスプロファイルを設定する必要があります。インスタンスプロファイルがなくても、環境の作成が一時的に成功する可能性はありますが、インスタンスプロファイルを必要とするアクションが失敗し始めると、作成直後に環境内にエラーが表示されることがあります。詳細については、「Elastic Beanstalk インスタンスプロファイルの管理」を参照してください。 |
拡張ヘルス |
AL2023/AL2 プラットフォームのバージョンでは、デフォルトで拡張ヘルスが有効になります。これは、環境の作成に Elastic Beanstalk コンソールを使用しない場合、変更されます。コンソールでは、プラットフォームのバージョンに関係なく、可能な限り、デフォルトで拡張ヘルスが有効になります。詳細については、「Elastic Beanstalk 拡張ヘルスレポートおよびモニタリング」を参照してください。 |
カスタム AMI |
環境でカスタム AMI を使用する場合は、Elastic Beanstalk AL2023/AL2 プラットフォームを使用して、新しい環境用に AL2023/AL2 に基づく新しい AMI を作成します。 |
カスタムプラットフォーム |
AL2023/AL2 プラットフォームバージョンのマネージド AMI は、カスタムプラットフォームをサポートしていません。 |
プラットフォーム固有の考慮事項
このセクションでは、特定の Elastic Beanstalk Linux プラットフォームに固有の移行に関する考慮事項について説明します。
Amazon Linux AMI (AL1) に基づく Docker プラットフォームブランチファミリーには、3 つのプラットフォームブランチが含まれます。それぞれに個別の移行パスを設定することをお勧めします。
AL1 プラットフォームブランチ | AL2023/AL2 への移行パス | ||||||||
---|---|---|---|---|---|---|---|---|---|
Amazon Linux AMI (AL1) 上で動作する Amazon ECS で管理されるマルチコンテナ Docker |
ECS ベースの Docker AL2023/AL2 プラットフォームブランチECS ベースの Docker AL2023/AL2 プラットフォームブランチによって、マルチコンテナ Docker AL1 プラットフォームブランチで実行されている環境の移行パスを簡単にできます。
マルチコンテナ Docker Amazon Linux プラットフォームブランチで動作するアプリケーションを AL2023/AL2 で動作する Amazon ECS プラットフォームブランチに移行する方法についての詳細は、「Elastic Beanstalk アプリケーションを AL1 の ECS マネージドマルチコンテナ Docker から Amazon Linux 2023 の ECS に移行する」を参照してください。 |
||||||||
Amazon Linux AMI (AL1) 上で動作する Docker Amazon Linux AMI (AL1) 上で動作する事前設定済み Docker (Glassfish 5.0) |
AL2023/AL2 プラットフォームブランチで実行されている Docker事前設定済み Docker (Glassfish 5.0) または Amazon Linux AMI (AL1) 上で動作する Docker に基づく環境で動作するアプリケーションは、Amazon Linux 2 で動作する Docker または AL2023 で動作する Docker のプラットフォームブランチに基づく環境に移行することをお勧めします。 ご使用の環境が、事前設定済み Docker (Glassfish 5.0) プラットフォームブランチ基づく場合は、「Docker プラットフォームへの GlassFish アプリケーションのデプロイ: Amazon Linux 2023 への移行パス」を参照してください。 次の表に、AL2023/AL2 で動作する Docker のプラットフォームブランチ固有の移行情報を示します。
|
以下の表に、Go プラットフォームの AL2023/AL2 プラットフォームバージョンの移行情報を示します。
エリア | 変更と情報 |
---|---|
ポートの受け渡し |
AL2023/AL2 プラットフォームでは、Elastic Beanstalk は |
次の表に、Java SE プラットフォームの Corretto プラットフォームブランチの移行情報を示します。
エリア | 変更と情報 |
---|---|
Corretto と OpenJDK |
Java プラットフォームの Standard Edition (Java SE) を実装するために、AL2023/AL2 プラットフォームブランチは、Open Java Development Kit (OpenJDK) の AWS ディストリビューションである Amazon Corretto |
ビルドツール |
AL2023/AL2 プラットフォームには、 |
JAR ファイルの処理 |
AL2023/AL2 プラットフォームでは、ソースバンドル (ZIP ファイル) に 1 つの JAR ファイルが含まれていて、他のファイルが含まれていない場合、Elastic Beanstalk は JAR ファイルの名前を |
ポートの受け渡し |
AL2023/AL2 プラットフォームでは、Elastic Beanstalk は |
Java 7 |
Elastic Beanstalk は、AL2023/AL2 Java 7 プラットフォームブランチをサポートしていません。Java 7 アプリケーションをお持ちの場合は、Corretto 8 または Corretto 11 に移行してください。 |
以下の表に、Tomcat プラットフォームの AL2023/AL2 プラットフォームバージョンの移行情報を示します。
エリア | 変更と情報 | ||||||
---|---|---|---|---|---|---|---|
設定オプション |
AL2023/AL2 プラットフォームバージョンでは、Elastic Beanstalk は
|
||||||
アプリケーションのパス |
AL2023/AL2 プラットフォームでは、環境の Amazon EC2 インスタンス上のアプリケーションのディレクトリへのパスは |
以下の表に、Node.js プラットフォームの AL2023/AL2 プラットフォームバージョンの移行情報を示します。
エリア | 変更と情報 | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
インストールされている Node.js のバージョン |
AL2023/AL2 プラットフォームでは、Elastic Beanstalk は複数の Node.js プラットフォームブランチを維持し、各プラットフォームバージョンのプラットフォームブランチに対応する Node.js メジャーバージョンの最新バージョンのみをインストールします。たとえば、Node.js 12 プラットフォームブランチの各プラットフォームバージョンには、デフォルトで Node.js 12.x.y のみがインストールされています。Amazon Linux AMI プラットフォームバージョンでは、各プラットフォームバージョンに複数の Node.js バージョンの複数のバージョンをインストールし、単一のプラットフォームブランチのみを維持しました。 アプリケーションで必要な Node.js メジャーバージョンに対応する Node.js プラットフォームブランチを選択します。 |
||||||||||
Apache HTTPD ログファイル名 |
AL2023/AL2 プラットフォームでは、Apache HTTPD プロキシサーバーを使用する場合、HTTPD ログファイル名は すべてのプラットフォームのログファイル名と場所の詳細については、Elastic Beanstalk が CloudWatch Logs を設定する方法 を参照してください。 |
||||||||||
設定オプション |
AL2023/AL2 プラットフォームでは、Elastic Beanstalk は
|
以下の表に、PHP プラットフォームの AL2023/AL2 プラットフォームバージョンの移行情報を示します。
エリア | 変更と情報 |
---|---|
PHP ファイル処理 |
AL2023/AL2 プラットフォームでは、PHP ファイルは PHP-FPM (CGI プロセスマネージャ) を使用して処理されます。Amazon Linux AMIプラットフォームでは、mod_php (Apache モジュール) を使用しました。 |
プロキシサーバー |
AL2023/AL2 PHP プラットフォームのバージョンは、nginx と Apache HTTPD プロキシサーバーの両方をサポートします。デフォルトは nginx です。 Amazon Linux AMI PHP プラットフォームのバージョンは、Apache HTTPD のみをサポートします。カスタム Apache 設定ファイルを追加した場合は、 |
以下の表に、Python プラットフォームの AL2023/AL2 プラットフォームバージョンの移行情報を示します。
エリア | 変更と情報 |
---|---|
WSGI サーバー |
AL2023/AL2 プラットフォームでは、Gunicorn または、 |
アプリケーションのパス |
AL2023/AL2 プラットフォームでは、環境の Amazon EC2 インスタンス上のアプリケーションのディレクトリへのパスは |
プロキシサーバー |
AL2023/AL2 Python プラットフォームのバージョンは、nginx と Apache HTTPD プロキシサーバーの両方をサポートします。デフォルトは nginx です。 Amazon Linux AMI Python プラットフォームのバージョンは、Apache HTTPD のみをサポートします。カスタム Apache 設定ファイルを追加した場合は、 |
以下の表に、Ruby プラットフォームの AL2023/AL2 プラットフォームバージョンの移行情報を示します。
エリア | 変更と情報 |
---|---|
インストールされている Ruby バージョン |
AL2023/AL2 プラットフォームでは、Elastic Beanstalk は、各プラットフォームバージョンに、プラットフォームブランチに対応する単一の Ruby バージョンの最新バージョンのみをインストールします。たとえば、Ruby 2.6 プラットフォームブランチの各プラットフォームバージョンには Ruby 2.6.x のみインストールされています。Amazon Linux AMI プラットフォームのバージョンでは、複数の Ruby バージョンの最新バージョン (2.4.x、2.5.x、2.6.x など) がインストールされています。 使用しているプラットフォームブランチに対応していない Ruby バージョンをアプリケーションで使用している場合は、アプリケーションに適した Ruby バージョンのプラットフォームブランチに切り替えることをお勧めします。 |
アプリケーションサーバー |
AL2023/AL2 プラットフォームでは、Elastic Beanstalk は、すべての Ruby プラットフォームバージョンに対して Puma アプリケーションサーバーのみをインストールします。 Amazon Linux AMI プラットフォームでは、Ruby バージョンごとに 2 種類のプラットフォームブランチをサポートしていました。1 つは Puma アプリケーションサーバーで、もう 1 つは Passenger アプリケーションサーバーです。アプリケーションで Passenger を使用している場合は、Passenger をインストールして使用するように Ruby 環境を設定できます。 詳細な説明と例については、「 Elastic Beanstalk Ruby プラットフォームを使用する」を参照してください。 |