[精讚] [會員登入]
1869

【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

你可能感興趣的文章

【Wicket】[nonce]如何導入css以及javascript 如果只是用一般的 HTML link 或是 script 標籤來寫,會被 CSP 擋住,禁止加載資源,那我們除了關閉 CSP 以外還有沒有辦法來解決呢?

【Discord bot】(ERROR)await self.bot.wait_for() 大坑 今天真的是採到大坑,只找到解決方法,具體原因不明

【D語言】D language 安裝及使用 一種比較少見的程式語言

【Stable Diffusion web UI】[AI 作畫](Linux)無 NVIDIA 顯卡之伺服器運行測試 凡事就是要試試看,才知道最後的結果

【PaperMC】從 Waterfall 切換至 Velocity waterfall 已經停止支援,最後停留在支援 Minecraft 1.21.6,之後的 Minecraft 版本便不再支援

【Docker&Wildfly】(bitnami/wildfly)如何從零開始創建網頁伺服器 使用他人的 docker image 來架設我們的 wildfly web server

隨機好文

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

【歌評】蓮台野夜行 - 幻視之夜 ~ Ghostly Eyes 若有什麼是在聽到boss曲前的鋪襯,那一定就是每個系列的道中曲

三民(乙) Book.4 Unit 4 單字和片語 給某個常常忘記帶單字本的小編…

小穹‧動畫化‧體驗記 ⑪ 「小穹,妳那個『小光雞排店』的置入性行銷未免太明顯了吧?」耐耐吐槽道。   「沒辦法嘛,之前還在募款的時候,小光出了很多錢啊。」小穹說。   「安靜一點,有觀眾轉過來看我們了。」艾米輕聲打斷她

與你的戀愛記憶 特別篇① 「剩結論了…這篇論文也太折磨人了吧?」整個空間裡只有我敲打鍵盤的聲音 「呦■■■