当您使用WAR包部署应用时,您可以根据需要自定义Tomcat参数,包括应用端口、应用访问路径以及最大线程数等信息。本文介绍如何在Serverless应用引擎SAE(Serverless App Engine)控制台设置并修改Java Tomcat参数。
在创建应用过程中配置Tomcat
- 登录SAE控制台。
- 在左侧导航栏单击应用列表,在顶部菜单栏选择地域,单击创建应用。
- 在应用基本信息页签设置应用相关信息,并单击下一步:应用部署配置。
- 在应用部署配置页签,设置相关信息,展开Java Tomcat设置区域。说明 只有应用部署方式为WAR包部署时才能设置Tomcat。
- 在Java Tomcat设置区域,选中自定义配置,单击编辑。
- 在编辑Java Tomat设置面板中设置参数,单击确定。
参数说明如下。
参数 说明 应用端口 默认为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)。 - 单击下一步:确认规格。
- 在确认规格页签,查看您所创建应用的详细信息以及配置费用情况,并单击确认创建。
- 您可以通过以下方式验证配置是否生效。
- 方法一:
在应用的变更记录页面中查看应用变更详情,如果显示执行成功,则表示部署成功,即配置已生效。
- 方法二:
在应用基本信息页面的实例部署信息页签查看实例的运行状态。如果运行状态显示为绿色的Running,表示应用部署成功,即配置已生效。
- 方法一:
应用部署完成后配置Tomcat
如果您在创建应用时没有配置Tomcat,可以在应用部署成功后配置。
- 登录SAE控制台。
- 在左侧导航栏单击应用列表,在顶部菜单栏选择地域,单击具体应用名称。
- 在基本信息页面的右上角,单击部署应用。
- 在部署应用页面下方,展开Java Tomcat设置区域。
- 在Java Tomcat设置区域,选中自定义配置,单击编辑。
- 在编辑Java Tomat设置面板中设置参数,单击确定。
参数说明如下。
参数 说明 应用端口 默认为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)。 - 单击确认,完成Tomcat配置。注意 单击确认后,该应用将会被重启,请在业务较少的时间段进行。
利用配置项修改Tomcat配置文件
如果SAE控制台提供的以上Tomcat参数配置无法满足您的需求,或者您需要修改其他的Tomcat配置文件,您可以通过挂载配置项来实现。
通过WAR包成功部署SAE应用后,Tomcat的server.xml文件会位于/home/admin/apache-tomcat-8.5.42/conf目录下。本文以server.xml文件为例,介绍如何利用配置项修改Tomcat配置文件。
- 修改server.xml文件内容。
- 登录SAE控制台。
- 在左侧导航栏单击应用列表,在顶部菜单栏选择地域,单击具体应用名称。
- 在基本信息页面单击实例部署信息页签,在默认分组区域单击实例操作列的Webshell。
- 在Webshell窗口修改server.xml文件内容,并关闭窗口。
- 执行以下命令,进入server.xml文件所在的目录。
cd /home/admin/apache-tomcat-8.5.42/conf
- 执行以下命令,查看server.xml文件内容。
cat server.xml
- 复制server.xml的文件内容至本地,按需修改后再次复制。
- 执行以下命令,进入server.xml文件所在的目录。
- 创建配置项。说明 配置项与目标应用所在的命名空间需保持一致。
- 在应用基本信息页面单击左上角的回退图标,返回应用列表页面。
- 在左侧导航栏单击命名空间,在顶部菜单栏选择地域,单击具体命名空间名称。
- 在左侧导航栏单击配置项,在配置项页面单击创建。
- 在创建配置项面板,输入相关参数,在值文本框内粘贴修改后的server.xml文件内容,并单击确定。
本文以默认显示的手工创建方式为例。参数说明如下。更多信息,请参见管理和使用配置项(K8s)。
参数 说明 配置项名称 自定义。 配置项描述 描述信息不超过255个字符。 配置映射 - 键的长度不超过250个字符,值的长度不超过10,000个字符。
- 一个键可对应多个值,最多可添加20个键值对。
- 如需添加更多键值对,请单击添加。
创建的配置项将显示在配置项页面。 - 部署应用并挂载配置项。
- 在左侧导航栏单击基本信息,在命名空间详情页面单击资源信息页签。
- 单击应用数,在应用列表页面单击目标应用。
- 在基本信息页面的右上角,单击部署应用。
- 在部署应用页面下方,展开配置管理区域,选择步骤2创建的配置项名称与键,并输入挂载路径。
- 单击确认。您可以在变更详情页面查看应用部署的执行状态。