前言
整理这个官方翻译的系列,原因是网上大部分的 tomcat 版本比较旧,此版本为 v11 最新的版本。
开源项目
从零手写实现 tomcat minicat 别称【嗅虎】心有猛虎,轻嗅蔷薇。
系列文章
web server apache tomcat11-01-官方文档入门介绍
web server apache tomcat11-02-setup 启动
web server apache tomcat11-03-deploy 如何部署
web server apache tomcat11-04-manager 如何管理?
web server apache tomcat11-06-Host Manager App – Text Interface
web server apache tomcat11-07-Realm Configuration
web server apache tomcat11-08-JNDI Resources
web server apache tomcat11-09-JNDI Datasource
web server apache tomcat11-10-Class Loader
web server apache tomcat11-11-Jasper 2 JSP Engine
web server apache tomcat11-12-SSL/TLS Configuration
web server apache tomcat11-13-SSI
web server apache tomcat11-14-CGI
web server apache tomcat11-15-proxy
web server apache tomcat11-16-mbean
web server apache tomcat11-17-default-servlet
web server apache tomcat11-18-clusting 集群
web server apache tomcat11-19-load balance 负载均衡
web server apache tomcat11-20-connectors 连接器
web server apache tomcat11-21-monitor and management 监控与管理
web server apache tomcat11-22-logging 日志
web server apache tomcat11-23-APR
web server apache tomcat11-24-Virtual Hosting and Tomcat
web server apache tomcat11-25-Advanced IO and Tomcat
web server apache tomcat11-26-maven jars
web server apache tomcat11-27-Security Considerations
web server apache tomcat11-28-Windows Service
web server apache tomcat11-29-Windows Authentication
web server apache tomcat11-30-The Tomcat JDBC Connection Pool
web server apache tomcat11-31-websocket
web server apache tomcat11-32-rewrite
web server apache tomcat11-33-CDI
web server apache tomcat11-34-Ahead of Time compilation support
假设
为了本教程的目的,请假设您拥有一个开发主机,其中有两个主机名,ren 和 stimpy。
还假设有一个运行的Tomcat实例,所以 $CATALINA_HOME 指的是它的安装位置,也许是 /usr/local/tomcat。
此外,本教程使用Unix风格的路径分隔符和命令;如果您使用Windows,请相应修改。
server.xml
最简单的情况下,编辑您的 server.xml 文件的 Engine 部分如下所示:
<Engine name="Catalina" defaultHost="ren">
<Host name="ren" appBase="renapps"/>
<Host name="stimpy" appBase="stimpyapps"/>
</Engine>
请注意,每个主机的 appBase 下的目录结构不应该相互重叠。
查阅引擎和主机元素的其他属性的配置文档。
Webapps 目录
为每个虚拟主机创建目录:
mkdir $CATALINA_HOME/renapps
mkdir $CATALINA_HOME/stimpyapps
配置您的上下文
一般
上下文通常位于 appBase 目录下。例如,要在 ren 主机中以 war 文件的形式部署 foobar 上下文,使用 $CATALINA_HOME/renapps/foobar.war。
请注意,ren 的默认或 ROOT 上下文将部署为 $CATALINA_HOME/renapps/ROOT.war(WAR文件)或 $CATALINA_HOME/renapps/ROOT(目录)。
注意: 上下文的 docBase 绝对不能与主机的 appBase 相同。
context.xml - 方法 #1
在您的上下文中,创建一个 META-INF 目录,然后将上下文定义放在其中,文件命名为 context.xml,即 $CATALINA_HOME/renapps/ROOT/META-INF/context.xml。这样做使部署更加简单,特别是如果您正在分发一个 WAR 文件。
context.xml - 方法 #2
在 $CATALINA_HOME/conf/Catalina 下创建一个与您的虚拟主机对应的结构,例如:
mkdir $CATALINA_HOME/conf/Catalina/ren
mkdir $CATALINA_HOME/conf/Catalina/stimpy
请注意,结束目录名 “Catalina” 表示与上面显示的 Engine 元素的 name 属性相对应。
现在,对于您的默认 webapps,添加:
$CATALINA_HOME/conf/Catalina/ren/ROOT.xml
$CATALINA_HOME/conf/Catalina/stimpy/ROOT.xml
如果您想要为每个主机使用Tomcat管理器web应用程序,您还需要在此处添加:
cd $CATALINA_HOME/conf/Catalina
cp localhost/manager.xml ren/
cp localhost/manager.xml stimpy/
每个主机的默认值
您可以通过在主机特定的 xml 目录中指定新值,在 conf/context.xml 和 conf/web.xml 中找到的默认值。
根据我们之前的例子,您可以使用 $CATALINA_HOME/conf/Catalina/ren/web.xml.default 来自定义命名为 ren 的虚拟主机中部署的所有 webapps 的默认值。
更多信息
请查阅上下文元素的其他属性的配置文档。
参考资料
https://tomcat.apache.org/tomcat-11.0-doc/apr.html