Maven tomcat7-maven-plugin 部署Maven Web 项目

MyEclipse使用总结——Maven项目如何启动运行发布到tomcat中[转]

前面两篇文章:

新建maven框架的web项目

以及

将原有项目改成maven框架

之后，我们已经有了maven的项目

 

那么

maven项目到底怎么启动呢

 

如果我们直接在myeclipse中按以前的启动方法是不行的。(详情下一篇文章会讲到:在myeclipse中启动maven项目)

 

但是maven项目可以生成本地war包手动移到tomcat，也可以自动发布到本地，远程tomcat中。

 

所以 我们就先尝试这两种方式:

生成war包,手动运行

对着项目右键，run as -----> Maven install 就会在本地生成war包





 

找到相关目录:



 

 

把这个包复制到我们本机安装的tomcat的webapp路径下:



 

启动tomcat即可:



 

 

启动完之后有一点要注意的:

访问页面是路径跟发布出来的项目一样才行，即使web目录设置的是ipFilterM

但这里要用:

ipFilterM-0.0.1-SNAPSHOT

否则404

 

可能遇到的问题:

maven生成的war包在tomcat下运行报错

 

 

 

自动发布到本地，远程tomcat

 

先修改下tomcat的配置文件

 

---安装目录下的tomcat-users.xml

tomcat7.0\conf\tomcat-users.xml



<tomcat-users>  
 <role rolename="manager-gui"/>  
 <role rolename="manager" />  
 <role rolename="manager-script"/>  
 <user username="tomcat" password="tomcat" roles="manager-gui,manager,manager-script"/>  
</tomcat-users>  

 

 

如果已经有了相关用户信息信息，就不用添加了，但是权限要加上

 <role rolename="manager-gui"/>

 <role rolename="manager" />

 <role rolename="manager-script"/>

manager-gui,manager,manager-script

 

tomcat配置成功后可以在localhost:8080\manager 

tomcat的管理界面登录如下：



 

 

 

 

 

 

修改下maven的配置文件

 

 

---安装目录下的settings.xml

maven\conf\settings.xml



找到servers修改如下,或者添加上: 

<servers>  
   <server>  
     <id>mytomcat7</id>  
     <username>tomcat</username>  
     <password>tomcat</password>  
   </server>  
 </servers>  

 

添加tomcat7-maven-plugin

外部配置好了，现在配置下web工程中的pom，添加tomcat7-maven-plugin

 

 

<build>  
       <finalName>peopleDataShow</finalName>  
       <plugins>  
           <plugin>  
               <groupId>org.apache.tomcat.maven</groupId>  
               <artifactId>tomcat7-maven-plugin</artifactId>  
               <version>2.2-SNAPSHOT</version>  
               <configuration>  
                   <path>/${project.build.finalName}</path>  
                   <server>mytomcat7</server>  
                   <!-- 这里是本地tomcat，如果是远程服务器可以改成对应的地址，实现自动部署-->  
                   <url>http://localhost:8080/manager/text</url>  
                </configuration>  
           </plugin>  
       </plugins>  
   </build>  

 

也就是在build标签里添加 tomcat的plugin

<finalName> 对应自己的项目名称

 

添加插件配置

-----不添加会报400 403错误

<repositories>  
<repository>  
<id>people.apache.snapshots</id>  
<url>http://repository.apache.org/content/groups/snapshots-group/</url>  
<releases>  
<enabled>false</enabled>  
</releases>  
<snapshots>  
<enabled>true</enabled>  
</snapshots>  
</repository>  
</repositories>  
<pluginRepositories>  
<pluginRepository>    
   <id>apache.snapshots</id>    
   <name>Apache Snapshots</name>    
   <url>    
       http://repository.apache.org/content/groups/snapshots-group/    
   </url>    
   <releases>    
       <enabled>false</enabled>    
   </releases>    
   <snapshots>    
       <enabled>true</enabled>    
   </snapshots>    
</pluginRepository>  
</pluginRepositories>  

 

 

 

 

启动tomcat7,执行maven build

 



 

 

配置goals

 

 

点击run后部署成功



 

 

这时在tomcat的管理界面 或者 文件夹中都已经能看到这个项目了



 



 

在myeclipse中直接运行

 

 



 



 

 

我们直接通过myeclipse启动，有时候会报错，但是这种情况是能解决的。

报错的原因

默认情况下，maven的resources tomcat是不认的，直接使用以前的方法部署上去之后，classpath中一个配置文件也没有。

我只想使用maven管理jar包，至于开发中部署到web服务器进行调试的工作，我还是想让myeclipse帮我完成，应该怎么配置，才能让部署过去之后，配置文件出现在WEB-INF/classes目录下？

 

我们要检查一下添加到tomcat之后生成的目录下有没有resources中的文件



 

检查发现，果然没有。

那我们就要给resources文件夹设置一下发布路径



 

 

对着项目右键
Properties--->MyEclipse--->Deployment Assembly 把resource的文件夹输出路径设置成跟 src/main/java一样即可
 



 

 

好了，这样我们就可以直接在myeclipse中直接启动项目和调试了。

 

启动不报错，而且页面访问也可以用了。

 



这时候项目的路径就是我们设置的web/root的路径，ipFilterM,区别 打war包放到tomcat中运行。

< tomcat-users >

3	< role   rolename = "manager-gui" />

4	< role   rolename = "manager"   />

5	< role   rolename = "manager-script" />

6	< user   username = "tomcat"   password = "tomcat"   roles = "manager-gui,manager,manager-script" />

7	</ tomcat-users >

<tomcat-users>  
 <role rolename="manager-gui"/>  
 <role rolename="manager" />  
 <role rolename="manager-script"/>  
 <user username="tomcat" password="tomcat" roles="manager-gui,manager,manager-script"/>  
</tomcat-users> 

maven tomcat plugin实现热部署

前言:

此处的方法适用于tomcat6 和 tomcat7,对于最新的tomcat8还没有进行过测试,有兴趣的同学可以自己测一下.

总共分为五步:

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> 节点下面增加如下配置:

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

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

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

<server>
<id>admin</id>
<username>tomcat</username>
<password>tomcat</password>
</server>

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

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

<plugins>
<!-- 第一种方式: apache官方tomcat插件,支持deploy -->
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.0-SNAPSHOT</version>
<configuration>
<url>http://localhost:8080/manager/text</url>
<server>admin</server>
</configuration>
</plugin>
<!-- 第二种方式: 第三方tomcat插件,支持redeploy -->
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>tomcat-maven-plugin</artifactId>
<version>1.1</version>
<configuration>
<url>http://localhost:8080/manager/text</url>
<server>admin</server>
<ignorePackaging>true</ignorePackaging>
</configuration>
</plugin>
</plugins>

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

<plugins>
<!-- apache官方tomcat插件,支持deploy -->
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat6-maven-plugin</artifactId>
<version>2.0-SNAPSHOT</version>
<configuration>
<url>http://localhost:8080/manager/html</url>
<server>admin</server>
</configuration>
</plugin>
<!-- 第三方tomcat插件,支持redeploy -->
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>tomcat-maven-plugin</artifactId>
<version>1.1</version>
<configuration>
<url>http://localhost:8080/manager</url>
<server>admin</server>
<ignorePackaging>true</ignorePackaging>
</configuration>
</plugin>
</plugins>

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

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

第二种是第三方的插件,可以使用redeploy命令,可以重复部署

同时,请在<project>节点下增加仓库配置,不然可能插件找不到,导致报错:

<repositories>
<repository>
<id>people.apache.snapshots</id>
<url> http://repository.apache.org/content/groups/snapshots-group/ </url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>

<pluginRepositories>
<pluginRepository>
<id>apache.snapshots</id>
<name>Apache Snapshots</name>
<url>http://repository.apache.org/content/groups/snapshots-group/</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</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>