Nexus倉庫操作手冊

1、Nexus倉庫操作手冊目錄1NEXUS倉庫11.1安裝Nexus11.2倉庫簡介和配置31.3新建倉庫62添加第三方JAR包和MAVEN插件文件82.1通過web系統(tǒng)的管理界面添加82.2拷貝文件的方式92.3查看上傳的文件121 Nexus倉庫1.1 安裝NexusNexus提供了兩種安裝方式，第一種是內(nèi)嵌Jetty的bundle，解壓到安裝目錄中就能直接運(yùn)行；第二種方式是WAR，將其發(fā)布到web容器中即可使用。Nexus要求jdk版本為1.7(若版本不對，請調(diào)整環(huán)境變量JAVA_HOME指向jdk1.7的目錄)。本項(xiàng)目選擇的是第一種安裝方式，下載完nexus之后，將壓縮包解壓到你想要安裝的

2、目錄即可。解壓完成后，會得到如下兩個(gè)子目錄(例如Nexus版本為2.7.0)：l nexus-2.7.0-06/：該目錄包含了Nexus運(yùn)行所需要的文件，如啟動腳本，依賴jar包等。l sonatype-work/：該目錄包含了Nexus生成的配置文件，日志文件，倉庫文件等。用戶只需調(diào)用對應(yīng)操作系統(tǒng)的腳本就可以啟動Nexus，本文主要介紹主流的Windows和Linux平臺上的啟動方式，詳細(xì)信息如下：Ø Windows系統(tǒng)：1. 用戶需要進(jìn)入到nexus-2.7.0-06/bin/jsw/目錄，根據(jù)操作系統(tǒng)類型選擇文件夾，進(jìn)入后雙擊里面的console-nexus.bat啟動Nexu

3、s 。要停止服務(wù)，可以在命令行按：Ctrl+C鍵。例如，Win7 64位系統(tǒng)，選擇windows-x86-64中的console-nexus.bat啟動Nexus。2. 在nexus-2.7.0-06/bin/jsw/windows-x86-64中還有其他的一些腳本：² install-nexus.bat：將Nexus安裝成Windows服務(wù)；² uninstall-nexus.bat：卸載Nexus Windows服務(wù)；² start-nexus.bat：啟動Nexus Windows服務(wù)；² stop-nexus.bat：停止Nexus Window

4、s服務(wù)；Ø Linux系統(tǒng)：1. 用戶需要進(jìn)入到nexus-2.7.0-06/bin/jsw/目錄，根據(jù)操作系統(tǒng)類型選擇文件夾，進(jìn)入后然后運(yùn)行如下命令：$ ./nexus console。如果需要停止Nexus，可以使用Ctrl+C 鍵。例如：Ubuntu32位系統(tǒng)，只需進(jìn)入到nexus-2.7.0-06/bin/jsw/linux-x86-32/，然后運(yùn)行上面的命令即可。2. 除console之外，Nexus的Linux腳本還提供如下的命令：² ./nexus start：啟動后臺Neuxs服務(wù)；² ./nexus stop：停止后臺Neuxs服務(wù)；²

5、 ./nexus status：查看后臺Nexus服務(wù)的狀態(tài)；² ./nexus restart：重新啟動后臺Nexus服務(wù)；啟動完畢后，可以訪問Nexus系統(tǒng)，訪問地址：http:/localhost:8081/nexus/，默認(rèn)用戶名/密碼：admin/admin123。關(guān)于Bundle安裝的一個(gè)常見問題是端口沖突。Nexus Bundle默認(rèn)端口是8081，若端口已被占用或希望使用其他端口開放Nexus服務(wù)，可以編輯文件nexus-2.7.0-06/conf/perties，找到屬性application-port將默認(rèn)值8081改成其他端口號，然后保存該文件

6、，重啟Nexus即可。Nexus倉庫初始頁面，如下圖所示：1.2 倉庫簡介和配置1.2.1 Nexus目錄結(jié)構(gòu)Nexus倉庫初始頁面如上圖所示，主要信息如下：一、 左側(cè)包含多個(gè)菜單，主要使用有以下兩個(gè)菜單：1、 “Repositories”，點(diǎn)擊后顯示所包含的所有倉庫信息；2、 “Advanced Search”，點(diǎn)擊后進(jìn)入搜索頁面，可根據(jù)關(guān)鍵字搜索jar等；二、 點(diǎn)擊“Repositories”后，顯示所有的倉庫信息，倉庫類型包含：l Hosted：本地倉庫，可部署自己的構(gòu)件到這類型的倉庫。比如公司的第二方庫；l Proxy：代理倉庫，被用來代理遠(yuǎn)程的公共倉庫，如maven中央倉庫；l Gr

7、oup：倉庫組，用來合并多個(gè)hosted/proxy倉庫，當(dāng)項(xiàng)目需要引用多個(gè)repository資源時(shí)，只需要將這些資源放到一個(gè)group中，引用這一個(gè)group即可；三、 Nexus中自帶的倉庫：1) Maven central是Maven的中央倉庫；2) central是一個(gè)代理倉庫；3) Releases是用來存放自己項(xiàng)目中發(fā)布的構(gòu)建, 通常是Release版本的；4) Snapshots是發(fā)布那些非release版本, 非穩(wěn)定版本；5) 3rd Party是一個(gè)第三方庫,可以添加自己的第三方庫；四、 Maven 倉庫組：倉庫組,即將多個(gè)倉庫劃分組管理。當(dāng)需要引用多個(gè)倉庫時(shí)候，若將這些倉

8、庫加入到一個(gè)倉庫組中，那么在setting.xml中，只需要引用這個(gè)倉庫組即可。Nexus中預(yù)設(shè)了2個(gè)倉庫組：public repositories和public snapshot repositories。倉庫組默認(rèn)包含本地倉庫Releases, snapshots, 3rd party和代理倉庫Maven Central。可在Configuration配置頁添加倉庫到這個(gè)倉庫組。1.2.2 在Maven 中使用Nexus為了能讓本機(jī)所有的Maven項(xiàng)目都使用Nexus本地倉庫，需要對settings.xml文件進(jìn)行修改,但setting.xml并不支持直接配置repositories和pl

9、uginRepositories，因此需要使用Maven提供的Profile機(jī)制，將倉庫配置放到setting.xml中的Profile中。代碼清單如下:該配置中使用了一個(gè)id為dev的profile，這個(gè)profile包含了相關(guān)的倉庫配置，同時(shí)配置中又使用activeProfile元素將dev這個(gè)profile激活，這樣當(dāng)執(zhí)行maven構(gòu)建的時(shí)候，激活后的profile會將倉庫配置應(yīng)用到項(xiàng)目中去。repositories和pluginRepositories標(biāo)簽分別是倉庫及插件倉庫配置，它們的id都為nexus，url指向倉庫訪問地址，如下圖所示。配置倉庫及插件倉庫的目的是開啟對快照版本下載

10、的支持，當(dāng)maven需要下載發(fā)布版或快照版構(gòu)件的時(shí)候，它會首先檢查nexus，看該類型的構(gòu)件是否支持。Setting.mxl配置參數(shù)中的倉庫訪問url1.2.3 在項(xiàng)目中使用nexus查找依賴包在項(xiàng)目中需要查找nexus倉庫中的jar包，步驟如下：Ø 登陸到nexus的web管理頁面，選擇左側(cè)的“Advanced Search”進(jìn)入到搜索頁面，如下圖：Ø 在上圖中的搜索框中，輸入jar包的名稱，點(diǎn)擊搜索，會列出查詢結(jié)果列表，選擇某一個(gè)結(jié)果，則會在最下面顯示它的具體信息，如下圖：Ø 選到自己所需的jar后，選擇上圖右下角區(qū)域的tab選項(xiàng)“Maven”按鈕，將XML對

11、應(yīng)的文本框內(nèi)容復(fù)制粘貼到項(xiàng)目的pom.xml文件中< dependencies></ dependencies>標(biāo)簽中即可。如下圖：1.2.4 部署編譯完成的jar到Nexus倉庫在使用maven過程中，我們在開發(fā)階段經(jīng)常性的會有很多公共庫處于不穩(wěn)定狀態(tài)，隨時(shí)需要修改并發(fā)布，這時(shí)可以利用Nexus對不同狀態(tài)的版本進(jìn)行管理。Nexus倉庫包含兩種，snapshot快照倉庫和release發(fā)布倉庫。snapshot快照倉庫用于保存開發(fā)過程中的不穩(wěn)定版本，release正式倉庫則是用來保存穩(wěn)定的發(fā)行版本。項(xiàng)目中使用maven過程中，maven2會根據(jù)模塊的版本號(pom文件中

12、的version)中是否帶有-SNAPSHOT來判斷是快照版本還是正式版本。如果是快照版本，那么在 mvn deploy時(shí)會自動發(fā)布到快照版本庫中；如果是正式發(fā)布版本，那么在mvn deploy時(shí)會自動發(fā)布到正式版本庫中。具體操作步驟如下：1. 在maven的setting.xml增加認(rèn)證信息，認(rèn)證信息包含：對應(yīng)倉庫的id，登錄用戶名/密碼，如下圖：2. 在項(xiàng)目的pom.xml增加認(rèn)證信息，認(rèn)證信息包含：對應(yīng)倉庫的id，name,url，注：server 的id要與repository的id保持一致。如下圖：3. 修改好配置后，執(zhí)行下maven的 deploy 即可把新的 jar 部署到Nex

13、us上。1.3 新建倉庫根據(jù)項(xiàng)目的需求，可自定義多個(gè)倉庫。操作步驟如下：1) 點(diǎn)擊“Repositories”進(jìn)入倉庫信息頁面，顯示所有的倉庫信息，同時(shí)可對倉庫進(jìn)行新增、刪除、更新索引、修改信息等操作。如下圖：2) 點(diǎn)擊“+”號按鈕，選擇倉庫類型:group，新增public-maven-plugin-repositories倉庫，填寫配置參數(shù)，然后點(diǎn)擊保存即可。具體配置信息如下：3) 點(diǎn)擊“+”號按鈕，選擇倉庫類型:hosted，新增maven-plugins倉庫，填寫配置參數(shù)，然后點(diǎn)擊保存即可。具體配置信息如下：2 添加第三方j(luò)ar包和Maven插件文件添加第三方j(luò)ar包和maven插件文

14、件有兩種方式：1：通過web系統(tǒng)的管理界面添加；2：直接拷貝文件夾放到對應(yīng)的Nexus倉庫的文件中；2.1 通過web系統(tǒng)的管理界面添加通過Nexus系統(tǒng)界面，向3rd Party第三方倉庫添加jar包，具體步驟如下：1、 編寫pom.xml文件，需要填寫jar的坐標(biāo)信息，例如要上傳pager-taglib.jar，pom內(nèi)容如下：2、 點(diǎn)擊“Repositories”進(jìn)入倉庫信息顯示頁面，選中“3rd Party”，并在最下面的Tab框中選擇“Artifact Upload”，顯示頁面如下：3、 在上圖所示的頁面中，需要進(jìn)行以下操作：第一步，“GAV Defintion”下拉框選擇：“Fro

15、m POM”；第二步，選擇“Select POM to Upload”按鈕，選擇已填好的pom文件上傳到本系統(tǒng)；第三步，點(diǎn)擊“Select Atrifact(s) to Upload”按鈕，將所需要上傳的jar包上傳到本系統(tǒng)，當(dāng)上傳完畢后，會自動填充Filename,Classifiler,Extension三個(gè)輸入框；第四步， 點(diǎn)擊“Add Atrifact”按鈕，會生成信息填充到Atrifact文本框中，如下圖所示：第五步，點(diǎn)擊“Upload Atrifact(s)”按鈕，上傳jar包到第三方庫。2.2 拷貝文件的方式2.2.1 Maven插件文件Nexus中用來存放插件文件的倉庫是mav

16、en_plugins倉庫，若Nexus安裝路徑為：D: SOFT/Nexus/,則maven_plugins倉庫所在的文件路徑：D:SOFT/Nexus/sonatype-work/nexus/storage/maven-plugins由于每個(gè)maven插件都有唯一的坐標(biāo)信息，因此插件文件需要嚴(yán)格按照自己的坐標(biāo)信息來選擇對應(yīng)的文件目錄存放。maven插件的完整存放路徑為：maven_plugins倉庫文件目錄 / 插件坐標(biāo)信息對應(yīng)的文件目錄。例如，上傳maven-scm-plugin插件，具體的操作步驟如下：1. 查看maven-scm-plugin插件的坐標(biāo)信息，打開maven-scm-pl

17、ugin文件夾并選擇進(jìn)入1.7文件夾(1.7表示：該插件的1.7版本，若存在多個(gè)版本，任意選擇一個(gè)打開進(jìn)入即可)，然后查看里面的maven-scm-plugin-1.7.pom文件。該pom文件中包含有插件的坐標(biāo)信息，如groupId，artifactId，version等信息。查看插件坐標(biāo)信息的操作如下圖所示：2. 使用文本編輯器打開maven-scm-plugin-1.7.pom，找到/project/groupId的屬性值，該屬性值信息與插件的存放目錄相映射。例如：maven-scm-plugin插件的groupId的屬性值為：org.apache.maven.plugins，則對應(yīng)的文

18、件存放目錄：org/apache/maven/plugins/，那么該插件的完整存放路徑為：D:/SOFT/Nexus/sonatype-work/nexus/storage/maven_plugins/org/apache/maven/plugins/pom.xml中的信息如圖所示：3. 根據(jù)第2步操作得到的插件文件存放路徑，進(jìn)入并打開該路徑下的最后一層文件夾。若不存在該文件夾，則需要按照該路徑的目錄層級結(jié)構(gòu)手動創(chuàng)建缺少的目錄文件。該路徑下的最后一層文件夾信息如下圖所示：4. 將需要上傳的插件：maven-scm-plugin整個(gè)文件夾內(nèi)容全部拷貝到第3步操作所打開的文件夾中。若插件文件已存在，則選擇合并文件夾操作。插件文件上傳完畢后，需要更新Nexus的索引信息，具體操作參考2.2.3。2.2.2 jar文件nexus倉庫存放jar文件的路徑，例如安裝路徑為D:nexus-2.11.1-01-bundle/,則存放jar文件的路徑如下：D:nexus-2.11.1-01-bundle/sonatype-work/nexus/storage/thirdparty/進(jìn)入到以上的目錄文件中后，將需要上傳的jar文件拷貝進(jìn)去即可。(注意：盡量不要將 plugins文件復(fù)制進(jìn)去)2.2.3 更新索引將所有的maven插件文件和jar文件都復(fù)制完畢后，需要更新倉庫的索引信息。