从 Amazon Linux AMI (AL1) 迁移到 o AL2 r AL2 023

由在亚马逊 Linux 上运行的亚马逊 ECS 管理的多容器 Docker AMI () AL1

基于 ECS 的 Docker AL2 023/ 平台AL2 分支

基于 ECS 的 Docker AL2 023/ AL2 平台分支为在多容器 Docker 平台分支上运行的环境提供了直接的迁移路径。 AL1

有关将多容器 Docker Amazon Linux 平台分支上运行的应用程序迁移到在 AL2023/ AL2 平台分支上运行的 Amazon ECS 的更多信息，请参阅。将您的 Elastic Beanstalk 应用程序从 AL1 上的 ECS 托管 Multi-container Docker 迁移到亚马逊 Linux 上的 ECS 2023

在亚马逊 Linux 上运行的 Docker AMI () AL1

运行亚马逊 Linux AMI 的预配置 Docker (Glassfish 5.0) () AL1

Docker 在 AL2 023/ 平台分支AL2 上运行

我们建议您将运行在基于预配置的 Docker（Glassfish 5.0）或在亚马逊 Linux AMI () 上运行的 Docker 环境中的应用程序迁移到基于在亚马逊 Linux 2 上运行的 Docker 或在 023 平台分支上运行的 Docker 的环境。AL1 AL2

如果您的环境基于预配置 Docker (Glassfish 5.0) 平台分支，请参阅 将 GlassFish 应用程序部署到 Docker 平台：2023 年亚马逊 Linux 的迁移之路。

下表列出了特定于平台分支 Docker 在 AL2 0 AL2 23/ 上运行的迁移信息。

端口传递

在 AL2 023/ AL2 平台上，Elastic Beanstalk 不会通过环境变量将端口值传递给您的应用程序进程。PORT您可以通过亲自配置 PORT 环境属性来模拟进程的此类行为。但是，如果您具有多个进程，并且您依赖于 Elastic Beanstalk 将增量端口值（5000、5100、5200 等）传递给进程，则应当修改您的实现。有关详细信息，请参阅 反向代理配置。

Corretto 与 OpenJDK

要实现 Java 平台、标准版 (Java SE)、 AL2 023/ AL2 平台分支，请使用 Amazon Corrett o，这是开放式 Java 开发套件 (OpenJDK) 的 AWS 发行版。早期 Elastic Beanstalk Java SE 平台分支使用 Amazon Linux AMI 随附的 OpenJDK 软件包。

构建工具

AL2023/ AL2 平台有较新版本的构建工具：gradlemaven、和。ant

JAR 文件处理

在 AL2 023/ AL2 平台上，如果您的源包（ZIP 文件）包含单个 JAR 文件而不包含其他文件，则 Elastic Beanstalk 将不再将 JAR 文件重命名为。application.jar仅当提交 JAR 文件自身（而不是包含在 ZIP 文件中）时，才会重命名。

端口传递

在 AL2 023/ AL2 平台上，Elastic Beanstalk 不会通过环境变量将端口值传递给您的应用程序进程。PORT您可以通过亲自配置 PORT 环境属性来模拟进程的此类行为。但是，如果您具有多个进程，并且您依赖于 Elastic Beanstalk 将增量端口值（5000、5100、5200 等）传递给进程，则应当修改您的实现。有关详细信息，请参阅 反向代理配置。

Java 7

Elastic Beanstalk 不 AL2支持 023/ Java 7 平台分AL2 支。如果您有 Java 7 应用程序，请将其迁移到 Corretto 8 或 Corretto 11。

配置选项

在 AL2 023/ AL2 平台版本上，Elastic Beanstalk 仅支持命名空间中配置选项和选项值的子集。aws:elasticbeanstalk:environment:proxy以下是每个选项的迁移信息。

AL2023/ AL2 平台aws:elasticbeanstalk:container:tomcat:jvmoptions版本不支持命名空间中的XX:MaxPermSize选项。修改永久生成大小的 JVM 设置仅适用于 Java 7 及更早版本，因此不适用于 AL2 023/ AL2 平台版本。

应用程序路径

在 AL2 023/ AL2 平台上，您的环境的 Amazon EC2 实例上应用程序目录的路径是。/var/app/current在 Amazon Linux AMI 平台上，该路径为 /var/lib/tomcat8/webapps。

已安装的 Node.js 版本

在 AL2 023/ 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 日志文件名

在 AL2 023/ AL2 平台上，如果您使用 Apache HTTPD 代理服务器，则 HTTPD 日志文件名为access_log和error_log，这与所有其他支持 Apache HTTPD 的平台一致。在 Amazon Linux AMI 平台版本上，这些日志文件分别命名为 access.log 和 error.log。

有关所有平台的日志文件名和位置的详细信息，请参阅 Elastic Beanstalk 是如何设置日志 CloudWatch 的。

配置选项

在 AL2 023/ 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 文件处理

在 AL2 023/ AL2 平台上，使用 PHP-FPM（CGI 进程管理器）处理 PHP 文件。在 Amazon Linux AMI 平台上，我们使用的是 mod_php（一个 Apache 模块）。

代理服务器

AL2023/ AL2 PHP 平台版本同时支持 nginx 和 Apache HTTPD 代理服务器。默认为 nginx。

Amazon Linux AMI PHP 平台版本仅支持 Apache HTTPD。如果您添加了自定义 Apache 配置文件，则可以将 aws:elasticbeanstalk:environment:proxy 命名空间中的 ProxyServer 选项设置为 apache。

WSGI 服务器

在 AL2 023/ AL2 平台上，Gunicorn 是默认的 WSG I 服务器。默认情况下，Gunicorn 侦听端口 8000。该端口可能与您的应用程序在 Amazon Linux AMI 平台上使用的端口不同。如果您正在设置 aws:elasticbeanstalk:container:python 命名空间的 WSGIPath 选项，请将该值替换为 Gunicorn 语法。有关更多信息，请参阅 Python 配置命名空间。

此外，您可以使用 Procfile 指定和配置 WSGI 服务器。有关更多信息，请参阅 在 Elastic Beanstalk 上使用 Procfile 配置 WSGI 服务器。

应用程序路径

在 AL2 023/ AL2 平台上，您的环境的 Amazon EC2 实例上应用程序目录的路径是。/var/app/current在 Amazon Linux AMI 平台上，该路径为 /opt/python/current/app。

代理服务器

AL2023/ Pyt AL2 hon 平台版本同时支持 nginx 和 Apache HTTPD 代理服务器。默认为 nginx。

Amazon Linux AMI Python 平台版本仅支持 Apache HTTPD。如果您添加了自定义 Apache 配置文件，则可以将 aws:elasticbeanstalk:environment:proxy 命名空间中的 ProxyServer 选项设置为 apache。

已安装 Ruby 版本

在 AL2 023/ 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 版本的平台分支。

应用程序服务器

在 AL2 023/ AL2 平台上，Elastic Beanstalk 仅在所有 Ruby 平台版本上安装 Puma 应用服务器。您可以使用 Procfile 启动其他应用程序服务器，并使用 Gemfile 来安装它。

在 Amazon Linux AMI 平台上，对于每个 Ruby 版本，我们支持两种平台分支 - 一种具有 Puma 应用程序服务器，另一种具有 Passenger 应用服务器。如果您的应用程序使用 Passenger，则可以将 Ruby 环境配置为安装和使用 Passenger。

有关更多信息以及示例，请参阅 使用 Elastic Beanstalk Ruby 平台。