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提供了兩種安裝方式，第一種是內嵌Jetty的bundle，解壓到安裝目錄中就能直接運行；第二種方式是WAR，將其發(fā)布到web容器中即可使用。Nexus要求jdk版本為1.7(若版本不對，請調整環(huán)境變量JAVA_HOME指向jdk1.7的目錄)。本項目選擇的是第一種安裝方式，下載完nexus之后，將壓縮包解壓到你想要安裝的

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

3、s 。要停止服務，可以在命令行按：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服務；² uninstall-nexus.bat：卸載Nexus Windows服務；² start-nexus.bat：啟動Nexus Windows服務；² stop-nexus.bat：停止Nexus Window

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

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

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

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

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

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

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

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

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

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

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

15、m POM”；第二步，選擇“Select POM to Upload”按鈕，選擇已填好的pom文件上傳到本系統(tǒng)；第三步，點擊“Select Atrifact(s) to Upload”按鈕，將所需要上傳的jar包上傳到本系統(tǒng)，當上傳完畢后，會自動填充Filename,Classifiler,Extension三個輸入框；第四步， 點擊“Add Atrifact”按鈕，會生成信息填充到Atrifact文本框中，如下圖所示：第五步，點擊“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由于每個maven插件都有唯一的坐標信息，因此插件文件需要嚴格按照自己的坐標信息來選擇對應的文件目錄存放。maven插件的完整存放路徑為：maven_plugins倉庫文件目錄 / 插件坐標信息對應的文件目錄。例如，上傳maven-scm-plugin插件，具體的操作步驟如下：1. 查看maven-scm-plugin插件的坐標信息，打開maven-scm-pl

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

18、件存放目錄：org/apache/maven/plugins/，那么該插件的完整存放路徑為：D:/SOFT/Nexus/sonatype-work/nexus/storage/maven_plugins/org/apache/maven/plugins/pom.xml中的信息如圖所示：3. 根據(jù)第2步操作得到的插件文件存放路徑，進入并打開該路徑下的最后一層文件夾。若不存在該文件夾，則需要按照該路徑的目錄層級結構手動創(chuàng)建缺少的目錄文件。該路徑下的最后一層文件夾信息如下圖所示：4. 將需要上傳的插件：maven-scm-plugin整個文件夾內容全部拷貝到第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/進入到以上的目錄文件中后，將需要上傳的jar文件拷貝進去即可。(注意：盡量不要將 plugins文件復制進去)2.2.3 更新索引將所有的maven插件文件和jar文件都復制完畢后，需要更新倉庫的索引信息。