Tomcat多实例单应用部署方案 (转)

2021-11-14 16:08:30

一、Tomcat部署的场景分析

通常，我们对tomcat部署需求可以分为几种：单实例单应用，单实例多应用，多实例单应用，多实例多应用。

  • 对于第一种场景，如果不要求周期性地维护tomcat版本，一般的做法是把打好的war包丢到webapps目录下，然后执行startup.sh脚本，并且可以在浏览器里访问就行了。
  • 对于第二种场景，是把多个应用程序的war包放在同一个tomcat的webapps目录，这样一来，关闭和启动tomcat会影响所有项目。
  • 对于第三种场景，各个tomcat都运行同一个应用程序，对应地需要修改不同的监听端口，这种方式通常会和apache httpd或者nginx整合使用，做一些负载均衡的处理。
  • 对于第四种场景相当于第一种场景的复数形式，除了修改不同的监听端口，没有本质区别。

一般来说，多实例部署tomcat，可以充分利用系统资源，不过这种方式，也有几个方面需要考虑：

  • 多实例tomcat的更新维护，例如对tomcat进行升级等操作，我们需要考虑如何能“优雅”地对所有实例进行升级
  • 尽量不要影响应用程序，在更新tomcat时，一不小心就把conf目录等全部覆盖，所以尽量要把配置文件和安装目录隔离
  • 对于单应用来说，如果将war包分别置于各个tomcat的webapps目录，那么在发布新版本的war时，可能会出现某个实例更新失败，导致用户在访问时可能会访问到不同版本的web app，因此，比较好的方式就是所有tomcat实例都统一指向同一个应用程序

本文重点阐述多实例应用的部署方案，但是为了解决上述几个问题，我们需要先来了解一下tomcat的一些基本情况。

二、基本要点

2.1 分离目录

首先来看一下tomcat的目录结构，一个刚解压出来的tomcat打包文件应该有以下几个目录

目录 作用
bin 主要存放脚本文件，例如比较常用的windows和linux系统中启动和关闭脚本
conf 主要存放配置文件，其中最重要的两个配置文件是server.xml和web.xml
lib 主要存放tomcat运行所依赖的包
logs 主要存放运行时产生的日志文件，例如catalina.{date}.log等
temp 存放tomcat运行时产生的临时文件，例如开启了hibernate缓存的应用程序，会在该目录下生成一些文件
webapps 部署web应用程序的默认目录
work 主要存放由JSP文件生成的servlet（java文件以及最终编译生成的class文件）

再介绍两个tomcat中比较重要的概念（通常也是两个系统变量）——CATALINA_HOME和CATALINA_BASE：

  • CATALINA_HOME：即指向Tomcat安装路径的系统变量
  • CATALINA_BASE：即指向活跃配置路径的系统变量

    通过设置这两个变量，就可以将tomcat的安装目录和工作目录分离，从而实现tomcat多实例的部署。

Tomcat官方文档指出，CATALINA_HOME路径的路径下只需要包含bin和lib目录，这也就是支持tomcat软件运行的目录，而CATALINA_BASE设置的路径可以包括上述所有目录，不过其中bin和lib目录并不是必需的，缺省时会使用CATALINA_HOME中的bin和conf。如此，我们就可以使用一个tomcat安装目录部署多个tomcat实例，这样的好处在于方便升级，就可以在不影响tomcat实例的前提下，替换掉CATALINA_HOME指定的tomcat安装目录。

 
Tomcat多实例单应用部署方案 (转)
tomcat目录结构

2.2 修改server.xml

这里不详细分析server.xml中每一个配置项，网上也有很多这方面的文档。下面主要说明监听端口和Host的配置内容。

在server.xml中配置了四个监听端口，分别是：

  • Server Port：该端口用于监听关闭tomcat的shutdown命令，默认为8005

    Connector Port：该端口用于监听HTTP的请求，默认为8080
  • AJP Port：该端口用于监听AJP（ Apache JServ Protocol ）协议上的请求，通常用于整合Apache Server等其他HTTP服务器，默认为8009
  • Redirect Port：重定向端口，出现在Connector配置中，如果该Connector仅支持非SSL的普通http请求，那么该端口会把https的请求转发到这个Redirect Port指定的端口，默认为8443

可见，如果不是使用AJP协议连接tomcat，只需要保证多实例中的Server Port和Connect Port不同即可。

再来说Host配置，Host就是所谓的虚拟主机，对应包含了一个或者多个web应用程序，默认的Host配置如下

<Host name="localhost"  appBase="webapps" unpackWARs="true" autoDeploy="true">

其中：

  • name： 虚拟主机的名称，一台主机表示了完全限定的域名或IP地址，默认为localhost，同时也是唯一的host，进入tomcat的所有http请求都会映射到该主机上
  • appBase：web应用程序目录的路径，可以是CATALINA_HOME的相对路径，也可以写成绝对路径，默认情况下为$CATALINA_HOME/webapps

    unpackWARs： 表示是否自动解压war包
  • autoDeploy：所谓的热部署，即在tomcat正在运行的情况下，如果有新的war加入，则会立即执行部署操作
  • 另外再介绍一个Host中的属性—deployOnStartup：表示tomcat启动时是否自动部署appBase目录下所有的Web应用程序，默认为true。这个属性和autoDeploy会产生两次部署的“副作用”：一次是tomcat启动时就开始部署，第二次就是autoDeploy引起的热部署。因此最好将autoDeploy置为false

在部署多实例单应用的时候，默认的$CATALINA/webapps会因为tomcat安装目录升级产生不必要的麻烦，我们考虑将appBase的目录统一到另外的路径下。

最后再说明一下Context的配置，它出现在Host配置内，一个Context的配置就代表了一个web应用程序，如果配置多应用程序，就需要在Host下配置多个Context，一个简单的Context配置如下

<Context path="/some" docBase="someapp.war" >

其中:

  • path：表示访问入口，例如，path=”/abc”，则访问localhost:8080/abc时，就可以访问该Context对应的应用程序。如果path=””，则直接用localhost:8080就可以访问
  • docBase：表示应用程序的解包目录或者war文件路径，是Host的appBase配置目录的相对路径，也可以是直接写成绝对路径，但是不要将appBase的值，作为docBase配置路径的前缀，例如appBase=”somedir”，docBase=”somedir-someapp.war”，这样的配置会导致部署错误

通过配置Host的appBase和Context的docBase两个属性，可以将应用程序的文件和tomcat相关的目录进行分离，这样webapps目录也就没有作用了。

最终我们可以得到多实例单应用部署方案的整体框架：

 
Tomcat多实例单应用部署方案 (转)
部署框架

三、方案实施

现在假设我们有一台已经配置好Java环境的服务器：

# export JAVA_HOME=/application/jdk

# export PATH=$JAVA_HOME/bin:$JAVA_HOME/jre/bin:$PATH

# export CLASSPATH=.$CLASSPATH:$JAVA_HOME/lib:$JAVA_HOME/jre/lib:$JAVA_HOME/lib/tools.jar

# java -version

java version "1.8.0_101"

Java(TM) SE Runtime Environment (build 1.8.0_101-b13)

Java HotSpot(TM) 64-Bit Server VM (build 25.101-b13, mixed mode)

　　

另外假设一个完好的可以运行的web应用程序已经打包成some.war，放在/data/www目录下，其中包含一个简单的index.jsp

 
 
<html>

<body>

<h2>Hello World!</h2>

</body>

</html>

　　

3.1 下载并解压tomcat

# cd /usr/local

# wget -q http://mirrors.cnnic.cn/apache/tomcat/tomcat-7/v7.0.72/bin/apache-tomcat-7.0.72.tar.gz

# tar zxf apache-tomcat-7.0.72.tar.gz

# ls apache-tomcat-7.0.72

bin  conf  lib  LICENSE  logs  NOTICE  RELEASE-NOTES  RUNNING.txt  temp  webapps  work

3.2 配置tomcat多实例

可以用一小段脚本来完成批量创建的工作

for ((i=1;i<=3;i++))

do

    mkdir /application/tomcat7-$i/{work,temp,conf,logs} -p

    cp -a /application/tomcat7-$i/application/tomcat7-$i && \

    sed -i 22s@8005@80${i}5@ /application/tomcat7-$i/conf/server.xml // 修改tomcat关闭端口

    sed -i 71s@8080@808${i}@ /application/tomcat7-$i/conf/server.xml // 修改Http监听端口

    sed -i 93s@8009@80${i}9@ /application/tomcat7-$i/conf/server.xml // 修改AJP端口

    sed -i '125s@appBase="webapps"@appBase="/data/www"@' /application/tomcat7-$i/conf/server.xml //统一web应用程序的路径

    sed -i '126s@autoDeploy="true"@autoDeploy="false"@' /application/tomcat7-$i/conf/server.xml //关闭自动部署

    sed -i '126a <Context path="" docBase="/data/www/some.war" />' /application/tomcat7-$i/conf/server.xml //配置Context信息，指向some.war的路径

done

3.3 创建启停脚本

#!/bin/sh

CUR_DIR=`dirname $BASH_SOURCE`

export JAVA_HOME="/application/jdk"

export CATALINA_BASE=`readlink -f $CUR_DIR`

export CATALINA_HOME="/usr/local/apache-tomcat-7.0.72"

case $1 in

 start)

 [ -f $CATALINA_HOME/bin/startup.sh ] && $CATALINA_HOME/bin/startup.sh

 ;;

 stop)

 [ -f $CATALINA_HOME/bin/shutdown.sh ] && $CATALINA_HOME/bin/shutdown.sh

 ;;

 restart)

 [ -f $CATALINA_HOME/bin/shutdown.sh ] && $CATALINA_HOME/bin/shutdown.sh && \

 [ -f $CATALINA_HOME/bin/startup.sh ] && $CATALINA_HOME/bin/startup.sh

 ;;

 *)

 echo "usage : $0 { start | stop | restart }"

 return 1;

 ;;

esac

return 0

把该脚本放在tomcat7-1，tomcat7-2和tomcat7-3目录下

现在我们的目录结构如下

# ls tomcat7-1 tomcat7-2 tomcat7-3

tomcat7-1:

conf  logs  temp  tomcat.sh  work

tomcat7-2:

conf  logs  temp  tomcat.sh  work

tomcat7-3:

conf  logs  temp  tomcat.sh  work

3.4 启动tomcats

# cd /application

# . tomcat7-1/tomcat.sh start

# . tomcat7-2/tomcat.sh start

# . tomcat7-3/tomcat.sh start

# netstat -tunlp

Active Internet connections (only servers)

Proto Recv-Q Send-Q Local Address               Foreign Address             State       PID/Program name

tcp        0      0 0.0.0.0:22                  0.0.0.0:*                   LISTEN      25757/sshd

tcp        0      0 :::8029                     :::*                        LISTEN      21225/java

tcp        0      0 ::ffff:127.0.0.1:8035       :::*                        LISTEN      21186/java

tcp        0      0 :::8039                     :::*                        LISTEN      21186/java

tcp        0      0 ::ffff:127.0.0.1:8015       :::*                        LISTEN      21002/java

tcp        0      0 :::8081                     :::*                        LISTEN      21002/java

tcp        0      0 :::8082                     :::*                        LISTEN      21225/java

tcp        0      0 :::8083                     :::*                        LISTEN      21186/java

tcp        0      0 :::8019                     :::*                        LISTEN      21002/java

tcp        0      0 :::22                       :::*                        LISTEN      25757/sshd

tcp        0      0 ::ffff:127.0.0.1:8025       :::*                        LISTEN      21225/java
可以看到8081，8082，8083等其他端口都已经启动，现在可以使用curl命令进行访问
# curl localhost:8081

<html>

<body>

<h2>Hello World!</h2>

</body>

</html>

# curl localhost:8082

<html>

<body>

<h2>Hello World!</h2>

</body>

</html>

# curl localhost:8083

<html>

<body>

<h2>Hello World!</h2>

</body>

</html>

完成！

四、参考文献

转自：https://www.jianshu.com/p/0b549d00ecc2

上一篇：jQuery学习第六课(jquery中的动画)


下一篇：mongodb在双活（主备）机房的部署方案和切换方案设计