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

使用 AWS Elastic Beanstalk Tomcat 平台

AWS Elastic Beanstalk Tomcat 平台是一组环境配置,用于可以在 Tomcat Web 容器中运行的 Java Web 应用程序。每种配置都对应于 Tomcat 的一个主要版本(如 Java 8 with Tomcat 8)。

在 AWS 管理控制台中提供了平台特定的配置选项,可用于修改运行环境的配置。要避免在终止环境时丢失环境配置,可以使用保存的配置来保存您的设置,并在以后将这些设置应用到其他环境。

要保存源代码中的设置,您可以包含配置文件。在您每次创建环境或部署应用程序时,会应用配置文件中的设置。您还可在部署期间使用配置文件来安装程序包、运行脚本以及执行其他实例自定义操作。

Elastic Beanstalk Tomcat 平台配置包括将请求转发到应用程序的反向代理。默认服务器为 Apache HTTP 服务器版本 2.4。可以使用配置选项将 Elastic Beanstalk 配置为使用早期 Apache HTTP 服务器版本 2.2,或使用 nginx。Elastic Beanstalk 还提供了配置选项,可以将代理服务器配置为为您的源代码中的某个文件夹中的静态资产提供服务,以减少应用程序的负载。对于高级方案,可以在源包中放置您自己的 .conf 文件,以扩展 Elastic Beanstalk 代理配置或将其完全重写。

您必须在具有特定结构的 Web 应用程序存档 (WAR) 文件中打包 Java 应用程序。有关所需结构以及它如何与项目目录结构相关联的信息,请参阅项目文件夹结构设置

要在同一 Web 服务器上运行多个应用程序,您可以将多个 WAR 文件捆绑到同一个源包中。多 WAR 源包中的每个应用程序在根路径运行 (ROOT.warmyapp.elasticbeanstalk.com/ 运行),或者在根路径的直接下级路径运行 (app2.warmyapp.elasticbeanstalk.com/app2/ 运行),具体通过 WAR 的名称确定。在单 WAR 源包中,应用程序始终在根路径运行。

AWS 管理控制台中应用的设置覆盖配置文件中的相同设置(如果存在)。这让您可以在配置文件中包含默认设置,并使用控制台中的特定环境设置加以覆盖。如需了解有关优先顺序和其他设置更改方法的更多信息,请参阅配置选项

配置 Tomcat 环境

对于 Elastic Beanstalk 上的 Tomcat 平台配置,Elastic Beanstalk 除了它为所有环境提供的标准选项之外,还提供了一些特定于平台的选项。这些选项可用于配置在环境的 Web 服务器上运行的 Java 虚拟机 (JVM),以及定义向应用程序提供信息配置字符串的系统属性。

您可以使用 AWS 管理控制台启用到 Amazon S3 的日志轮换并配置应用程序可从该环境中读取的变量。

在 Elastic Beanstalk 控制台中配置 Tomcat 环境

  1. 打开 Elastic Beanstalk 控制台

  2. 导航到您的环境的管理页

  3. 选择 Configuration

  4. Software 配置卡上,选择 Modify

JVM 容器选项

Java 虚拟机 (JVM) 中的堆大小决定了在垃圾收集发生之前,您的应用程序中多少个对象可以在内存中创建。您可以修改 Initial JVM Heap Size (-Xms argument) (初始 JVM 堆大小(-Xms 参数))Maximum JVM Heap Size (-Xmx argument) (最大 JVM 堆大小(-Xmx 参数))。初始堆大小越大,垃圾收集发生之前可以创建的对象就越多,但这也意味着垃圾收集器将花更长的时间去压缩堆。最大堆大小指定了在占用大量内存的活动期间扩展堆时,JVM 可分配的最大内存量。

注意

可用内存取决于 Amazon EC2 实例类型。有关可用于您的 Elastic Beanstalk 环境的 EC2 实例类型的更多信息,请参阅适用于 Linux 实例的 Amazon Elastic Compute Cloud 用户指南中的实例类型

持久代 是 JVM 堆的一部分,可存储类定义和关联的元数据。要修改持久代的大小,请在 Maximum JVM PermGen Size (-XX:MaxPermSize argument) (最大 JVM PermGen 大小(-XX:MaxPermSize 参数)) 字段中键入新的大小。此设置仅适用于 Java 7 和更低版本。

日志选项

日志选项部分有两个设置:

  • 实例配置文件 – 指定有权访问 Amazon S3 存储桶的实例配置文件,该存储桶与您的应用程序关联。

  • Enable log file rotation to Amazon S3 - 指定应用程序的 Amazon EC2 实例的日志文件是否应复制到与应用程序相关联的 Amazon S3 存储桶。

静态文件

为了提高性能,您可以配置代理服务器,从 Web 应用程序内的一组目录中提供静态文件(例如 HTML 或图像)。当代理服务器收到对指定路径下的某个文件的请求时,它将直接提供此文件而不是将请求路由至您的应用程序。您可以在 Modify software (修改软件) 配置页面的 Static Files (静态文件) 部分中设置虚拟路径和目录映射。添加映射时,如果您添加另一个映射,则会显示额外的一行。要删除映射,请单击“Remove”。

 Elastic Beanstalk 控制台中“Modify software (修改软件)”配置页面中的静态文件配置

如果看不到 Static Files (静态文件) 部分,您必须使用配置选项至少添加一个映射。例如,以下配置文件添加两个虚拟路径和目录映射,目录位于您的源包的顶层。

例 .ebextensions/java-tomcat-static-files.config

option_settings: aws:elasticbeanstalk:environment:proxy:staticfiles: /html: statichtml /images: staticimages

环境属性

Environment Properties (环境属性) 部分中,可以在运行应用程序的 Amazon EC2 实例上指定环境配置设置。环境属性会以密钥值对的形式传递到应用程序。

Tomcat 平台为 Tomcat 环境定义了一个名为 JDBC_CONNECTION_STRING 的占位符属性,用于传递连接外部数据库的连接字符串。

注意

如果您将 RDS 数据库实例挂载到您的环境,请通过 Elastic Beanstalk 提供的 Amazon Relational Database Service (Amazon RDS) 环境属性动态构造 JDBC 连接字符串。JDBC_CONNECTION_STRING 只适用于不是使用 Elastic Beanstalk 配置的数据库实例。

有关配合使用 Amazon RDS 和 Java 应用程序的更多信息,请参阅向 Java 应用程序环境中添加 Amazon RDS 数据库实例

在运行于 Elastic Beanstalk 中的 Tomcat 环境内,可使用 System.getProperty() 访问环境变量。例如,可以使用以下代码将名为 API_ENDPOINT 的属性读取到某个变量。

String endpoint = System.getProperty("API_ENDPOINT");

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

Tomcat 配置命名空间

您可以使用配置文件设置配置选项并在部署期间执行其他实例配置。配置选项可以通过您使用的 Elastic Beanstalk 服务或平台定义并组织到命名空间中。

除了所有 Elastic Beanstalk 环境支持的选项之外,Tomcat 平台还支持以下命名空间中的选项:

  • aws:elasticbeanstalk:container:tomcat:jvmoptions – 修改 JVM 设置。此命名空间中的选项对应于管理控制台中的选项,如下所示:

    • XmsJVM 命令行选项

    • XmxJVM 命令行选项

    • XX:MaxPermSizeJVM 持久代最大大小

    • JVM OptionsJVM 命令行选项

  • aws:elasticbeanstalk:environment:proxy – 选择代理服务器和配置响应压缩。

  • aws:elasticbeanstalk:environment:proxy:staticfiles – 配置代理,以从源包中的路径为静态资产提供服务。

以下示例配置文件演示了特定于 Tomcat 的配置选项的使用。

例 .ebextensions/tomcat-settings.config

option_settings: aws:elasticbeanstalk:container:tomcat:jvmoptions: Xms: 512m Xmx: 512m JVM Options: '-Xmn128m' aws:elasticbeanstalk:application:environment: API_ENDPOINT: mywebapi.zkpexsjtmd.us-west-2.elasticbeanstalk.com aws:elasticbeanstalk:environment:proxy: GzipCompression: 'true' ProxyServer: nginx aws:elasticbeanstalk:environment:proxy:staticfiles: /pub: public

包含 Elastic Beanstalk 配置文件

要部署 .ebextensions 配置文件,请将其包含在您的应用程序源中。对于单个应用程序,将通过运行以下命令将 .ebextensions 添加到压缩的 WAR 文件:

zip -ur your_application.war .ebextensions

对于需要多个 WAR 文件的应用程序,如需更多说明,请参阅捆绑用于 Tomcat 环境的多个 WAR 文件

Elastic Beanstalk 提供许多配置选项来自定义您的环境。除了配置文件之外,您还可使用控制台、保存的配置、EB CLI 或 AWS CLI 来配置选项。参阅 配置选项 了解更多信息。