maven自動部署到遠(yuǎn)程tomcat服務(wù)器的方法
使用maven的自動部署功能可以很方便的將maven工程自動部署到遠(yuǎn)程tomcat服務(wù)器，節(jié)省了大量時間。
本文章適用于tomcat的7.x ,8.x, 9.x版本。
下面是自動部的步驟
1，首先，配置tomcat的manager
編輯遠(yuǎn)程tomcat服務(wù)器下的conf/tomcat-users.xml,在末尾增加（其實只要拉到文件末尾，去掉注釋改一下就可以了）
<role rolename="manager-gui"/> <role rolename="manager-script"/> <user username="admin" password="password" roles="manager-script"/> <user username="root" password="password" roles="manager-gui"/>
將上面的password改為自己的密碼，注意對于tomcat9來說，不能同時賦予用戶manager-script和manager-gui角色。
保存tomcat-users.xml。
在tomcat服務(wù)器的conf/Catalina/localhost/目錄下創(chuàng)建一個manager.xml文件，寫入如下值:
<?xml version="1.0" encoding="UTF-8"?>
<Context privileged="true" antiResourceLocking="false"
docBase="${catalina.home}/webapps/manager">
<Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="^.*$" />
</Context>
保存退出。
然后在瀏覽器中輸入http://serverip:port/manager/html，此時會彈出要求輸入用戶名和密碼對話框，輸入manager-gui對應(yīng)的用戶和密碼登錄管理控制臺(其中serverip為服務(wù)器ip，如果服務(wù)器在本地就是localhost或者127.0.0.1，端口為tomcat端口，默認(rèn)8080)。以此確認(rèn)manager是否配置正確。正確結(jié)果示例如下：
2，在maven項目中添加配置
在pom.xml文件中，在plugins節(jié)點下添加如下plugin節(jié)點
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.2</version>
<configuration>
<url>http://serverip:port/manager/text</url>
<username>admin</username>
<password>password</password>
<update>true</update>
<path>/webapp</path>
</configuration>
</plugin>
將上面的serverip和port換成自己tomcat服務(wù)器的ip和端口。密碼換成上面配置的manager-script角色的密碼。path改為項目在tomcat服務(wù)器中的部署路徑。
然后進行部署，如果是第一次部署，運行mvn tomcat7:deploy進行自動部署(對于tomcat8,9，也是使用tomcat7命令)，如果是更新了代碼后重新部署更新，運行mvn tomcat7:redeploy，如果第一次部署使用mvn tomcat7:redeploy，則只會執(zhí)行上傳war文件，服務(wù)器不會自動解壓部署。如果路徑在tomcat服務(wù)器中已存在并且使用mvn tomcat7:deploy命令的話，上面的配置中一定要配置<update>true</update>，不然會報錯。
如果IDE是eclipse,就在runas->run configurations中配置一個maven build，intellij類似。
3. 內(nèi)存泄漏
使用上面的方法進行部署后會出現(xiàn)嚴(yán)重的內(nèi)存泄漏現(xiàn)象。tomcat的manager提供了診斷在部署時是否產(chǎn)生內(nèi)存泄漏的功能，在上面提到的http://serverip:port/manager/html這個頁面底部有一個“Find leaks”的按鈕，如下：
點擊按鈕，網(wǎng)頁頭部出現(xiàn)如下信息說明在部署的時候有內(nèi)存泄漏：
上面的消息顯示部署的test項目存在內(nèi)存泄漏，如果同一項目多次重新部署，則一個項目名可能會出現(xiàn)多次。
部署時產(chǎn)生內(nèi)存泄漏的原因是每次（重新）部署時，Tomcat會為項目新建一個類加載器，而舊的類加載器沒有被GC回收。maven的庫classloader-leak-prevention-servlet可以用來解決這個問題。具體方案為：
（1）添加maven依賴：
<dependency> <groupId>se.jiderhamn.classloader-leak-prevention</groupId> <artifactId>classloader-leak-prevention-servlet</artifactId> <version>2.1.0</version> </dependency>
（2）在項目的web.xml中添加一個Listener（必須讓此Listener成為web.xml中的第一個Listener，否則不起作用）
<listener> <listener-class>se.jiderhamn.classloader.leak.prevention.ClassLoaderLeakPreventorListener</listener-class> </listener>
這樣部署時的內(nèi)存泄漏就解決了。
注意：
1） 添加這個Listener后，默認(rèn)在tomcat關(guān)閉5s后jvm會進行內(nèi)存回收的操作，具體時間設(shè)置可在下面的第三個參考鏈接中找到，所以，在關(guān)閉后的5s內(nèi)，再次啟動tomcat，可能會存在問題，導(dǎo)致啟動無效（如果出現(xiàn)tomcat重啟后日志顯示正常但是服務(wù)器不工作的話考慮一下是不是這個問題）。
2）這個Listener只解決部署的內(nèi)存泄漏，其他問題（如jdbc等）產(chǎn)生的內(nèi)存泄漏還需要自己解決。
參考：
http://stackoverflow.com/questions/7788280/memory-leak-when-redeploying-application-in-tomcat#answer-36295683
http://java.jiderhamn.se/2011/12/11/classloader-leaks-i-how-to-find-classloader-leaks-with-eclipse-memory-analyser-mat/
https://github.com/mjiderhamn/classloader-leak-prevention
4，錯誤排除。
(1) 執(zhí)行tomcat7:deploy顯示Build Success成功但是沒有效果，也沒有在本地生成war包，檢查一下maven配置文件中packaging標(biāo)簽是否設(shè)置為war。即：
<packaging>war</packaging>
如果不是（比如說是pom），那么改成war應(yīng)該就可以了。
(2) 如果出現(xiàn)在本地tomcat服務(wù)器自動部署沒有任何問題，部署到遠(yuǎn)程服務(wù)器出現(xiàn)下面的Cannot invoke Tomcat manager: Connection reset by peer: socket write error 錯誤：
[ERROR] Failed to execute goal org.apache.tomcat.maven:tomcat7-maven-plugin:2.2:deploy (default-cli) on project webapp: Cannot invoke Tomcat manager: Connection reset by peer: socket write error -> [Help 1] org.apache.maven.lifecycle.LifecycleExecutionException: Failed to execute goal org.apache.tomcat.maven:tomcat7-maven-plugin:2.2:deploy (default-cli) on project clyf_wechat: Cannot invoke Tomcat manager at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:212) at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:153) at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:145) at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.java:116) at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.java:80) at org.apache.maven.lifecycle.internal.builder.singlethreaded.SingleThreadedBuilder.build(SingleThreadedBuilder.java:51) at org.apache.maven.lifecycle.internal.LifecycleStarter.execute(LifecycleStarter.java:128) at org.apache.maven.DefaultMaven.doExecute(DefaultMaven.java:307) at org.apache.maven.DefaultMaven.doExecute(DefaultMaven.java:193) at org.apache.maven.DefaultMaven.execute(DefaultMaven.java:106) at org.apache.maven.cli.MavenCli.execute(MavenCli.java:863) at org.apache.maven.cli.MavenCli.doMain(MavenCli.java:288) at org.apache.maven.cli.MavenCli.main(MavenCli.java:199) at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) at java.lang.reflect.Method.invoke(Method.java:497) at org.codehaus.plexus.classworlds.launcher.Launcher.launchEnhanced(Launcher.java:289) at org.codehaus.plexus.classworlds.launcher.Launcher.launch(Launcher.java:229) at org.codehaus.plexus.classworlds.launcher.Launcher.mainWithExitCode(Launcher.java:415) at org.codehaus.plexus.classworlds.launcher.Launcher.main(Launcher.java:356) Caused by: org.apache.maven.plugin.MojoExecutionException: Cannot invoke Tomcat manager at org.apache.tomcat.maven.plugin.tomcat7.AbstractCatalinaMojo.execute(AbstractCatalinaMojo.java:141) at org.apache.tomcat.maven.plugin.tomcat7.AbstractWarCatalinaMojo.execute(AbstractWarCatalinaMojo.java:68) at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo(DefaultBuildPluginManager.java:134) at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:207) ... 20 more Caused by: java.net.SocketException: Connection reset by peer: socket write error at java.net.SocketOutputStream.socketWrite0(Native Method) at java.net.SocketOutputStream.socketWrite(SocketOutputStream.java:109) at java.net.SocketOutputStream.write(SocketOutputStream.java:153) at org.apache.http.impl.io.AbstractSessionOutputBuffer.write(AbstractSessionOutputBuffer.java:181) at org.apache.http.impl.io.ContentLengthOutputStream.write(ContentLengthOutputStream.java:115) at org.apache.tomcat.maven.common.deployer.TomcatManager$RequestEntityImplementation.writeTo(TomcatManager.java:880) at org.apache.http.entity.HttpEntityWrapper.writeTo(HttpEntityWrapper.java:89) at org.apache.http.impl.client.EntityEnclosingRequestWrapper$EntityWrapper.writeTo(EntityEnclosingRequestWrapper.java:108) at org.apache.http.impl.entity.EntitySerializer.serialize(EntitySerializer.java:117) at org.apache.http.impl.AbstractHttpClientConnection.sendRequestEntity(AbstractHttpClientConnection.java:265) at org.apache.http.impl.conn.ManagedClientConnectionImpl.sendRequestEntity(ManagedClientConnectionImpl.java:203) at org.apache.http.protocol.HttpRequestExecutor.doSendRequest(HttpRequestExecutor.java:236) at org.apache.http.protocol.HttpRequestExecutor.execute(HttpRequestExecutor.java:121) at org.apache.http.impl.client.DefaultRequestDirector.tryExecute(DefaultRequestDirector.java:682) at org.apache.http.impl.client.DefaultRequestDirector.execute(DefaultRequestDirector.java:486) at org.apache.http.impl.client.AbstractHttpClient.doExecute(AbstractHttpClient.java:863) at org.apache.http.impl.client.CloseableHttpClient.execute(CloseableHttpClient.java:82) at org.apache.tomcat.maven.common.deployer.TomcatManager.invoke(TomcatManager.java:742) at org.apache.tomcat.maven.common.deployer.TomcatManager.deployImpl(TomcatManager.java:705) at org.apache.tomcat.maven.common.deployer.TomcatManager.deploy(TomcatManager.java:388) at org.apache.tomcat.maven.plugin.tomcat7.deploy.AbstractDeployWarMojo.deployWar(AbstractDeployWarMojo.java:85) at org.apache.tomcat.maven.plugin.tomcat7.deploy.AbstractDeployMojo.invokeManager(AbstractDeployMojo.java:82) at org.apache.tomcat.maven.plugin.tomcat7.AbstractCatalinaMojo.execute(AbstractCatalinaMojo.java:132) ... 23 more
使用mvn tomcat7:redeploy時出現(xiàn)如下情況
經(jīng)過查詢Tomcat文檔后發(fā)現(xiàn)，這是由于Tomcat的遠(yuǎn)程地址攔截器造成的結(jié)果，默認(rèn)情況下，Tomcat的Manager和Host-Manager只接受本機的請求，而要讓它接受遠(yuǎn)程的請求，需要添加上面提到的manager.xml的配置（第一步配置過了就不要加了），也就是：
<?xml version="1.0" encoding="UTF-8"?>
<Context privileged="true" antiResourceLocking="false"
docBase="${catalina.home}/webapps/manager">
<Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="^.*$" />
</Context>
由于Tomcat的Manager可以執(zhí)行項目的部署、卸載等敏感操作，如果你只想允許特定的IP地址訪問Manager，可在上面的allow屬性中設(shè)置規(guī)則。具體規(guī)則設(shè)置見下面的鏈接：
http://tomcat.apache.org/tomcat-7.0-doc/config/valve.html#Remote_Address_Filter
問題說明：http://tomcat.apache.org/tomcat-7.0-doc/manager-howto.html#Configuring_Manager_Application_Access
(3)自動部署顯示成功，war包也上傳成功，但是war不自動解壓自動部署。
如果你在tomcat的server.xml中通過設(shè)置<Context>標(biāo)簽來部署相同名稱的項目的話，maven發(fā)布到該服務(wù)器的war不會被自動解壓，部署，更新，需要去掉server.xml中該項目的<Context>標(biāo)簽。
5. 其他
如果想要實現(xiàn)對部署路徑加版本，可將上面tomcat7-maven-pluginconfiguration的path設(shè)置為
<path>/webapp#version</path>
的形式，部署后，當(dāng)前項目在服務(wù)器端的路徑就是/webapp/version。舉個例子，如果path設(shè)置為 test#1.0，那么服務(wù)端項目實際的路徑就是/test/1.0。如下：
如果名字和版本號之間是兩個#，效果就是制定當(dāng)前項目在manager網(wǎng)頁中顯示的版本，路徑不變，舉個例子，path設(shè)置為test##1.0，實際部署路徑為/test，但是在manager網(wǎng)頁中，顯示如下，注意Version一欄的值：
參考：
http://tomcat.apache.org/tomcat-7.0-doc/config/context.html#Naming
相關(guān)文章
這篇文章主要以文字?jǐn)⑹龅男问綖榇蠹以敿?xì)介紹了Tomcat環(huán)境變量如何配置，以及驗證方法，感興趣的小伙伴們可以參考一下2016-06-06
啟動tomcat時 錯誤: 代理拋出異常 : java.rmi.server.ExportException: Port
這篇文章主要介紹了啟動tomcat時 錯誤: 代理拋出異常 : java.rmi.server.ExportException: Port already in use: 1099的解決辦法的相關(guān)資料,需要的朋友可以參考下2016-05-05
本文主要介紹了Tomcat進程占用CPU過高的解決方法，文中通過示例代碼介紹的非常詳細(xì)，具有一定的參考價值，感興趣的小伙伴們可以參考一下2021-08-08
這篇文章主要介紹了Tomcat開啟JMX服務(wù)方法的相關(guān)內(nèi)容，小編覺得挺不錯的，在這里給大家分享一下，需要的朋友可以參考。2017-10-10
Filter是servlet規(guī)范中定義的java web組件, 在所有支持java web的容器中都可以使用，它是位于前端請求到servlet之間的一系列過濾器，也可以稱之為中間件，本文詳解介紹了Tomcat中Filter是怎樣執(zhí)行的,需要的朋友可以參考下2023-06-06
這篇文章主要介紹了windows下配置兩個或多個Tomcat啟動的方法,需要的朋友可以參考下2014-12-12
本文主要介紹了startup.bat啟動Tomcat閃退問題原因及解決，文中通過示例代碼介紹的非常詳細(xì)，具有一定的參考價值，感興趣的小伙伴們可以參考一下2022-04-04
Linux系統(tǒng)centos7.X安裝tomcat8的圖文教程
這篇文章主要介紹了Linux系統(tǒng)centos7.X安裝tomcat8的圖文教程,本文通過圖文并茂的形式給大家介紹的非常詳細(xì)，對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友可以參考下2020-04-04
tomcat啟動報錯：java.util.zip.ZipException的解決方法
這篇文章主要給大家介紹了關(guān)于tomcat啟動報：java.util.zip.ZipException錯誤的解決方法，文中通過示例代碼介紹的非常詳細(xì)，同樣遇到這個問題的朋友可以參考借鑒，下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2018-08-08
在Tomcat中,響應(yīng)緩沖區(qū)的大小是一個重要的配置參數(shù),合理設(shè)置緩沖區(qū)大小可以優(yōu)化數(shù)據(jù)傳輸效率,具有一定的參考價值,感興趣的可以了解一下2024-11-11