[精讚] [會員登入]
918

【Maven】用Maven來託管Wildfly/jBoss的部屬(deploy)、解部屬(undeploy)

極簡版,給未來想要抄作業的小編自己,完整的一切設定檔,可以依照個人需求作增刪。

分享此文連結 //n.sfs.tw/15330

分享連結 【Maven】用Maven來託管Wildfly/jBoss的部屬(deploy)、解部屬(undeploy)@小編過路君子
(文章歡迎轉載,務必尊重版權註明連結來源)
2023-03-25 21:38:54 最後編修
2021-08-06 20:46:15 By 過路君子
 

大家好,這裡是好不容易弄好這個的小編過路君子

基本上沒有什麼中文說明文件可以看,生咬了一大堆的英文文檔,不想再來一次了

 

如果各位只是想要單純將檔案打包成 Jar檔或是 War檔的話可以參考下方的文章。

War 【Maven】如何創建一個簡單可部屬的WAR檔@小編過路君子
Jar 【Maven】如何創建一個簡單可執行的JAR檔@小編過路君子

 

那小編在這裡附上小編所使用軟體的版本資訊。

版本資訊:

Maven: 3.8.1
Wildfly: 24.0.1.Final
WildFly Maven Plugin: 2.0.2.Final

使用管理的軟體就是 WildFly Maven Plugin,相關版本以及 dependency的資訊頁面,點擊這裡前往

 

為了接下來的解釋方便,以下統一將 Wildfly/jBoss都稱為 Wildfly。

在Maven上託管Wildfly,有兩種狀況:

1. 由 Maven來strat, shutdown,換言之,就是透過 mvn wildfly:start或 mvn wildfly:shutdown來啟動或停止 Wildfly
2. 本來就跑在伺服器上的 Wildfly,換言之,就是透過 systemctl start wildfly或 systemctl stop wildfly來啟動或是停止 Wildfly

本文章所針對的狀況是狀況二,如果各位是採用狀況一,那...小編也只能跟你說一聲不好意思了。

 

在正式進到 Maven設定前,需要各位先確認自己的 Wildfly正在運作中,如下圖:

(所有圖片點擊都可以放大、變高清)

 

至於 Wildfly如何安裝、設置在這裡不是重點,所以小編在這就稍稍提一下就帶過了。

小編在將 Wildfly交給 Maven託管前,就已經將其設定全部結束了,包括綁定 Public IP、防火牆規則設置或是 Wildfly啟動規則設置。

所以如果在尚未交給 Maven託管就無法透過瀏覽器來訪問,就算現在交給 Maven託管也不會突然就可以被瀏覽器來訪問,在這裡只是將「部屬」和「取消部屬」的權利交給了 Maven,並不會對 Wildfly的任何基本設定做變動。

 

那接下來就進到了 Maven設置了,第一步,當然是先將 Maven的專案結構給先全部建立好,整體結構如下:

Mavan專案資料夾結構
Basic-Setting(專案目錄)
|-- pom.xml
|--\ src
|    |
|    |--\ main
|        |
|        |--\ resources
|        |--\ webapp
|            |
|            |-- index.html
|            |--\ WEB-INF
|                |
|                |-- web.xml
|                |-- jboss-web.xml

其中跟 index.html就是當其他人連線進來時第一個會看到的頁面,其他三個 .xml則是非常重要的設定檔。

 

index的"Hello World"簡單範例

<!DOCTYPE html>
<html>
    <head>
        <title>Hello World!</title>
    </head>
    <body>
        <p>Hello World!</p>
    </body>
</html>

 

pom.xml的範例設定

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">;
<modelVersion>4.0.0</modelVersion>

	<groupId>passing.editor.guild245</groupId>
	<artifactId>pixiJS-web</artifactId>
	<version>1.0.0</version>

	<name>pixiJS-web Maven Webapp</name>
	<url>http://maven.apache.org</url>

	<properties>
		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
		<maven.compiler.source>1.8</maven.compiler.source>
		<maven.compiler.target>1.8</maven.compiler.target>
	</properties>

	<repositories>
		<repository>
			<id>clojars.org</id>
			<url>https://repo.clojars.org</url>
		</repository>
	</repositories>

	<dependencies>
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>4.11</version>
			<scope>test</scope>
		</dependency>
		<dependency>
			<groupId>org.apache.maven.plugins</groupId>
			<artifactId>maven-gpg-plugin</artifactId>
			<version>3.0.1</version>
		</dependency>
	</dependencies>

	<packaging>war</packaging>
  
	<build>
		<pluginManagement>
			<plugins>
				<plugin>
					<groupId>org.wildfly.plugins</groupId>
					<artifactId>wildfly-maven-plugin</artifactId>
					<version>2.0.2.Final</version>
					<configuration>
						<jbossHome>/opt/wildfly</jbossHome>
						<hostname>127.0.0.1</hostname>
						<port>9990</port>
						<username>username</username>
						<password>password</password>
					</configuration>
				</plugin>
				<plugin>
					<groupId>org.apache.maven.plugins</groupId>
					<artifactId>maven-war-plugin</artifactId>
					<version>3.3.1</version>
				</plugin>
				<plugin>
					<artifactId>maven-clean-plugin</artifactId>
					<version>3.1.0</version>
				</plugin>
				<plugin>
					<artifactId>maven-resources-plugin</artifactId>
					<version>3.0.2</version>
				</plugin>
				<plugin>
					<artifactId>maven-surefire-plugin</artifactId>
					<version>2.22.1</version>
				</plugin>
				<plugin>
					<artifactId>maven-install-plugin</artifactId>
					<version>2.5.2</version>
				</plugin>
				<plugin>
					<artifactId>maven-deploy-plugin</artifactId>
					<version>2.8.2</version>
				</plugin>
				<plugin>
					<artifactId>maven-site-plugin</artifactId>
					<version>3.7.1</version>
				</plugin>
				<plugin>
					<artifactId>maven-project-info-reports-plugin</artifactId>
					<version>3.0.0</version>
				</plugin>
			</plugins>
		</pluginManagement>
	</build>
</project>

 

WildFly Maven Plugin並不是要寫在 dependencies裡,而是要寫在 pluginManagement裡,如果寫在 dependencies在執行的時候就會報錯,這點要稍稍注意一下。

或是只將下列的 plugin寫入現有的 pom.xml裡面

<plugin>
    <groupId>org.wildfly.plugins</groupId>
    <artifactId>wildfly-maven-plugin</artifactId>
    <version>2.0.2.Final</version>
    <configuration>
		<port>9990</port>
		<username>username</username>
		<password>password</password>
		<hostname>127.0.0.1</hostname>
		<jbossHome>/opt/wildfly</jbossHome>
    </configuration>
</plugin>

groupId, artifactId, version基本上都不需要更改,就只有 configuration裡要請各位特別注意並依照目前個人狀態來做修改。

port:
Wildfly的管理界面所在的 port,預設聆聽的 port為9990,如果有各位有更改,那這裡也要更改。

username, password:
Wildfly的管理員帳號密碼,這兩項可有可無,如果沒有設定,則每次 deploy或 undeploy的時候都要輸入一次帳號密碼。

hostname:
IP位置,如果 Wildfly有綁定 Public IP的話,這裡就填入那個 IP就可以了,例如:8.8.8.8。

jbossHome:
Wildfly的目錄,也就是進去可以找到 bin目錄的位置,建議填寫絕對位置,因為根據狀況不同,相對開始點也不太一樣。

這邊有一個需要注意的點,也就是如果各位在 configuration看到了 version的設置,那就要特別警覺了,例如:<version>24.0.1.Final</version>

一個 plugin竟然出現了兩個 version是怎麼回事?!

第一個 version是 WildFly Maven Plugin這個的版本沒有問題,而第二個 version則是代表 Wildfly所使用的版本,也就是說......Maven事實上是有能力自我下載、啟動一個 Wildfly,這就跟狀況一類似了,換言之,狀況一和狀況二就是差在有沒有這行。

如果各位很不幸地看到這行,那接下來的設定檔有可能沒法用,不好意思了。

 

web.xml的設定範例

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
         http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
		 version="3.1">

	<welcome-file-list>
		<welcome-file>index.html</welcome-file>
	</welcome-file-list>

    <servlet-mapping>
        <servlet-name>register</servlet-name>
        <url-pattern>/register/*</url-pattern>
    </servlet-mapping>
</web-app>

如果首頁不喜歡叫 index.html或是首頁是 index.jsp之類的,那在第八行的 index.html則改成各位要設成首頁的檔案名稱。

 

jboss-web.xml的設定範例

<jboss-web>   
	<context-root>/</context-root>
</jboss-web>

 

都設置好之後就可以執行 mvn wildfly:deploy來看看能不能成功。

要取消部屬則是使用 mvn wildfly:undeploy,執行方式差不多,過程小邊就不在這裡做示範了。

 

 

 

後記

這部分的設定嚴格來說應該算是最後最後的階段了,因為完全跳過了 Wildfly的安裝、設置,設置完畢之後以後部屬、取消部屬就可以直接下一條指令就全部結束了。

END

你可能感興趣的文章

【Maven】如何開始撰寫 Minecraft PaperMC server插件 萬事起頭難,要開始寫一個插件最難的一步就是要怎麼開始寫

【C++】使用SFML創建新視窗和新增圖標(ICON)並隱藏DOS 筆記,怕自己以後忘記怎麼創建並開啓一個新視窗

【Wicket】[URI]使用Java取得目前網址 這是個還滿常用的功能,可惜 Wicket 沒有內建函式可以快速取得我們要的部分,只能依靠我們自己後期的字串剖析

【Discord bot】[botton]按鈕的使用、響應和關閉 Discord的botton通常都要和View配合使用。

【Maven】如何夾帶檔案至Jar內以及其讀取方式 想要讀取一個外部的文字文件?Maven是你的好幫手

【自製-製作epub輔助工具】(Sigil) content產生器 能交給程式快速結束的地方就不要自己手動浪費時間了吧。

我有話要說

>>

限制:留言最高字數1000字。 限制:未登入訪客,每則留言間隔需超過10分鐘,每日最多5則留言。

訪客留言

[無留言]

隨機好文

高捷少女:布拉格體驗㊦ 「各位想到盧卡站的乘客,請到我們左手邊排隊!」婕兒大聲地喊道。     「這孩子怎麼穿著地鐵站制服?童工嗎?」一位大嬸歪頭問道。

高捷少女:地下城的探險少女④ 耐耐突然抖了一下。「妳們聽到了嗎?」她說。「聽到什麼?」婕兒問。「那個腳步聲啊!」耐耐嚥了一下喉嚨,覺得有些害怕。「有一陣腳步聲經過,很小聲,但我還是聽到了。』「妳聽錯了吧……等等!」婕兒使終維持著將

高捷少女:購票大作戰① 「各位乘客,本班機即將降落,感謝各位乘客的搭乘……」隨著空中小姐的廣播音,那架飛機逐漸降落在地面,裡面的乘客們也紛紛開始整理自己的行李。 那個有著歐美人五官的少女抓緊包包,看著外面的小港機場,臉上緩緩

高捷少女:美麗島的守護者⑥ 一陣貓叫傳到小雅耳中,原本要朝小雅撲過去的北風轉了個圈,從半空中落地,牠的表情宛如五雷轟頂。這聲音……難道是……

婕兒──她的青春④ 「投降吧,耐耐!這回合妳將不會再有獲勝的機會了!哈哈哈哈!」 「妳確定?」耐耐臉上泛起一絲微笑,並將手中的牌展示給婕兒看 婕兒的笑容僵住了。恐懼浮現在她的臉。