Maven 遠(yuǎn)程熱部署Tomcat

出處:
http://www.cnblogs.com/letcafe/
https://www.cnblogs.com/xyb930826/p/5725340.html

概述

Maven本身不提供任何插件將war包發(fā)布到遠(yuǎn)程站點(diǎn),例如Tomcat這樣類似的Servlet容器,但是乃摹,Apache Tomcat本身提供了一個(gè)Maven插件:

<dependency>
    <groupId>org.apache.tomcat.maven</groupId>
    <artifactId>tomcat7-maven-plugin</artifactId>
    <version>2.1</version>
</dependency>

tomcat7-maven-plugin是很久以前的插件版本阱飘,默認(rèn)支持到Tomcat7拓颓,但是對(duì)于目前最新的Tomcat9同樣可以使用該插件(雖然插件的ArtifactId的名字為tomcat7很奇怪)

插件介紹的官網(wǎng)文檔為:

http://tomcat.apache.org/maven-plugin-2.1/index.html

一逻淌、Tomcat插件支持的目標(biāo)

默認(rèn)使用的Tomcat7插件支持多種目標(biāo),

調(diào)用格式如下:

mvn tomcat7:[goal]

例如面氓,遠(yuǎn)程部署一個(gè)項(xiàng)目到Tomcat容器:

mvn tomcat7:deploy

文檔如下:

目標(biāo) 描述
deploy 部署war包到Tomcat中
deploy-only 不經(jīng)過package階段羔味,直接將包部署到Tomcat中(傳輸現(xiàn)成的)
exec-war 創(chuàng)建一個(gè)包含必要Apache Tomcat類庫的自可執(zhí)行jar包河咽,這允許使
用類似'jar -jar mywebapp.jar'直接運(yùn)行APP而不需要Tomcat實(shí)例
exec-war-only 同上exec-war,但是不使用package階段
help 展示所有的幫助信息
redeploy 重新部署war包到Tomcat(等同于deploy目標(biāo)加上update=true參數(shù))
redeploy-only 重新部署war包到Tomcat但是不經(jīng)過package階段(等同于deploy目
標(biāo)加上update=true參數(shù))
run 將當(dāng)前項(xiàng)目作為動(dòng)態(tài)web程序(exploded)赋元,使用嵌入的Tomcat服務(wù)器運(yùn)行
run-war 將當(dāng)前項(xiàng)目作為打包后的war(war)忘蟹,使用嵌入的Tomcat服務(wù)器運(yùn)行
run-war-only 同run-war,但是不使用package階段
shutdown 關(guān)閉所有已經(jīng)開始的嵌入式Tomcat服務(wù)器
standalone-war 創(chuàng)建嵌入Tomcat的可執(zhí)行war搁凸,并且可以在別的地方部署
standalone-war-only 同standalone-war但是不使用package階段
undeploy 從Tomcat服務(wù)器中媚值,取消部署某一個(gè)項(xiàng)目

二、系統(tǒng)要求及插件引入

2.1 系統(tǒng)要求

要求如下:

組件 Maven JDK 內(nèi)存 硬盤
要求 2.0+ 1.5+ 無要求 無要求

2.2 引入插件

引入方式:

<project>
  ...
  <build>
    <!-- 在POM中或父POM中使用這樣的插件(IDEA會(huì)出現(xiàn)對(duì)應(yīng)的插件欄) -->
    <plugins>
      <plugin>
        <groupId>org.apache.tomcat.maven</groupId>
        <artifactId>tomcat7-maven-plugin</artifactId>
        <version>2.1</version>
      </plugin>
      ...
    </plugins>
  </build>
  ...
</project>

三坪仇、遠(yuǎn)程部署war到tomcat

命令格式:

mvn tomcat7:deploy

3.1 添加tomcat管理角色

修改tomcat的用戶配置文件

%TOMCAT_HOME%/conf/tomcat-users.xml杂腰,添加一個(gè)用戶:

<?xml version="1.0" encoding="UTF-8"?>
<tomcat-users xmlns="http://tomcat.apache.org/xml"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="http://tomcat.apache.org/xml tomcat-users.xsd"
              version="1.0">
    <role rolename="manager-gui" />
    <role rolename="manager-script"/>
    <user username="username" password="password" roles="manager-gui,manager-script"/>
</tomcat-users>

注意!可以給該用戶添加多個(gè)角色椅文,為了遠(yuǎn)程部署,需要調(diào)用script,至少需要這個(gè)角色:

  • manager-script

當(dāng)然惜颇,也可以開啟manager-gui用于可視化管理

3.15 添加manager.xml的配置

默認(rèn)情況下皆刺,Tomcat的Manager和Host-Manager只接受本機(jī)的請(qǐng)求,而要讓它接受遠(yuǎn)程的請(qǐng)求凌摄,需要添加manager.xml的配置

在tomcat服務(wù)器的conf/Catalina/localhost/目錄下創(chuàng)建一個(gè)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í)行項(xiàng)目的部署锨亏、卸載等敏感操作痴怨,如果你只想允許特定的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.2 本地Maven設(shè)置Server

為了讓本地發(fā)布的Maven可以找到對(duì)應(yīng)的服務(wù)器并完成鑒權(quán)

需要修改settings.xml浪藻,并添加服務(wù)器捐迫,這里的賬號(hào)、密碼需要和部署的tomcat服務(wù)器配置的一致

<servers>
    <server>
        <id>tomcatServer</id>
        <username>username</username>
        <password>password</password>
    </server>
</servers>

3.3 項(xiàng)目配置Tomcat插件

<build>
    <!-- 在POM中或父POM中使用這樣的插件(IDEA會(huì)出現(xiàn)對(duì)應(yīng)的插件欄) -->
    <plugins>
        <plugin>
            <groupId>org.apache.tomcat.maven</groupId>
            <artifactId>tomcat7-maven-plugin</artifactId>
            <version>2.2</version>
            <configuration>
                <url>http://{yourIP}:8080/manager/text</url>  <!--部署到哪臺(tái)服務(wù)器, 使用的是tomcat的默認(rèn)項(xiàng)目manager進(jìn)行deploy, 因此/manager/text是manager固定的接口爱葵。用戶名密碼使用的是tomcat的tomcat-users.xml配置文件中具備manager-script的用戶名密碼, 另外需要在maven的setting.xml配置同樣的用戶名密碼-->
                <server>tomcatServer</server>
                <update>true</update>
                <path>/${project.artifactId}</path>
            </configuration>
        </plugin>
      ...
    </plugins>
</build>

此處指定了插件所使用的<server style="margin: 0px; padding: 0px;">切記需要一致(setting.xml和pom.xml)</server>

3.4 插件參數(shù)說明

tomcat7-maven-plugin為每個(gè)目標(biāo)提供了多個(gè)參數(shù)施戴,每個(gè)目標(biāo)可以有相關(guān)的配置,具體說明可參考官方文檔:

http://tomcat.apache.org/maven-plugin-2.1/tomcat7-maven-plugin/plugin-info.html

3.4.1 必選參數(shù)

以下參數(shù)必選萌丈,但是可以在pom中空缺赞哗,空缺時(shí)將采用默認(rèn)值

名稱 描述 默認(rèn)值
charset 在與Tomcat Manager通信是的URL編
碼字符集 ISO-8859-1
mode 部署的模式,值可為:war,context,both war
path 應(yīng)用程序運(yùn)行的上下文路徑辆雾,必須以'/'開始 /${project.artifactId}
update 當(dāng)部署已存在的應(yīng)用時(shí)肪笋,是否自動(dòng)
undeploy該應(yīng)用 false
url Tomcat Manager實(shí)例使用的全路徑 http://localhost:8080
/manager/text
warFile 部署warFile的路徑 ${project.build.directory}
/${project.build.finalName}.war

3.4.2 可選參數(shù)

對(duì)于個(gè)性化的需求,tomcat7插件提供了可配置的參數(shù)

名稱 描述
contextFile Tomcat的context的XML路徑度迂,對(duì)于mode=war不適用涂乌,默認(rèn)為

{project.build.directory}/{project.build.finalName}/
META-INF/context.xml |
| ignorePackaging | 如果設(shè)置為true,忽略類型不是war的項(xiàng)目 |
| username | 部署到Tomcat的username |
| password | 部署到Tomcat的password |
| server | 指定Maven的setting.xml中配置的server id用于Tomcat認(rèn)證 |
| tag | 應(yīng)用程序在Tomcat中使用的標(biāo)簽的名字 |

3.5 運(yùn)行結(jié)果

如果是第一次部署英岭,運(yùn)行mvn tomcat7:deploy進(jìn)行自動(dòng)部署(對(duì)于tomcat8,9湾盒,也是使用tomcat7命令),如果是更新了代碼后重新部署更新诅妹,運(yùn)行mvn tomcat7:redeploy罚勾,如果第一次部署使用mvn tomcat7:redeploy,則只會(huì)執(zhí)行上傳war文件吭狡,服務(wù)器不會(huì)自動(dòng)解壓部署尖殃。如果路徑在tomcat服務(wù)器中已存在并且使用mvn tomcat7:deploy命令的話,上面的配置中一定要配置<update>true</update>划煮,不然會(huì)報(bào)錯(cuò)送丰。tomcat7:deploy前必須先maven:install從父項(xiàng)目到子項(xiàng)目部署到本地倉庫

調(diào)用:mvn tomcat7:deploy命令得到下圖:

image

成功快速部署到tomcat中

image

四、遠(yuǎn)程undeploy

此外弛秋,如果快速卸載(undeploy)Tomcat服務(wù)器的項(xiàng)目器躏,使用:

mvn tomcat7:undeploy

效果如下:

image
image

五、其他問題

(1)自動(dòng)部署顯示成功蟹略,war包也上傳成功登失,但是war不自動(dòng)解壓自動(dòng)部署。

如果你在tomcat的server.xml中通過設(shè)置<Context>標(biāo)簽來部署相同名稱的項(xiàng)目的話挖炬,maven發(fā)布到該服務(wù)器的war不會(huì)被自動(dòng)解壓揽浙,部署,更新,需要去掉server.xml中該項(xiàng)目的<Context>標(biāo)簽馅巷。

(2)內(nèi)存泄漏
使用上面的方法進(jìn)行部署后會(huì)出現(xiàn)嚴(yán)重的內(nèi)存泄漏現(xiàn)象膛虫。tomcat的manager提供了診斷在部署時(shí)是否產(chǎn)生內(nèi)存泄漏的功能,在上面提到的http://serverip:port/manager/html這個(gè)頁面底部有一個(gè)“Find leaks”的按鈕钓猬,如下:

image

點(diǎn)擊按鈕稍刀,網(wǎng)頁頭部出現(xiàn)如下信息說明在部署的時(shí)候有內(nèi)存泄漏:

image

上面的消息顯示部署的test項(xiàng)目存在內(nèi)存泄漏,如果同一項(xiàng)目多次重新部署逗噩,則一個(gè)項(xiàng)目名可能會(huì)出現(xiàn)多次掉丽。

部署時(shí)產(chǎn)生內(nèi)存泄漏的原因是每次(重新)部署時(shí),Tomcat會(huì)為項(xiàng)目新建一個(gè)類加載器异雁,而舊的類加載器沒有被GC回收捶障。maven的庫classloader-leak-prevention-servlet可以用來解決這個(gè)問題。具體方案為:

(1)添加maven依賴:

<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;"><dependency>
<groupId>se.jiderhamn.classloader-leak-prevention</groupId>
<artifactId>classloader-leak-prevention-servlet</artifactId>
<version>2.1.0</version>
</dependency></pre>

(2)在項(xiàng)目的web.xml中添加一個(gè)Listener(必須讓此Listener成為web.xml中的第一個(gè)Listener纲刀,否則不起作用

<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;"><listener>
<listener-class>se.jiderhamn.classloader.leak.prevention.ClassLoaderLeakPreventorListener</listener-class>
</listener></pre>

這樣部署時(shí)的內(nèi)存泄漏就解決了项炼。
注意:
1) 添加這個(gè)Listener后,默認(rèn)在tomcat關(guān)閉5s后jvm會(huì)進(jìn)行內(nèi)存回收的操作示绊,具體時(shí)間設(shè)置可在下面的第三個(gè)參考鏈接中找到锭部,所以,在關(guān)閉后的5s內(nèi)面褐,再次啟動(dòng)tomcat拌禾,可能會(huì)存在問題,導(dǎo)致啟動(dòng)無效(如果出現(xiàn)tomcat重啟后日志顯示正常但是服務(wù)器不工作的話考慮一下是不是這個(gè)問題)展哭。
2)這個(gè)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

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末匪傍,一起剝皮案震驚了整個(gè)濱河市您市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌役衡,老刑警劉巖茵休,帶你破解...
    沈念sama閱讀 222,590評(píng)論 6 517
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異手蝎,居然都是意外死亡榕莺,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 95,157評(píng)論 3 399
  • 文/潘曉璐 我一進(jìn)店門柑船,熙熙樓的掌柜王于貴愁眉苦臉地迎上來帽撑,“玉大人,你說我怎么就攤上這事鞍时。” “怎么了?”我有些...
    開封第一講書人閱讀 169,301評(píng)論 0 362
  • 文/不壞的土叔 我叫張陵逆巍,是天一觀的道長及塘。 經(jīng)常有香客問我,道長锐极,這世上最難降的妖魔是什么笙僚? 我笑而不...
    開封第一講書人閱讀 60,078評(píng)論 1 300
  • 正文 為了忘掉前任,我火速辦了婚禮灵再,結(jié)果婚禮上肋层,老公的妹妹穿的比我還像新娘。我一直安慰自己翎迁,他們只是感情好栋猖,可當(dāng)我...
    茶點(diǎn)故事閱讀 69,082評(píng)論 6 398
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著汪榔,像睡著了一般蒲拉。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上痴腌,一...
    開封第一講書人閱讀 52,682評(píng)論 1 312
  • 那天雌团,我揣著相機(jī)與錄音,去河邊找鬼士聪。 笑死锦援,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的剥悟。 我是一名探鬼主播灵寺,決...
    沈念sama閱讀 41,155評(píng)論 3 422
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼懦胞!你這毒婦竟也來了替久?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 40,098評(píng)論 0 277
  • 序言:老撾萬榮一對(duì)情侶失蹤躏尉,失蹤者是張志新(化名)和其女友劉穎蚯根,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體胀糜,經(jīng)...
    沈念sama閱讀 46,638評(píng)論 1 319
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡颅拦,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,701評(píng)論 3 342
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了教藻。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片距帅。...
    茶點(diǎn)故事閱讀 40,852評(píng)論 1 353
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖括堤,靈堂內(nèi)的尸體忽然破棺而出碌秸,到底是詐尸還是另有隱情绍移,我是刑警寧澤,帶...
    沈念sama閱讀 36,520評(píng)論 5 351
  • 正文 年R本政府宣布讥电,位于F島的核電站蹂窖,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏恩敌。R本人自食惡果不足惜瞬测,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 42,181評(píng)論 3 335
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望纠炮。 院中可真熱鬧月趟,春花似錦、人聲如沸恢口。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,674評(píng)論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽弧蝇。三九已至碳褒,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間看疗,已是汗流浹背沙峻。 一陣腳步聲響...
    開封第一講書人閱讀 33,788評(píng)論 1 274
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留两芳,地道東北人摔寨。 一個(gè)月前我還...
    沈念sama閱讀 49,279評(píng)論 3 379
  • 正文 我出身青樓,卻偏偏與公主長得像怖辆,于是被迫代替她去往敵國和親是复。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,851評(píng)論 2 361

推薦閱讀更多精彩內(nèi)容