从亚马逊 Linux AMI (AL1) 迁移到AL2或 AL2 023

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

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

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

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

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

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

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

我们建议您将运行在基于预配置 Docker（Glassfish 5.0）或亚马逊 Linux () 上运行的 Docker 环境中的应用程序迁移到基于在亚马逊 Linux AMI 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 等）传递给进程，则应当修改您的实现。有关详细信息，请展开 扩展 Elastic Beanstalk Linux 平台 中的反向代理配置部分。

Corretto vs Open JDK

要实现 Java 平台、标准版 (Java SE)、AL2 023/ AL2 平台分支，请使用 Amazon Corrett o，这是开放式 Java 开发套件（开放）的 AWS 发行版。JDK之前的 Elastic Beanstalk Java SE 平台分支使用亚马逊 Linux 附带的 Ope JDK n 软件包。AMI

构建工具

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

JAR文件处理

在 AL2 023/ AL2 平台上，如果您的源包（ZIP文件）包含单个文件而不包含其他文件，则 E JAR lastic Beanstalk 将不再将该文件重命名为。JAR application.jar只有在您自己提交JAR文件时才会进行重命名，而不是在ZIP文件中提交。

端口传递

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

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它在亚马逊 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文件。在亚马逊 Linux AMI 平台上，我们使用了 mod_php（一个 Apache 模块）。

代理服务器

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

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

WSGI服务器

在 AL2 023/ AL2 平台上，Gunicorn 是默认服务器。WSGI默认情况下，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它在亚马逊 Linux AMI 平台/opt/python/current/app上。

代理服务器

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

亚马逊 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。在亚马逊 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 应用程序服务器，另一种使用 Passenter 应用程序服务器。如果您的应用程序使用 Passenger，则可以将 Ruby 环境配置为安装和使用 Passenger。

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