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

在创建应用过程中配置Tomcat

  1. 登录SAE控制台
  2. 在左侧导航栏单击应用列表,在顶部菜单栏选择地域,单击创建应用
  3. 应用基本信息页签设置应用相关信息,并单击下一步:应用部署配置
  4. 应用部署配置页签,设置相关信息,展开Java Tomcat设置区域。
    说明 只有应用部署方式WAR包部署时才能设置Tomcat。
  5. Java Tomcat设置区域,选中自定义配置,单击编辑
    选中Java Tomcat
  6. 编辑Java Tomat设置面板中设置参数,单击确定
    编辑Java Tomcat

    参数说明如下。

    参数 说明
    应用端口 默认为8080,取值范围[1024,49151]。
    Tomcat Context 选择应用访问的路径。
    • 程序包名字:无需填写自定义路径,应用的访问路径是WAR包名称。文件上传方式上传WAR包时可以选择。
    • 根目录:应用的访问路径是/
    • 自定义:在自定义路径区域设置应用需要访问的路径。
    最大线程数 设置并发处理请求的最大线程数。默认为400,取值范围[10, 1024]。
    注意 最大线程数会直接影响应用性能,请谨慎设置。
    Tomcat编码 Tomcat的编码格式,包括UTF-8ISO-8859-1GBKGB2312,默认为ISO-8859-1
    Use Body Encoding for URL 默认选中,选中后可以根据HTTP Body设置的字符集解码查询参数(QueryString)。
  7. 单击下一步:确认规格
  8. 确认规格页签,查看您所创建应用的详细信息以及配置费用情况,并单击确认创建
  9. 您可以通过以下方式验证配置是否生效。
    • 方法一:

      在应用的变更记录页面中查看应用变更详情,如果显示执行成功,则表示部署成功,即配置已生效。

    • 方法二:

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

应用部署完成后配置Tomcat

如果您在创建应用时没有配置Tomcat,可以在应用部署成功后配置。

  1. 登录SAE控制台
  2. 在左侧导航栏单击应用列表,在顶部菜单栏选择地域,单击具体应用名称。
  3. 基本信息页面的右上角,单击部署应用
  4. 部署应用页面下方,展开Java Tomcat设置区域。
  5. Java Tomcat设置区域,选中自定义配置,单击编辑
    选中Java Tomcat
  6. 编辑Java Tomat设置面板中设置参数,单击确定
    编辑Java Tomcat

    参数说明如下。

    参数 说明
    应用端口 默认为8080,取值范围[1024,49151]。
    Tomcat Context 选择应用访问的路径。
    • 程序包名字:无需填写自定义路径,应用的访问路径是WAR包名称。文件上传方式上传WAR包时可以选择。
    • 根目录:应用的访问路径是/
    • 自定义:在自定义路径区域设置应用需要访问的路径。
    最大线程数 设置并发处理请求的最大线程数。默认为400,取值范围[10, 1024]。
    注意 最大线程数会直接影响应用性能,请谨慎设置。
    Tomcat编码 Tomcat的编码格式,包括UTF-8ISO-8859-1GBKGB2312,默认为ISO-8859-1
    Use Body Encoding for URL 默认选中,选中后可以根据HTTP Body设置的字符集解码查询参数(QueryString)。
  7. 单击确认,完成Tomcat配置。
    注意 单击确认后,该应用将会被重启,请在业务较少的时间段进行。

利用配置项修改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)
      参数 说明
      配置项名称 自定义。
      配置项描述 描述信息不超过255个字符。
      配置映射
      • 键的长度不超过250个字符,值的长度不超过10,000个字符。
      • 一个键可对应多个值,最多可添加20个键值对。
      • 如需添加更多键值对,请单击添加
    创建的配置项将显示在配置项页面。
  3. 部署应用并挂载配置项。
    1. 在左侧导航栏单击基本信息,在命名空间详情页面单击资源信息页签。
    2. 单击应用数,在应用列表页面单击目标应用。
    3. 基本信息页面的右上角,单击部署应用
    4. 部署应用页面下方,展开配置管理区域,选择步骤2创建的配置项名称,并输入挂载路径sc_mount_configuration_for_tomcat
    5. 单击确认
      您可以在变更详情页面查看应用部署的执行状态。