maven tomcat plugin实现热部署

总共分为五步:

1.在tomcat中配置用户权限,即添加管理员帐号

2.在maven中添加server,配置tomcat的管理员帐号密码

3.在project中添加插件,以及maven中配置的server,

4.设置部署命令

5.进行部署

附相关错误及解决办法

下面进行分步骤讲解:

一.在tomcat中配置用户权限,即添加管理员帐号.

我们需要实现热部署,自然就需要通过maven操作tomcat,所以就需要maven取得操作tomcat的权限,现在这一步就是配置tomcat的可操作权限.

在tomcat的安装目录下,修改conf / tomcat-user.xml文件,在<tomcat-users> 节点下面增加如下配置:

[html]  view plain copy

1. <role rolename="manager-gui" />  
2. <role rolename="manager-script" />  
3. <user username="tomcat" password="tomcat" roles="manager-gui, manager-script" />  

二.在maven中添加server,配置tomcat的管理员帐号密码

现在tomcat开启了权限,maven既然要操作tomcat,那么maven就要拿到tomcat的管理员帐号和密码才能够使用.

在maven的安装目录下,修改conf / setting.xml文件.在<server> 节点下面增加如下配置:

[html]  view plain copy

1. <server>    
2.        <id>admin</id>    
3.        <username>tomcat</username>    
4.        <password>tomcat</password>    
5. </server>    

三.在project中添加插件,以及maven中配置的server,

现在maven已经拥有操作tomcat的权限了,但是这两者之间想要通信的话还需要一个桥梁,那就是在maven中配置tomcat插件.

修改项目的pom.xml文件,在<build> 节点下面增加如下配置:

[html]  view plain copy

1. <plugins>  
2.             <!-- 第一种方式: apache官方tomcat插件,支持deploy -->  
3.             <plugin>  
4.                 <groupId>org.apache.tomcat.maven</groupId>  
5.                 <artifactId>tomcat7-maven-plugin</artifactId>  
6.                 <version>2.0-SNAPSHOT</version>  
7.                 <configuration>  
8.                     <url>http://localhost:8080/manager/text</url>  
9.                     <server>admin</server>  
10.                 </configuration>  
11.             </plugin>  
12.             <!-- 第二种方式: 第三方tomcat插件,支持redeploy -->  
13.             <plugin>  
14.                 <groupId>org.codehaus.mojo</groupId>  
15.                 <artifactId>tomcat-maven-plugin</artifactId>  
16.                 <version>1.1</version>  
17.                 <configuration>  
18.                     <url>http://localhost:8080/manager/text</url>  
19.                     <server>admin</server>  
20.                     <ignorePackaging>true</ignorePackaging>  
21.                 </configuration>  
22.             </plugin>  
23. </plugins>  

对于以上插件,网上有两种,经过测试都是可以用的,但是注意,以上的配置只能用于tomcat7,如果要用tomcat6的话,需要配置成如下方式:

[html]  view plain copy

1. <plugins>  
2.             <!-- apache官方tomcat插件,支持deploy -->  
3.             <plugin>  
4.                 <groupId>org.apache.tomcat.maven</groupId>  
5.                 <artifactId>tomcat6-maven-plugin</artifactId>  
6.                 <version>2.0-SNAPSHOT</version>  
7.                 <configuration>  
8.                     <url>http://localhost:8080/manager/html</url>  
9.                     <server>admin</server>  
10.                 </configuration>  
11.             </plugin>  
12.             <!-- 第三方tomcat插件,支持redeploy -->  
13.             <plugin>  
14.                 <groupId>org.codehaus.mojo</groupId>  
15.                 <artifactId>tomcat-maven-plugin</artifactId>  
16.                 <version>1.1</version>  
17.                 <configuration>  
18.                     <url>http://localhost:8080/manager</url>  
19.                     <server>admin</server>  
20.                     <ignorePackaging>true</ignorePackaging>  
21.                 </configuration>  
22.             </plugin>  
23. </plugins>  

不论是tomcat7还是tomcat6,只要用到其中一种插件就行了.但是这两种插件还是有区别的:

第一种是apache官方的插件,支持deploy命令,如果已经部署到tomcat容器,第二次部署的时候就会报错,提示该项目已经部署.

第二种是第三方的插件,可以使用redeploy命令,可以重复部署
同时,请在<project>节点下增加仓库配置,不然可能插件找不到,导致报错:

[html]  view plain copy

1. <repositories>  
2.         <repository>  
3.             <id>people.apache.snapshots</id>  
4.             <url>  
5.                 http://repository.apache.org/content/groups/snapshots-group/  
6.             </url>  
7.             <releases>  
8.                 <enabled>false</enabled>  
9.             </releases>  
10.             <snapshots>  
11.                 <enabled>true</enabled>  
12.             </snapshots>  
13.         </repository>  
14.     </repositories>  
15.   
16.     <pluginRepositories>  
17.         <pluginRepository>  
18.             <id>apache.snapshots</id>  
19.             <name>Apache Snapshots</name>  
20.             <url>http://repository.apache.org/content/groups/snapshots-group/</url>  
21.             <releases>  
22.                 <enabled>false</enabled>  
23.             </releases>  
24.             <snapshots>  
25.                 <enabled>true</enabled>  
26.             </snapshots>  
27.         </pluginRepository>  
28.     </pluginRepositories>  

四.设置部署命令

一般使用搜是在eclipse中,可以右键点击需要部署的项目,Run as -> Run configurations -> maven build -> 右键 new,这样配置一个新的maven命令

具体配置命令方法:

1.在base directory中选择自己的项目

2.Goals的配置

如果使用apache的官方插件,那么就用 "tomcat7:deploy" 命令

如果使用第三方插件,那么就用 "tomcat:redeploy"命令

五.进行部署

右键自己的项目,Run as -> Maven build即可.

注:

有些同学不习惯使用IDE,那么在命令行中使用maven实现部署也是一样的.

通过命令行进入到自己的项目文件夹下,使用mvn命令,例如: mvn tomcat7:deploy

附相关错误及解决办法:

1.Connection refused错误
报错信息如下：
[ERROR]Failed to execute goal org.apache.tomcat.maven: tomcat7-maven-plugin: 2.0- SNAPSHOT: deploy (default-cli) on project helloworld: Cannot invoke Tomcat manager: Connection refused: connect -> [Help 1]
原因：未启动Tomcat服务器
解决办法：先启动Tomcat服务器再选择Run


2. 401错误
报错信息如下:
[ERROR] Failed to execute goal org.apache.tomcat.maven:tomcat7-maven-plugin: 2.0-SNAPSHOT:deploy (default-cli) on project helloworld: Cannot invoke Tomcat manager: Server returned HTTP response code: 401 for URL: http://localhost:8080/manager/text/deploy?path=%2Fhelloworld -> [Help 1]
原因：权限问题
解决办法在$CATALINA_BASE/conf/tomcat-users.xml，
如D:\apache-tomcat-7.0.34\conf\tomcat-users.xml文件中添加权限
<role rolename=”manager”/>
<user username=”admin” password=”admin” roles=”manager”/>
修改pom.xml文件，在<configuration>  </configuration>中添加
<username>admin</username>  <password>admin</password>


3.403错误
报错信息如下：
[ERROR] Failed to execute goal org.apache.tomcat.maven:tomcat7-maven-plugin: 2.0-SNAPSHOT:deploy (default-cli) on project helloworld: Cannot invoke Tomcat manager: Server returned HTTP response code: 403 for URL: http://localhost:8080/manager/html/deploy?path=%2Fhelloworld -> [Help 1]
原因：产生该问题有可能因为两个原因，具体参见解决办法
解决办法：
1）如果使用的是Tomcat 7，需要修改pom.xml中部署的url地址，将<url>http://localhost:8080/manager</url>改<url>http://localhost:8080/manager/text</url>
2）给tomcat用户权限分配上，需要同时具备manager-gui和manager-script权限，我在遇到该问题时，就是忘了分配manager-script权限。
正确的conf/tomcat-users.xml配置应为：
<tomcat-users>
<role rolename="manager-gui"/>
<role rolename="manager-script"/>
<user username="admin” password="admin" roles="manager-gui, manager-script"/>
</tomcat-users>