使用 Elastic Beanstalk Tomcat 平台

本主题介绍如何配置、构建和运行在 Elastic Beanstalk Tomcat 平台上运行的 Java 应用程序。

AWS Elastic Beanstalk Tomcat 平台是一组平台版本，用于可以在 Tomcat Web 容器中运行的 Java Web 应用程序。Tomcat 在 nginx 代理服务器后面运行。每个平台分支对应 Tomcat 的一个主要版本。

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

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

Elastic Beanstalk Tomcat 平台包括一个可将请求转发到应用程序的反向代理。您可以使用配置选项将代理服务器配置为从您的源代码中的某个文件夹的静态资产提供服务，以减少应用程序的负载。有关高级方案，您可以在源包中包括您自己的 .conf 文件，以扩展 Elastic Beanstalk 代理配置或完全重写它。

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

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

在 Elastic Beanstalk 控制台中应用的设置会覆盖配置文件中的相同设置（如果存在）。这让您可以在配置文件中包含默认设置，并使用控制台中的特定环境设置加以覆盖。有关优先顺序和其他设置更改方法的更多信息，请参阅配置选项。

有关扩展 Elastic Beanstalk 基于 Linux 的平台的各种方法的详细信息，请参阅扩展 Elastic Beanstalk Linux 平台。

配置 Tomcat 环境

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

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

容器选项

您可以指定以下特定于平台的选项：

JVM 容器选项

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

持久代 是 JVM 堆的一部分，可存储类定义和关联的元数据。要修改持久代的大小，请在最大 JVM PermGen 大小 (-XX:MaxPermSize) 选项中键入新的大小。此设置仅适用于 Java 7 和更低版本。该选项已在 JDK 8 中弃用，并由 MaxMetaspace 大小 (-XX:MaxMetaspaceSize) 选项所取代。

有关 Elastic Beanstalk 平台及其组件的更多信息，请参阅《AWS Elastic Beanstalk 平台指南》中的支持的平台。

日志选项

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

静态文件

为了提高性能，您可以使用 Static files（静态文件）部分配置代理服务器，以便从 Web 应用程序内的一组目录提供静态文件（例如 HTML 或图像）。对于每个目录，您都将虚拟路径设置为目录映射。当代理服务器收到对指定路径下的某个文件的请求时，它将直接提供此文件，而不是将请求路由至您的应用程序。

有关使用配置文件或 Elastic Beanstalk 控制台配置静态文件的详细信息，请参阅 提供静态文件。

环境属性

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

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

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

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

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

Tomcat 配置命名空间

您可以使用配置文件设置配置选项并在部署期间执行其他实例配置。配置选项可以特定于平台，也可以应用于整个 Elastic Beanstalk 服务中的所有平台。配置选项被组织到命名空间中。

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

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

option_settings:
  aws:elasticbeanstalk:container:tomcat:jvmoptions:
    Xms: 512m
    JVM Options: '-Xmn128m'
  aws:elasticbeanstalk:application:environment:
    API_ENDPOINT: mywebapi.zkpexsjtmd.us-west-2.elasticbeanstalk.com
  aws:elasticbeanstalk:environment:proxy:
    ProxyServer: apache

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

option_settings:
  aws:elasticbeanstalk:environment:proxy:
    GzipCompression: 'true'
    ProxyServer: nginx

zip -ur your_application.war .ebextensions