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>