Maven入门:使用Nexus搭建Maven私服及上传下载jar包
一. 私服搭建及配置
1 . 私服簡介
私服是架設(shè)在局域網(wǎng)的一種特殊的遠(yuǎn)程倉庫,目的是代理遠(yuǎn)程倉庫及部署第三方構(gòu)件。有了私服之后,當(dāng) Maven 需要下載構(gòu)件時,直接請求私服,私服上存在則下載到本地倉庫;否則,私服請求外部的遠(yuǎn)程倉庫,將構(gòu)件下載到私服,再提供給本地倉庫下載。
我們可以使用專門的 Maven 倉庫管理軟件來搭建私服,比如:Apache Archiva,Artifactory,Sonatype Nexus。這里我們使用 Sonatype Nexus。
2 . 安裝Nexus
2 . 1 . 下載Nexus
Nexus 專業(yè)版是需要付費(fèi)的,這里我們下載開源版 Nexus OSS。下載地址:http://www.sonatype.org/nexus/go,最新的為OSS3.X,我這里選擇穩(wěn)定版本2.x,點(diǎn)擊后自動下載
2 . 2 . 使用bundle安裝包安裝Nexus
解壓安裝包nexus-2.14.5-02.zip,打開命令提示符,進(jìn)入nexus-2.14.5-02/bin目錄 (為方便啟動和退出Nexus,可將bin目錄添加到環(huán)境變量),
1.執(zhí)行nexus命令
2.執(zhí)行 nexus install 將Nexus安裝為Windows服務(wù)
3.打開瀏覽器,訪問:http://localhost:8081/nexus/:
點(diǎn)擊右上角 Log In,使用用戶名:admin ,密碼:admin123 登錄,可使用更多功能:
4 . Nexus預(yù)置的倉庫
4.1 類型介紹
登陸Nexus,在左邊菜單欄里選擇Repositories,然后會出現(xiàn)右邊的畫面,右邊上半部分是列出來的repository,黑體字是類型為group的repository。
這里簡單介紹下幾種repository的類型:
? hosted,本地倉庫,通常我們會部署自己的構(gòu)件到這一類型的倉庫。比如公司的第二方庫。
? proxy,代理倉庫,它們被用來代理遠(yuǎn)程的公共倉庫,如maven中央倉庫。
? group,倉庫組,用來合并多個hosted/proxy倉庫,當(dāng)你的項(xiàng)目希望在多個repository使用資源時就不需要多次引用了,只需要引用一個group即可。
4.2管理本地倉庫
我們前面講到類型為hosted的為本地倉庫,Nexus預(yù)置了3個本地倉庫,分別是Releases, Snapshots, 3rd Party. 分別講一下這三個預(yù)置的倉庫都是做什么用的:
Releases:
這里存放我們自己項(xiàng)目中發(fā)布的構(gòu)建, 通常是Release版本的, 比如我們自己做了一個FTP Server的項(xiàng)目, 生成的構(gòu)件為ftpserver.war, 我們就可以把這個構(gòu)建發(fā)布到Nexus的Releases本地倉庫. 關(guān)于符合發(fā)布后面會有介紹.
Snapshots:
這個倉庫非常的有用, 它的目的是讓我們可以發(fā)布那些非release版本, 非穩(wěn)定版本, 比如我們在trunk下開發(fā)一個項(xiàng)目,在正式release之前你可能需要臨時發(fā)布一個版本給你的同伴使用, 因?yàn)槟愕耐檎谝蕾嚹愕哪K開發(fā), 那么這個時候我們就可以發(fā)布Snapshot版本到這個倉庫, 你的同伴就可以通過簡單的命令來獲取和使用這個臨時版本.
3rd Party:
顧名思義, 第三方庫, 你可能會問不是有中央倉庫來管理第三方庫嘛,沒錯, 這里的是指可以讓你添加自己的第三方庫, 比如有些構(gòu)件在中央倉庫是不存在的. 比如你在中央倉庫找不到Oracle 的JDBC驅(qū)動, 這個時候我們就需要自己添加到3rdparty倉庫。
4.3 在Nexus為自己的項(xiàng)目手動單獨(dú)建庫
1. 建庫,Add-- >HostedRepository
按照下圖填寫信息,注意圈的地方,填寫完成后save
2. 然后選擇PublicRepositories,打開configuration選項(xiàng)卡
3. 將自己創(chuàng)建的倉庫添加到group,如圖從右側(cè)移到左側(cè),點(diǎn)擊save,保存。至此,已經(jīng)成功搭建好我們自定義的倉庫了。
注:如果需要你還可以創(chuàng)建一個倉庫組,在Repositories菜單處選add-->Repository Group即可
5. 在Nexus創(chuàng)建賬戶
最后點(diǎn)擊保存。當(dāng)然自己也可以創(chuàng)建角色,分配權(quán)限等,這里直接用已有的角色,省略了一些步驟。
二. 利用搭建的私服,進(jìn)行上傳和下載jar包
1. 遠(yuǎn)程倉庫的認(rèn)證
大部分公共的遠(yuǎn)程倉庫無須認(rèn)證就可以直接訪問,但我們在平時的開發(fā)中往往會架設(shè)自己的Maven遠(yuǎn)程倉庫,出于安全方面的考慮,我們需要提供認(rèn)證信息才能訪問這樣的遠(yuǎn)程倉庫。配置認(rèn)證信息和配置遠(yuǎn)程倉庫不同,遠(yuǎn)程倉庫可以配置在settings.xml文件中,也可直接在pom.xml中配置,后面會分別舉例說明,但是認(rèn)證信息必須配置在settings.xml文件中。在settings.xml中配置認(rèn)證信息更為安全。如下:在settings.xml中配置<servers>節(jié)點(diǎn),用的賬號為上面我們創(chuàng)建的賬戶。
1 <settings> 2 2 ... 3 3 <!--配置遠(yuǎn)程倉庫認(rèn)證信息--> 4 4 <servers> 5 5 <server> 6 6 <id>bbsnexus</id> 7 7 <username>licui</username> 8 8 <password>a111111</password> 9 9 </server> 10 10 </servers> 11 11 ... 12 12 </settings>
上面代碼我們配置了一個id為bbsnexus的遠(yuǎn)程倉庫認(rèn)證信息。Maven使用settings.xml文件中的servers元素及其子元素server配置倉庫認(rèn)證信息。認(rèn)證用戶名為licui,認(rèn)證密碼為a111111。這里的關(guān)鍵是id元素,id沒有要求,隨便定義,但是后面配置遠(yuǎn)程倉庫的id必須和這里的id保持一致。正是這個id將認(rèn)證信息與倉庫配置聯(lián)系在了一起。
2. 配置遠(yuǎn)程倉庫
如果只有一個項(xiàng)目,可以配置在項(xiàng)目的pom文件中:
如果有多個項(xiàng)目時,可以將如上配置放到Maven的Settings文件中:
repository:在repositories元素下,可以使用repository子元素聲明一個或者多個遠(yuǎn)程倉庫。
id:倉庫聲明的唯一id,尤其需要注意的是,Maven自帶的中央倉庫使用的id為central,如果其他倉庫聲明也使用該id,就會覆蓋中央倉庫的配置。
name:倉庫的名稱,讓我們直觀方便的知道倉庫是哪個,暫時沒發(fā)現(xiàn)其他太大的含義。
url:指向了倉庫的地址,一般來說,該地址都基于http協(xié)議,Maven用戶都可以在瀏覽器中打開倉庫地址瀏覽構(gòu)件。
releases和snapshots:用來控制Maven對于發(fā)布版構(gòu)件和快照版構(gòu)件的下載權(quán)限。需要注意的是enabled子元素,該例中releases的enabled值為true,表示開啟JBoss倉庫的發(fā)布版本下載支持,而snapshots的enabled值為false,表示關(guān)閉JBoss倉庫的快照版本的下載支持。根據(jù)該配置,Maven只會從JBoss倉庫下載發(fā)布版的構(gòu)件,而不會下載快照版的構(gòu)件。
layout:元素值default表示倉庫的布局是Maven2及Maven3的默認(rèn)布局,而不是Maven1的布局?;静粫玫組aven1的布局。
其他:對于releases和snapshots來說,除了enabled,它們還包含另外兩個子元素updatePolicy和checksumPolicy。
元素updatePolicy用來配置Maven從遠(yuǎn)處倉庫檢查更新的頻率,默認(rèn)值是daily,表示Maven每天檢查一次。其他可用的值包括:never-從不檢查更新;always-每次構(gòu)建都檢查更新;interval:X-每隔X分鐘檢查一次更新(X為任意整數(shù))。
元素checksumPolicy用來配置Maven檢查校驗(yàn)和文件的策略。當(dāng)構(gòu)建被部署到Maven倉庫中時,會同時部署對應(yīng)的檢驗(yàn)和文件。在下載構(gòu)件的時候,Maven會驗(yàn)證校驗(yàn)和文件,如果校驗(yàn)和驗(yàn)證失敗,當(dāng)checksumPolicy的值為默認(rèn)的warn時,Maven會在執(zhí)行構(gòu)建時輸出警告信息,其他可用的值包括:fail-Maven遇到校驗(yàn)和錯誤就讓構(gòu)建失??;ignore-使Maven完全忽略校驗(yàn)和錯誤。
3.配置倉庫鏡像
默認(rèn)的,如果本地倉庫找不到依賴的構(gòu)件,這時需要東西時先到Nexus上找,如果發(fā)現(xiàn)Nexus服務(wù)關(guān)閉后,會自動到中央倉庫找。
如果我們想覆蓋中央倉庫的默認(rèn)地址,強(qiáng)制依賴的東西都到Nexus中去找,即使Nexus關(guān)閉也不會到中央工廠去下載:
修改Maven的Settings文件:
至此,我們已經(jīng)可以從自己搭建的私服下載jar了。
4.上傳jar包到遠(yuǎn)程倉庫
1)將已有的項(xiàng)目打成jar包上傳到私服服務(wù)器
首先需要在pom.xml中配置上傳倉庫的地址,配置distributionManagement元素,倉庫地址指向前面自定義的倉庫bbsid
1 <distributionManagement> 2 <repository> 3 <id>bbsnexus</id> 4 <name>bbsidrepository</name> 5 <url>http://127.0.0.1:8081/nexus/content/repositories/bbsid</url> 6 </repository> 7 </distributionManagement>
distributionManagement包含repository和snapshotRepository子元素,前者表示發(fā)布版本(穩(wěn)定版本)jar包的倉庫,后者表示快照版本(開發(fā)測試版本)的倉庫。
這兩個元素都需要配置id、name和url,id為遠(yuǎn)程倉庫的唯一標(biāo)識,很重要,name只是為了方便人閱讀,關(guān)鍵的url表示該倉庫的地址。
往遠(yuǎn)程倉庫部署jar包的時候,需要認(rèn)證,配置認(rèn)證的方式為id,一定要與前面settings中server的id保持一致。
如果項(xiàng)目當(dāng)前的版本是快照版本,則部署到快照版本的倉庫地址,否則就部署到發(fā)布版本的倉庫地址,因?yàn)檫@里只是測試演示,前面只創(chuàng)建了Release版本的倉庫bbsid,所以省略了snapshotRepository。
配置正確后,定位到要上傳的項(xiàng)目目錄,運(yùn)行命令mvn clean deploy,Maven就會直接將項(xiàng)目打包生成的jar包部署到配置對應(yīng)的遠(yuǎn)程倉庫中。
2)上傳第三方j(luò)ar包到遠(yuǎn)程倉庫
方式一 (假設(shè)發(fā)布倉庫為bbsid,發(fā)布Jar包為zbb-sms-0.0.1.jar):
A. settings.xml中配置認(rèn)證信息。
B. 定位到要上傳的jar包的目錄,執(zhí)行“mvn deploy:deploy-file -DgroupId=com.zxp.test -DartifactId=sms -Dversion=1.0 -Dpackaging=jar -Dfile=zbb-sms-0.0.1.jar -Durl=http://127.0.0.1:8081/nexus/content/repositories/bbsid -DrepositoryId=bbsnexus”命令。
說明:deploy:deploy-file表示發(fā)布獨(dú)立的文件。
groupId、artifactId和version可根據(jù)需要設(shè)定。(我們要傳的包為zbb-sms-0.0.1.jar,但是命令里指定-Dversion=1.0,-DartifactId=sms,所以最終上傳到倉庫后的名稱為sms-1.0.jar)
url為Nexus服務(wù)器中需要上傳的倉庫路徑。
repositoryId與server的id必須一致。
上傳到倉庫中的結(jié)果如下圖示:
方式二 Nexus控制臺直接上傳jar包(假設(shè)發(fā)布倉庫為bbsid,發(fā)布Jar包為mysql-connector-java-5.1.43.jar):
在Repositories列表中選擇Releases,點(diǎn)Artifact Upload,指定GAV Definition為“GAV Parameters”,然后輸入相應(yīng)的groupId、artifactId和version、Packaging,再點(diǎn)擊“Select Artifact(s) to Upload...”選擇指定的Jar文件,點(diǎn)擊“Add ActifactId”添加到Actifacts框,最后點(diǎn)“Upload Artifact(s)”即可。
上傳到倉庫中的jar如下圖示:
參考文章:http://www.cnblogs.com/luotaoyeah/p/3791966.html
http://www.cnblogs.com/AlanLee/p/6198413.html
http://blog.csdn.net/wang379275614/article/details/43940259
總結(jié)
以上是生活随笔為你收集整理的Maven入门:使用Nexus搭建Maven私服及上传下载jar包的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 小米科技年货节惊喜来袭 多款健康科技好物
- 下一篇: 哈人!曝OPPO Find X6 Pro