本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 特定于平台的选项 某些 Elastic Beanstalk 平台定义特定于平台的选项命名空间。下面列出了每个平台的这些命名空间及其选项。 **注意** 以前，在基于 Amazon Linux AMI（在 Amazon Linux 2 之前）的平台版本中，以下两个功能及其各自的命名空间被视为特定于平台的功能，并且在此处按平台列出： **静态文件的代理配置** - `aws:elasticbeanstalk:environment:proxy:staticfiles` **AWS X-Ray 支持** — `aws:elasticbeanstalk:xray` 在 Amazon Linux 2 平台版本中，Elastic Beanstalk 以一致的方式在所有支持平台上实现这些功能。相关的命名空间现在列在 [面向所有环境的常规选项](command-options-general.md) 页面中。对于命名空间名称不同的平台，我们只在此页面上提到它们。 **Topics** + [Docker 平台选项](#command-options-docker) + [Go 平台选项](#command-options-golang) + [Java SE 平台选项](#command-options-plain-java) + [具有 Tomcat 的 Java 平台选项](#command-options-java) + [Linux 上的 .NET Core 平台选项](#command-options-dotnet-core-linux) + [.NET 平台选项](#command-options-net) + [Node.js 平台选项](#command-options-nodejs) + [PHP 平台选项](#command-options-php) + [Python 平台选项](#command-options-python) + [Ruby 平台选项](#command-options-ruby) ## Docker 平台选项 以下 Docker 特定的配置选项适用于 Docker 和预配置的 Docker 平台。 **注意** 这些配置选项不适用于 带 Docker Compose 的 Docker 平台（Amazon Linux 2） 多容器 Docker 平台（亚马逊 Linux AMI AL1）——该平台已停用 **命名空间: `aws:elasticbeanstalk:environment:proxy`** | **名称** | **描述** | **默认** | **有效值** | | --- | --- | --- | --- | | ProxyServer | 指定要用作代理的 Web 服务器。 | `nginx` | `nginx`
`none`— 仅限*亚马逊 Linux AM* 和 *Docker w/DC * | ## Go 平台选项 ### Amazon Linux AMI（先前的 Amazon Linux 2）平台选项 #### 命名空间: `aws:elasticbeanstalk:container:golang:staticfiles` 您可以使用以下命名空间来配置代理服务器提供静态文件。当代理服务器收到对指定路径下的某个文件的请求时，它将直接提供此文件，而不是将请求路由至您的应用程序。这将减少您的应用程序必须处理的请求的数量。 在源代码中将代理服务器提供的路径映射到包含静态资产的文件夹。在此命名空间中定义的每个选项都映射不同的路径。 | **名称** | **值** | | --- | --- | | 代理服务器将提供文件的路径。
示例：`/images` 将在 `{{subdomain}}.eleasticbeanstalk.com/images` 提供文件。 | 包含文件的文件夹名称。
示例：`staticimages` 将在源代码包顶层从名为 `staticimages` 的文件夹中提供文件。 | ## Java SE 平台选项 ### Amazon Linux AMI（先前的 Amazon Linux 2）平台选项 #### 命名空间: `aws:elasticbeanstalk:container:java:staticfiles` 您可以使用以下命名空间来配置代理服务器提供静态文件。当代理服务器收到对指定路径下的某个文件的请求时，它将直接提供此文件，而不是将请求路由至您的应用程序。这将减少您的应用程序必须处理的请求的数量。 在源代码中将代理服务器提供的路径映射到包含静态资产的文件夹。在此命名空间中定义的每个选项都映射不同的路径。 | **名称** | **值** | | --- | --- | | 代理服务器将提供文件的路径。
示例：`/images` 将在 `{{subdomain}}.eleasticbeanstalk.com/images` 提供文件。 | 包含文件的文件夹名称。
示例：`staticimages` 将在源代码包顶层从名为 `staticimages` 的文件夹中提供文件。 | ## 具有 Tomcat 的 Java 平台选项 **命名空间: `aws:elasticbeanstalk:application:environment`** | **名称** | **描述** | **默认** | **有效值** | | --- | --- | --- | --- | | JDBC\_CONNECTION\_STRING | 外部数据库的连接字符串。 | 不适用 | 不适用 | 有关更多信息，请参阅 [环境变量和其他软件设置](environments-cfg-softwaresettings.md)。 **命名空间: `aws:elasticbeanstalk:container:tomcat:jvmoptions`** | **名称** | **描述** | **默认** | **有效值** | | --- | --- | --- | --- | | JVM Options | 在启动时将命令行选项传递给 JVM。 | 不适用 | 不适用 | | Xmx | 最大 JVM 堆大小。 | `256m` | 不适用 | | XX:MaxPermSize | JVM 堆中用于存储类定义和相关元数据的部分。 此选项仅适用于 Java 8 之前的 Java 版本，基于 Amazon Linux 2 和更高版本的 Elastic Beanstalk Tomcat 平台不支持此选项。 | `64m` | 不适用 | | Xms | 初始 JVM 堆大小。 | `256m` | 不适用 | | {{optionName}} | 除了 Tomcat 平台定义的选项外，还指定任意 JVM 选项。 | 不适用 | 不适用 | **命名空间: `aws:elasticbeanstalk:environment:proxy`** | **名称** | **描述** | **默认** | **有效值** | | --- | --- | --- | --- | | GzipCompression | 设置为 `false` 以禁用响应压缩。
*仅在 Amazon Linux AMI（在 Amazon Linux 2 之前）平台版本上有效。* | `true` | `true`
`false` | | ProxyServer | 设置要在环境的实例上使用的代理。如果将此选项设置为 `apache`，则 Elastic Beanstalk 将使用 [Apache 2.4](https://httpd.apache.org/docs/2.4/)。
如果应用程序由于代理配置设置不兼容未准备好从 [Apache 2.2](https://httpd.apache.org/docs/2.2/) 迁移，则设置为 `apache/2.2`。*此值仅在 Amazon Linux AMI（在 Amazon Linux 2 之前）平台版本上有效。*
设置为 `nginx` 以使用 [nginx](https://www.nginx.com/)。这是以 Amazon Linux 2 平台版本开始的默认值。
有关更多信息，请参阅 [配置代理服务器](java-tomcat-proxy.md)。 | `nginx` (Amazon Linux 2)
`apache` (Amazon Linux AMI) | `apache`
`apache/2.2` – *仅限 Amazon Linux AMI*
`nginx` | ## Linux 上的 .NET Core 平台选项 **命名空间: `aws:elasticbeanstalk:environment:proxy`** | **名称** | **描述** | **默认** | **有效值** | | --- | --- | --- | --- | | ProxyServer | 指定要用作代理的 Web 服务器。 | `nginx` | `nginx`
`none` | ## .NET 平台选项 **命名空间: `aws:elasticbeanstalk:container:dotnet:apppool`** | **名称** | **描述** | **默认** | **有效值** | | --- | --- | --- | --- | | Target Runtime | 选择用于应用程序的 .NET Framework 版本。 | `4.0` | `2.0`
`4.0` | | Enable 32-bit Applications | 设置为 `True` 以运行 32 位应用程序。 | `False` | `True`
`False` | ## Node.js 平台选项 **命名空间: `aws:elasticbeanstalk:environment:proxy`** | **名称** | **描述** | **默认** | **有效值** | | --- | --- | --- | --- | | ProxyServer | 设置要在环境的实例上使用的代理。 | `nginx` | `apache`
`nginx` | ### Amazon Linux AMI（先前的 Amazon Linux 2）平台选项 #### 命名空间: `aws:elasticbeanstalk:container:nodejs` | **名称** | **描述** | **默认** | **有效值** | | --- | --- | --- | --- | | NodeCommand | 用来启动 Node.js 应用程序的命令。如果指定空字符串，则依次使用 `app.js`、`server.js` 和 `npm start`。 | "" | 不适用 | | NodeVersion | Node.js 的版本。例如：`4.4.6`。
支持的 Node.js 版本因 Node.js 平台版本而异。有关目前受支持版本的列表，请参阅 *AWS Elastic Beanstalk 平台文档*中的 [Node.js](https://docs.aws.amazon.com/elasticbeanstalk/latest/platforms/platforms-supported.html#platforms-supported.nodejs)。 如果对您正在使用的 Node.js 版本的支持已从平台中移除，则您必须先更改或移除版本设置再进行[平台更新](using-features.platform.upgrade.md)。当在一个或多个 Node.js 版本中识别到安全漏洞时，可能会发生这种情况。
发生这种情况时，尝试更新到不支持配置的平台的新版本会[NodeVersion](#command-options-nodejs)失败。为避免需要创建新环境，请将*NodeVersion*配置选项更改为旧平台版本和新平台版本都支持的 Node.js 版本，或者[删除该选项设置](environment-configuration-methods-after.md)，然后执行平台更新。 | 变化 | 变化 | | GzipCompression | 指定是否启用 gzip 压缩。如果设置 ProxyServer 为`none`，则禁用 gzip 压缩。 | `false` | `true`
`false` | | ProxyServer | 指定应使用哪台 Web 服务器来代理与 Node.js 的连接。如果设置 ProxyServer 为`none`，则静态文件映射不生效并禁用 gzip 压缩。 | `nginx` | `apache`
`nginx`
`none` | #### 命名空间: `aws:elasticbeanstalk:container:nodejs:staticfiles` 您可以使用以下命名空间来配置代理服务器提供静态文件。当代理服务器收到对指定路径下的某个文件的请求时，它将直接提供此文件，而不是将请求路由至您的应用程序。这将减少您的应用程序必须处理的请求的数量。 在源代码中将代理服务器提供的路径映射到包含静态资产的文件夹。在此命名空间中定义的每个选项都映射不同的路径。 **注意** 如果 `aws:elasticbeanstalk:container:nodejs::ProxyFiles` 设置为 `none`，将不应用静态文件设置。 | **名称** | **值** | | --- | --- | | 代理服务器将提供文件的路径。
示例：`/images` 将在 `{{subdomain}}.eleasticbeanstalk.com/images` 提供文件。 | 包含文件的文件夹名称。
示例：`staticimages` 将在源代码包顶层从名为 `staticimages` 的文件夹中提供文件。 | ## PHP 平台选项 **命名空间: `aws:elasticbeanstalk:container:php:phpini`** | **名称** | **描述** | **默认** | **有效值** | | --- | --- | --- | --- | | document\_root | 指定项目的子目录，这也是面向公众的 Web 根目录。 | `/` | 将空字符串视为 `/`，或指定以 `/` 开头的字符串 | | memory\_limit | 分配给 PHP 环境的内存量。 | `256M` | 不适用 | | zlib.output\_compression | 指定 PHP 在输出时是否应使用压缩。 | `Off` | `On`
`Off`
`true`
`false` | | allow\_url\_fopen | 指定是否允许 PHP 的文件功能从远程位置 (如网站或 FTP 服务器) 检索数据。 | `On` | `On`
`Off`
`true`
`false` | | display\_errors | 指定错误消息是否应该是输出的一部分。 | `Off` | `On`
`Off` | | max\_execution\_time | 设置一个脚本在被环境终止前允许运行的最长时间，计算单位为秒。 | `60` | `0` 至 `9223372036854775807` (PHP\_INT\_MAX) | | composer\_options | 设置通过 **composer.phar install** 命令使用 Composer 安装依赖项时要使用的自定义选项。有关更多信息，请参阅 *getcomposer.org* 网站上的 [install](https://getcomposer.org/doc/03-cli.md#install-i)。 | 不适用 | 不适用 | **命名空间: `aws:elasticbeanstalk:environment:proxy`** | **名称** | **描述** | **默认** | **有效值** | | --- | --- | --- | --- | | ProxyServer | 设置要在环境的实例上使用的代理。 | `nginx` | `apache`
`nginx` | **注意** 有关 PHP 平台的更多信息，请参阅[使用 Elastic Beanstalk PHP 平台](create_deploy_PHP.container.md)。 ## Python 平台选项 **命名空间: `aws:elasticbeanstalk:application:environment`** | **名称** | **描述** | **默认** | **有效值** | | --- | --- | --- | --- | | DJANGO\_SETTINGS\_MODULE | 指定要使用的设置文件。 | 不适用 | 不适用 | 有关更多信息，请参阅 [环境变量和其他软件设置](environments-cfg-softwaresettings.md)。 **命名空间: `aws:elasticbeanstalk:container:python`** | **名称** | **描述** | **默认** | **有效值** | | --- | --- | --- | --- | | WSGIPath | 包含 WSGI 应用程序的文件。此文件必须有一个可调用的 `application`。 | 在 Amazon Linux 2 Python 平台版本上：`application`
在 Amazon Linux AMI Python 平台版本上：`application.py` | 不适用 | | NumProcesses | 运行 WSGI 应用程序时，应为进程组启动的守护程序进程数。 | `1` | 不适用 | | NumThreads | 运行 WSGI 应用程序时，为了处理进程组内部每个守护程序进程中的请求而要创建的线程数。 | `15` | 不适用 | **命名空间: `aws:elasticbeanstalk:environment:proxy`** | **名称** | **描述** | **默认** | **有效值** | | --- | --- | --- | --- | | ProxyServer | 设置要在环境的实例上使用的代理。 | `nginx` | `apache`
`nginx` | ### Amazon Linux AMI（先前的 Amazon Linux 2）平台选项 #### 命名空间: `aws:elasticbeanstalk:container:python:staticfiles` 您可以使用以下命名空间来配置代理服务器提供静态文件。当代理服务器收到对指定路径下的某个文件的请求时，它将直接提供此文件，而不是将请求路由至您的应用程序。这将减少您的应用程序必须处理的请求的数量。 在源代码中将代理服务器提供的路径映射到包含静态资产的文件夹。在此命名空间中定义的每个选项都映射不同的路径。 默认情况下，Python 环境中的代理服务器提供 `static` 路径下名为 `/static` 的文件夹中的任何文件。 **命名空间: `aws:elasticbeanstalk:container:python:staticfiles`** | **名称** | **值** | | --- | --- | | 代理服务器将提供文件的路径。
示例：`/images` 将在 `{{subdomain}}.eleasticbeanstalk.com/images` 提供文件。 | 包含文件的文件夹名称。
示例：`staticimages` 将在源代码包顶层从名为 `staticimages` 的文件夹中提供文件。 | ## Ruby 平台选项 **命名空间: `aws:elasticbeanstalk:application:environment`** | **名称** | **描述** | **默认** | **有效值** | | --- | --- | --- | --- | | RAILS\_SKIP\_MIGRATIONS | 指定是代表用户的应用程序运行``rake db:migrate``，还是应跳过它。此功能仅适用于 Rails 3 应用程序。 | `false` | `true`
`false` | | RAILS\_SKIP\_ASSET\_COMPILATION | 指定该容器是应代表用户的应用程序运行``rake assets:precompile` `，还是应跳过它。此功能也仅适用于 Rails 3 应用程序。 | `false` | `true`
`false` | | BUNDLE\_WITHOUT | 从 Gemfile 安装依赖项时要忽略的组列表，用冒号 (`:`) 分隔。 | `test:development` | 不适用 | | RACK\_ENV | 指定可以运行应用程序的环境阶段。常见的环境示例包括开发、生产和测试。 | `production` | 不适用 | 参阅 [环境变量和其他软件设置](environments-cfg-softwaresettings.md) 了解更多信息。