当您使用WAR包部署应用时，您可以根据需要自定义Tomcat参数，包括应用端口、应用访问路径以及最大线程数等信息。本文介绍如何在 SAE 控制台设置并修改Java Tomcat参数。

前提条件

以 WAR包部署 方式部署Java应用。

操作步骤

在创建应用过程中配置Tomcat

  1. 登录 SAE控制台 。
  2. 在左侧导航栏，选择 应用管理 > 应用列表 ，在顶部菜单栏选择地域，然后单击 创建应用 。
  3. 在 应用基本信息 配置向导，设置应用相关信息，并单击 下一步：应用部署配置 。
  4. 在 应用部署配置 配置向导，选择 技术栈语言 和 应用部署方式 ，设置部署信息。
  5. 展开 Java Tomcat设置 区域，选中 自定义配置 ，单击 编辑 。
    选中Java Tomcat
  6. 在 编辑Java Tomat设置 面板，配置相关信息，单击 确定 。
    编辑Java Tomcat
    配置项 说明
    应用端口 默认为8080，取值范围[1024,49151]。
    Tomcat Context 选择应用访问的路径。
    • 程序包名字 ：无需填写自定义路径，应用的访问路径是WAR包名称。 文件上传方式 为 上传WAR包 时可以选择。
    • 根目录 ：应用的访问路径是 / 。
    • 自定义 ：在 自定义路径 区域设置应用需要访问的路径。
    最大线程数 设置并发处理请求的最大线程数。默认为400，取值范围为[10, 1024]。
    重要 最大线程数 会直接影响应用性能，请谨慎设置。
    Tomcat编码 Tomcat的编码格式，包括 UTF-8 、 ISO-8859-1 、 GBK 和 GB2312 ，默认为 ISO-8859-1 。
    Use Body Encoding for URL 默认选中，选中后可以根据HTTP Body设置的字符集解码查询参数（QueryString）。
  7. 单击 下一步：确认规格 。
  8. 在 确认规格 配置向导，查看您所创建应用的详细信息以及配置费用情况，并单击 确认创建 。
    页面会跳转至 创建完成 配置向导，您可以单击 应用详情页 进入 基本信息 页面。
  9. 通过以下方式验证配置是否生效。
    • 方式一：

      在应用 基本信息 页面的左侧导航栏，单击 变更记录 ，在 变更记录 页面，查看应用变更详情。如果显示 执行成功 ，表示应用部署成功，配置已生效。

    • 方式二：

      在应用 基本信息 页面，单击 实例部署信息 页签，查看实例的 运行状态 。如果 运行状态 显示为 Running ，表示应用部署成功，配置已生效。

在部署应用过程中配置Tomcat

警告 重新部署应用后，该应用将会被重启。为避免业务中断等不可预知的错误，请在业务低峰期执行部署操作。

更新应用配置的路径因实例数的不同而不同。本文以实例数大于等于1为例，介绍如何配置目标功能。当实例数等于0时的操作路径，请参见 更新应用 。

  1. 登录 SAE控制台 。
  2. 在左侧导航栏，选择 应用管理 > 应用列表 ，在顶部菜单栏选择地域，然后单击具体应用名称。
  3. 在 基本信息 页面右上角，单击 部署应用 。
  4. 展开 Java Tomcat设置 区域，选中 自定义配置 ，单击 编辑 。
    选中Java Tomcat
  5. 在 编辑Java Tomat设置 面板，配置相关信息，单击 确定 。
    编辑Java Tomcat
    配置项 说明
    应用端口 默认为8080，取值范围[1024,49151]。
    Tomcat Context 选择应用访问的路径。
    • 程序包名字 ：无需填写自定义路径，应用的访问路径是WAR包名称。 文件上传方式 为 上传WAR包 时可以选择。
    • 根目录 ：应用的访问路径是 / 。
    • 自定义 ：在 自定义路径 区域设置应用需要访问的路径。
    最大线程数 设置并发处理请求的最大线程数。默认为400，取值范围为[10, 1024]。
    重要 最大线程数 会直接影响应用性能，请谨慎设置。
    Tomcat编码 Tomcat的编码格式，包括 UTF-8 、 ISO-8859-1 、 GBK 和 GB2312 ，默认为 ISO-8859-1 。
    Use Body Encoding for URL 默认选中，选中后可以根据HTTP Body设置的字符集解码查询参数（QueryString）。
  6. 配置完成后，单击 确认 。

利用配置项修改Tomcat配置文件

如果 SAE 控制台提供的以上Tomcat参数配置无法满足您的需求，或者您需要修改其他的Tomcat配置文件，您可以通过挂载配置项来实现。

通过WAR包成功部署 SAE 应用后，Tomcat的server.xml文件会位于 /home/admin/apache-tomcat-8.5.42/conf 目录下。本文以 server.xml 文件为例，介绍如何利用配置项修改Tomcat配置文件。

  1. 修改 server.xml 文件内容。
    1. 登录 SAE控制台 。
    2. 在左侧导航栏，选择 应用管理 > 应用列表 ，在顶部菜单栏选择地域，然后单击具体应用名称。
    3. 在 基本信息 页面，单击 实例部署信息 页签，在 默认分组 区域单击实例 操作 列的 Webshell 。
    4. 在Webshell窗口修改 server.xml 文件内容，并关闭窗口。
      1. 执行以下命令，进入 server.xml 文件所在的目录。 
        cd /home/admin/apache-tomcat-8.5.42/conf
      2. 执行以下命令，查看 server.xml 文件内容。 
        cat server.xml
      3. 复制 server.xml 的文件内容至本地，按需修改后再次复制。
  2. 创建配置项。
    说明 配置项与目标应用所在的命名空间需保持一致。
    1. 在应用 基本信息 页面，单击左上角的回退图标，返回 应用列表 页面。
    2. 在左侧导航栏，单击 命名空间（环境） ，在顶部菜单栏选择地域，然后单击具体命名空间名称。
    3. 在左侧导航栏，单击 配置项 ，然后在 配置项 页面，单击 创建 。
    4. 在 创建配置项 面板，输入相关参数，在 值 文本框内粘贴修改后的 server.xml 文件内容，并单击 确定 。
      sc_create_configmap_for_tomcat 本文以默认显示的 手工创建 方式为例。参数说明如下。更多信息，请参见 管理和使用配置项（K8s ConfigMap） 。
      配置项 说明
      配置项名称 自定义。
      配置项描述 自定义。
      配置映射
      • 键的长度不超过250个字符，值的长度不超过10,000个字符。
      • 一个配置项最多可以填写20个键值对。
    创建的配置项将显示在 配置项 页面。
  3. 部署应用并挂载配置项。
    1. 在左侧导航栏单击 基本信息 ，在 命名空间详情 页面单击 资源信息 页签。
    2. 单击具体的 应用数 数值，在 应用列表 页面单击目标应用。
    3. 在 基本信息 页面右上角，单击 部署应用 。
    4. 在 部署应用 页面下方，展开 配置管理 区域，选择 步骤 2 创建的 配置项名称 与 键 ，并输入 挂载路径 。 sc_mount_configuration_for_tomcat
    5. 配置完成后，单击 确认 。
      您可以在 变更详情 页面查看应用部署的执行状态。