AWS Elastic Beanstalk
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

特定于平台的选项

Docker 平台选项

以下 Docker 特定的配置选项适用于单容器和预配置的 Docker 平台。

注意

这些配置选项不适用于多容器 Docker 平台。

命名空间: aws:elasticbeanstalk:environment:proxy

名称 描述 默认值 有效值

ProxyServer

指定要用作代理的 Web 服务器。

nginx

nginx

none

Go 平台选项

您可以使用以下命名空间来配置代理服务器提供静态文件。当代理服务器收到对指定路径下的某个文件的请求时,它将直接提供此文件而不是将请求路由至您的应用程序。这将减少您的应用程序必须处理的请求的数量。

在源代码中将代理服务器提供的路径映射到包含静态资产的文件夹。在此命名空间中定义的每个选项都映射不同的路径。

命名空间: aws:elasticbeanstalk:container:golang:staticfiles

名称

代理服务器将提供文件的路径。

示例:/images 将在 subdomain.eleasticbeanstalk.com/images 提供文件。

包含文件的文件夹名称。

示例:staticimages 将在源包顶部从名为 staticimages 的文件夹中提供文件。

运行 AWS X-Ray 守护程序以中继来自您的 X-Ray 集成 Go 应用程序的跟踪信息。

命名空间: aws:elasticbeanstalk:xray

名称 描述 默认值 有效值

XRayEnabled

设为 true 以在环境中的实例上运行 AWS X-Ray 守护程序。

false

true

false

Java SE 平台选项

您可以使用以下命名空间来配置代理服务器提供静态文件。当代理服务器收到对指定路径下的某个文件的请求时,它将直接提供此文件而不是将请求路由至您的应用程序。这将减少您的应用程序必须处理的请求的数量。

在源代码中将代理服务器提供的路径映射到包含静态资产的文件夹。在此命名空间中定义的每个选项都映射不同的路径。

命名空间: aws:elasticbeanstalk:container:java:staticfiles

名称

代理服务器将提供文件的路径。

示例:/images 将在 subdomain.eleasticbeanstalk.com/images 提供文件。

包含文件的文件夹名称。

示例:staticimages 将在源包顶部从名为 staticimages 的文件夹中提供文件。

运行 AWS X-Ray 守护程序以中继来自您的 X-Ray 集成 Java 8 应用程序的跟踪信息。

命名空间: aws:elasticbeanstalk:xray

名称 描述 默认值 有效值

XRayEnabled

设为 true 以在环境中的实例上运行 AWS X-Ray 守护程序。

false

true

false

具有 Tomcat 的 Java 平台选项

命名空间: aws:elasticbeanstalk:application:environment

名称 描述 默认值 有效值

JDBC_CONNECTION_STRING

外部数据库的连接字符串。

不适用

不适用

参阅 环境属性和其他软件设置 了解更多信息。

命名空间: aws:elasticbeanstalk:container:tomcat:jvmoptions

名称 描述 默认值 有效值

JVM Options

在启动时将命令行选项传递给 JVM。

不适用

不适用

Xmx

最大 JVM 堆大小。

256m

不适用

XX:MaxPermSize

JVM 堆中用于存储类定义和相关元数据的部分。

64m

不适用

Xms

初始 JVM 堆大小。

256m

不适用

optionName

除了 Tomcat 平台定义的选项外,还指定任意 JVM 选项。

不适用

不适用

命名空间: aws:elasticbeanstalk:environment:proxy

名称 描述 默认值 有效值

GzipCompression

设置为 false 以禁用响应压缩。

true

true

false

ProxyServer

设置要在环境的实例上使用的代理。如果未设置此选项,或者将其设置为 apache,则 Elastic Beanstalk 将使用 Apache 2.4

如果应用程序由于代理配置设置不兼容未准备好从 Apache 2.2 迁移,则设置为 apache/2.2

设置为 nginx 以使用 nginx

有关更多信息,请参阅 配置 Tomcat 环境的代理服务器

apache

apache

apache/2.2

nginx

您可以使用以下命名空间来配置代理服务器提供静态文件。当代理服务器收到对指定路径下的某个文件的请求时,它将直接提供此文件而不是将请求路由至您的应用程序。这将减少您的应用程序必须处理的请求的数量。

在源代码中将代理服务器提供的路径映射到包含静态资产的文件夹。在此命名空间中定义的每个选项都映射不同的路径。

命名空间: aws:elasticbeanstalk:environment:proxy:staticfiles

名称

代理服务器将提供文件的路径。

示例:/images 将在 subdomain.eleasticbeanstalk.com/images 提供文件。

包含文件的文件夹名称。

示例:staticimages 将在源包顶部从名为 staticimages 的文件夹中提供文件。

运行 AWS X-Ray 守护程序以中继来自您的 X-Ray 集成 Tomcat 8 应用程序的跟踪信息。

命名空间: aws:elasticbeanstalk:xray

名称 描述 默认值 有效值

XRayEnabled

设为 true 以在环境中的实例上运行 AWS X-Ray 守护程序。

false

true

false

.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

运行 AWS X-Ray 守护程序以中继来自您的 X-Ray 集成 .NET 应用程序的跟踪信息。

命名空间: aws:elasticbeanstalk:xray

名称 描述 默认值 有效值

XRayEnabled

设为 true 以在环境中的实例上运行 AWS X-Ray 守护程序。

false

true

false

Node.js 平台选项

命名空间: aws:elasticbeanstalk:container:nodejs

名称 描述 默认值 有效值

NodeCommand

用来启动 Node.js 应用程序的命令。如果指定空字符串,则依次使用 app.jsserver.jsnpm start

""

不适用

NodeVersion

Node.js 的版本。例如,4.4.6

支持的 Node.js 版本因 Node.js 平台配置的版本而异。有关目前受支持版本的列表,请参阅 AWS Elastic Beanstalk 平台 文档中的 Node.js

注意

如果对您正在使用的 Node.js 版本的支持已从平台配置中移除,则您必须先更改或移除版本设置再进行平台升级。当在一个或多个 Node.js 版本中识别到安全漏洞时,可能会发生这种情况。

发生此情况时,尝试升级到不支持所配置的 NodeVersion 的新平台版本会失败。要避免需要创建新环境,请将 NodeVersion 配置选项更改为旧配置版本和新配置版本均支持的版本,或移除选项设置,然后执行平台升级。

变化 变化

GzipCompression

指定是否启用 gzip 压缩。如果将 ProxyServer 设置为 none,则会禁用 gzip 压缩。

false

true

false

ProxyServer

指定应使用哪台 Web 服务器来代理与 Node.js 的连接。如果 ProxyServer 设置为 none,则静态文件映射不会生效,并且 gzip 压缩将被禁用。

nginx

apache

nginx

none

您可以使用以下命名空间来配置代理服务器提供静态文件。当代理服务器收到对指定路径下的某个文件的请求时,它将直接提供此文件而不是将请求路由至您的应用程序。这将减少您的应用程序必须处理的请求的数量。

在源代码中将代理服务器提供的路径映射到包含静态资产的文件夹。在此命名空间中定义的每个选项都映射不同的路径。

注意

如果 aws:elasticbeanstalk:container:nodejs::ProxyFiles 设置为 none,将不应用静态文件设置。

命名空间: aws:elasticbeanstalk:container:nodejs:staticfiles

名称

代理服务器将提供文件的路径。

示例:/images 将在 subdomain.eleasticbeanstalk.com/images 提供文件。

包含文件的文件夹名称。

示例:staticimages 将在源包顶部从名为 staticimages 的文件夹中提供文件。

运行 AWS X-Ray 守护程序以中继来自您的 X-Ray 集成 Node.js 应用程序的跟踪信息。

命名空间: aws:elasticbeanstalk:xray

名称 描述 默认值 有效值

XRayEnabled

设为 true 以在环境中的实例上运行 AWS X-Ray 守护程序。

false

true

false

PHP 平台选项

命名空间: aws:elasticbeanstalk:container:php:phpini

名称 描述 默认值 有效值

document_root

指定项目的子目录,这也是面向公众的 Web 根目录。

/

将空字符串视为 /,或指定以 / 开头的字符串

memory_limit

分配给 PHP 环境的内存量。

256M

不适用

zlib.output_compression

指定 PHP 在输出时是否应使用压缩。

Off

On

Off

allow_url_fopen

指定是否允许 PHP 的文件功能从远程位置 (如网站或 FTP 服务器) 检索数据。

On

On

Off

display_errors

指定错误消息是否应该是输出的一部分。

Off

On

Off

max_execution_time

设置一个脚本在被环境终止前允许运行的最长时间,计算单位为秒。

60

09223372036854775807 (PHP_INT_MAX)

composer_options

设置各种通过 composer.phar 安装并使用 Composer 安装依赖项时要使用的自定义选项。有关包括可用选项在内的更多信息,请转到 http://getcomposer.org/doc/03-cli.md#install

不适用

不适用

注意

有关 PHP 平台的更多信息,请参阅使用 AWS Elastic Beanstalk PHP 平台

Python 平台选项

命名空间: aws:elasticbeanstalk:application:environment

名称 描述 默认值 有效值

DJANGO_SETTINGS_MODULE

指定要使用的设置文件。

不适用

不适用

参阅 环境属性和其他软件设置 了解更多信息。

命名空间: aws:elasticbeanstalk:container:python

名称 描述 默认值 有效值

WSGIPath

包含 WSGI 应用程序的文件。此文件必须有一个可调用的 application

application.py

不适用

NumProcesses

运行 WSGI 应用程序时,应为进程组启动的守护程序进程数。

1

不适用

NumThreads

运行 WSGI 应用程序时,为了处理进程组内部每个守护程序进程中的请求而要创建的线程数。

15

不适用

您可以使用以下命名空间来配置代理服务器提供静态文件。当代理服务器收到对指定路径下的某个文件的请求时,它将直接提供此文件而不是将请求路由至您的应用程序。这将减少您的应用程序必须处理的请求的数量。

在源代码中将代理服务器提供的路径映射到包含静态资产的文件夹。在此命名空间中定义的每个选项都映射不同的路径。

命名空间: aws:elasticbeanstalk:container:python:staticfiles

名称

代理服务器将提供文件的路径。

示例:/images 将在 subdomain.eleasticbeanstalk.com/images 提供文件。

包含文件的文件夹名称。

示例:staticimages 将在源包顶部从名为 staticimages 的文件夹中提供文件。

运行 AWS X-Ray 守护程序以中继来自 X-Ray 集成 Python 应用程序的跟踪信息。

命名空间: aws:elasticbeanstalk:xray

名称 描述 默认值 有效值

XRayEnabled

设为 true 以在环境中的实例上运行 AWS X-Ray 守护程序。

false

true

false

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

不适用

参阅 环境属性和其他软件设置 了解更多信息。