Amazon Linux AMI (AL1) から AL2または AL2023 への移行

Amazon Linux でECS実行されている Amazon によって管理されるマルチコンテナ Docker AMI (AL1）

ECS ベースの Docker AL2023/AL2 プラットフォームブランチ

ECS ベースの Docker AL2023/ AL2プラットフォームブランチは、マルチコンテナの Docker AL1プラットフォームブランチで実行されている環境の簡単な移行パスを提供します。

マルチコンテナ Docker Amazon Linux プラットフォームブランチで実行されているアプリケーションを AL2023/ プラットフォームブランチでECS実行されている Amazon AL2に移行する方法の詳細については、「」を参照してくださいElastic Beanstalk アプリケーションを のECSマネージドマルチコンテナ Docker から Amazon Linux 2023 AL1ECSの に移行する。

Amazon Linux で実行されている Docker AMI (AL1）

Amazon Linux を実行する事前設定済み Docker (Glassfish 5.0) AMI (AL1）

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/ で実行されるプラットフォームブランチ Docker AL2に固有の移行情報を示します。

ポートの受け渡し

AL2023/AL2 プラットフォームでは、Elastic Beanstalk は PORT環境変数を介してアプリケーションプロセスにポート値を渡しません。PORT 環境プロパティを自分で設定することで、プロセスのこの動作をシミュレートできます。ただし、複数のプロセスがあり、Elastic Beanstalk が増分ポート値をプロセス (5000、5100、5200 など) に渡すことを期待している場合は、実装を変更する必要があります。詳細については、「Elastic Beanstalk Linux プラットフォームの拡張」の「リバースプロキシの設定」セクションを展開します。

Corretto と OpenJDK

Java プラットフォーム、Standard Edition (Java SE) を実装するために、AL2023/AL2 プラットフォームブランチは Open Java Development Kit (Open) の AWS ディストリビューションである Amazon Corretto を使用しますJDK。以前の Elastic Beanstalk Java SE プラットフォームブランチは、Amazon Linux に含まれている OpenJDK パッケージを使用しますAMI。

ビルドツール

AL2023/AL2 プラットフォームには、、gradle、 のビルドツールの新しいバージョンがありますmavenant。

JAR ファイル処理

AL2023/AL2 プラットフォームでは、ソースバンドル (ZIP ファイル) に 1 つのJARファイルが含まれていて、他のファイルが含まれていない場合、Elastic Beanstalk はJARファイルの名前を に変更しなくなりますapplication.jar。名前の変更は、JARファイル内ではなく、単独でZIPファイルを送信する場合にのみ発生します。

ポートの受け渡し

AL2023/AL2 プラットフォームでは、Elastic Beanstalk は PORT環境変数を介してアプリケーションプロセスにポート値を渡しません。PORT 環境プロパティを自分で設定することで、プロセスのこの動作をシミュレートできます。ただし、複数のプロセスがあり、Elastic Beanstalk が増分ポート値をプロセス (5000、5100、5200 など) に渡すことを期待している場合は、実装を変更する必要があります。詳細については、「Elastic Beanstalk Linux プラットフォームの拡張」の「リバースプロキシの設定」セクションを展開します。

Java 7

Elastic Beanstalk は AL2023/AL2Java 7 プラットフォームブランチをサポートしていません。Java 7 アプリケーションをお持ちの場合は、Corretto 8 または Corretto 11 に移行してください。

設定オプション

AL2023/AL2 プラットフォームバージョンでは、Elastic Beanstalk は aws:elasticbeanstalk:environment:proxy名前空間の設定オプションとオプション値のサブセットのみをサポートします。各オプションの移行情報は次のとおりです。

aws:elasticbeanstalk:container:tomcat:jvmoptions 名前空間の XX:MaxPermSizeオプションは、AL2023/AL2 プラットフォームバージョンではサポートされていません。永続世代のサイズを変更するJVM設定は Java 7 以前にのみ適用されるため、AL2023/AL2 プラットフォームバージョンには適用されません。

アプリケーションのパス

AL2023/AL2 プラットフォームでは、環境の Amazon EC2インスタンス上のアプリケーションのディレクトリへのパスは です/var/app/current。Amazon Linux AMIプラットフォーム/var/lib/tomcat8/webapps上に置かれていました。

インストールされている Node.js のバージョン

AL2023/AL2 プラットフォームでは、Elastic Beanstalk は複数の Node.js プラットフォームブランチを維持し、各プラットフォームバージョンのプラットフォームブランチに対応する最新バージョンの Node.js メジャーバージョンのみをインストールします。たとえば、Node.js 12 プラットフォームブランチの各プラットフォームバージョンには、デフォルトで Node.js 12.x.y のみがインストールされています。Amazon Linux AMIプラットフォームバージョンでは、各プラットフォームバージョンに複数の Node.js バージョンの複数のバージョンをインストールし、1 つのプラットフォームブランチのみを維持しました。

アプリケーションで必要な Node.js メジャーバージョンに対応する Node.js プラットフォームブランチを選択します。

Apache HTTPDログファイル名

AL2023/AL2 プラットフォームでは、Apache HTTPDプロキシサーバーを使用する場合、HTTPDログファイル名は access_logと でありerror_log、Apache をサポートする他のすべてのプラットフォームと一致しますHTTPD。Amazon Linux AMIプラットフォームバージョンでは、これらのログファイルerror.logの名前はそれぞれ access.logと でした。

すべてのプラットフォームのログファイル名と場所の詳細については、Elastic Beanstalk で CloudWatch ログを設定する方法 を参照してください。

設定オプション

AL2023/AL2 プラットフォームでは、Elastic Beanstalk は aws:elasticbeanstalk:container:nodejs名前空間の設定オプションをサポートしていません。オプションの中には、代替方法があります。各オプションの移行情報は次のとおりです。

var port = process.env.PORT || 5000;

app.listen(port, function() {
  console.log('Server running at http://127.0.0.1:%s', port);
});

PHP ファイル処理

AL2023/AL2 プラットフォームでは、PHPファイルは PHP-FPM (CGIプロセスマネージャー) を使用して処理されます。Amazon Linux AMIプラットフォームでは、mod_php (Apache モジュール) を使用しました。

プロキシサーバー

AL2023/AL2 PHPプラットフォームバージョンは、nginx と Apache HTTPDプロキシサーバーの両方をサポートします。デフォルトは nginx です。

Amazon Linux AMIPHPプラットフォームバージョンでは、Apache のみがサポートされていますHTTPD。カスタム Apache 設定ファイルを追加した場合は、aws:elasticbeanstalk:environment:proxy 名前空間の ProxyServer オプションを apache に設定できます。

WSGI サーバー

AL2023/AL2 プラットフォームでは、Gunicorn がデフォルトのWSGIサーバーです。デフォルトでは、Gunicorn はポート 8000 でリッスンします。ポートは、アプリケーションが Amazon Linux AMIプラットフォームで使用したものとは異なる場合があります。aws:elasticbeanstalk:container:python 名前空間の WSGIPath オプションを設定する場合は、値を Gunicorn の構文に置き換えます。詳細については、「Python 設定の名前空間」を参照してください。

または、 を使用してWSGIサーバーProcfileを指定および設定することもできます。詳細については、「Elastic Beanstalk で Procfile を使用してWSGIサーバーを設定する」を参照してください。

アプリケーションのパス

AL2023/AL2 プラットフォームでは、環境の Amazon EC2インスタンス上のアプリケーションのディレクトリへのパスは です/var/app/current。Amazon Linux AMIプラットフォーム/opt/python/current/app上に置かれていました。

プロキシサーバー

AL2023/AL2Python プラットフォームバージョンは、nginx と Apache HTTPDプロキシサーバーの両方をサポートします。デフォルトは nginx です。

Amazon Linux AMI Python プラットフォームバージョンは、Apache のみをサポートしていますHTTPD。カスタム Apache 設定ファイルを追加した場合は、aws:elasticbeanstalk:environment:proxy 名前空間の ProxyServer オプションを apache に設定できます。

インストールされている Ruby バージョン

AL2023/AL2 プラットフォームでは、Elastic Beanstalk はプラットフォームブランチに対応する単一の Ruby バージョンの最新バージョンのみを各プラットフォームバージョンにインストールします。たとえば、Ruby 2.6 プラットフォームブランチの各プラットフォームバージョンには Ruby 2.6.x のみインストールされています。Amazon Linux AMIプラットフォームバージョンでは、2.4.x、2.5.x、2.6.x など、複数の Ruby バージョンの最新バージョンをインストールしました。

使用しているプラットフォームブランチに対応していない Ruby バージョンをアプリケーションで使用している場合は、アプリケーションに適した Ruby バージョンのプラットフォームブランチに切り替えることをお勧めします。

アプリケーションサーバー

AL2023/AL2 プラットフォームでは、Elastic Beanstalk はすべての Ruby プラットフォームバージョンにのみ Puma アプリケーションサーバーをインストールします。Procfile を使用して別のアプリケーションサーバーをスタートし、Gemfile を使用してインストールできます。

Amazon Linux AMIプラットフォームでは、Ruby バージョンごとに 2 種類のプラットフォームブランチがサポートされました。1 つは Puma アプリケーションサーバー、もう 1 つは Passenger アプリケーションサーバーです。アプリケーションで Passenger を使用している場合は、Passenger をインストールして使用するように Ruby 環境を設定できます。

詳細な説明と例については、「 Elastic Beanstalk Ruby プラットフォームを使用する」を参照してください。