当您使用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. 配置完成后，单击确认。
      您可以在变更详情页面查看应用部署的执行状态。