从 Amazon Linux AMI（AL1）迁移到 AL2 或 AL2023

由运行于 Amazon Linux AMI (AL1) 上的 Amazon ECS 托管的多容器 Docker

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

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

有关将在多容器 Docker Amazon Linux 平台分支上运行的应用程序迁移到在 AL2023/AL2 上运行的 Amazon ECS 平台分支的更多信息，请参阅 将在 Amazon Linux 上运行的多容器 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) 平台分支，请参阅 将 GlassFish 应用程序部署到 Docker 平台：迁移到 Amazon Linux 2023 的路径。

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

端口传递

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

Corretto 与 OpenJDK

为了实现标准版（Java SE）Java 平台，AL2023/AL2 平台分支使用 Amazon Corretto，它是开放式 Java 开发工具包（OpenJDK）的 Amazon 分发版。早期 Elastic Beanstalk Java SE 平台分支使用 Amazon Linux AMI 随附的 OpenJDK 软件包。

构建工具

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

JAR 文件处理

在 AL2023/AL2 平台上，如果源包（ZIP 文件）包含单个 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/AL2 Java 7 平台分支。如果您有 Java 7 应用程序，请将其迁移到 Corretto 8 或 Corretto 11。

配置选项

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

AL2023/AL2 平台版本不支持 aws:elasticbeanstalk:container:tomcat:jvmoptions 命名空间中的 XX:MaxPermSize 选项。用于修改永久代大小的 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 版本的多个版本，并且只维护一个平台分支。

选择与您的应用程序所需的 Node.js 主版本对应的 Node.js 平台分支。

Apache HTTPD 日志文件名

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

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

配置选项

在 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-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 服务器

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

此外，您可以使用 Procfile 指定和配置 WSGI 服务器。有关详细信息，请参阅 使用 Procfile 配置 WSGI 服务器。

应用程序路径。

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

代理服务器

AL2023/AL2 Python 平台版本同时支持 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 平台版本上，我们安装了多个 Ruby 版本的最新版本，例如 2.4.x、2.5.x 和 2.6.x。

如果您的应用程序使用的 Ruby 版本与您正在使用的平台分支不对应，建议您切换到具有适合您的应用程序的 Ruby 版本的平台分支。

应用程序服务器

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

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

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