nexus資源庫(kù)使用手冊(cè)

1、nexus資源庫(kù)使用手冊(cè)作者：魏瑋本文主要描述的是如何在使用nexus進(jìn)行類(lèi)庫(kù)的管理，以及權(quán)限的管理安裝配置在hudson項(xiàng)目持續(xù)集成操作指南中有詳細(xì)描述，這里就不贅述了。類(lèi)庫(kù)查詢(xún)?cè)贋g覽器地址欄輸入 直接看到的就是類(lèi)庫(kù)搜索頁(yè)面，支持關(guān)鍵詞搜索，任何人都可以通過(guò)界面查詢(xún)。如果知道要查找的類(lèi)庫(kù)屬于哪個(gè)倉(cāng)庫(kù)(Repository),可以點(diǎn)擊頁(yè)面左側(cè)的點(diǎn)擊Repositories會(huì)顯示所有可用的倉(cāng)庫(kù)，選擇某1個(gè)倉(cāng)庫(kù)進(jìn)行搜索，瀏覽每個(gè)倉(cāng)庫(kù)有多個(gè)個(gè)選項(xiàng)卡Browse Storage：瀏覽、搜索Browse Index：瀏覽索引（一般不用管）Configuration：對(duì)于倉(cāng)庫(kù)的基本配置這里只能修改name

2、，倉(cāng)庫(kù)權(quán)限(release發(fā)布版本 snapshot快照版本)基本不改其它選項(xiàng)會(huì)在添加倉(cāng)庫(kù)的步驟中講到。Mirrors：鏡像服務(wù)器，用于該倉(cāng)庫(kù)正常訪(fǎng)問(wèn)時(shí)備份服務(wù)器（一般不用管）Summery：該資源倉(cāng)庫(kù)的摘要（一般不用管）Artifact Upload：將類(lèi)庫(kù)上傳到倉(cāng)庫(kù)中（重要）類(lèi)庫(kù)上傳步驟說(shuō)明首先需要選擇上傳的類(lèi)庫(kù)的定義方式，有2種一般選擇From POMGAV Parameters一般情況用GAV Parameters 上傳時(shí)填寫(xiě)參數(shù)表單，如果自定義了POM文件可以用第一種，這里著重說(shuō)GAV Parameters方式選擇“GAV Parameters”1 Group：組id,就是要填寫(xiě)這個(gè)

3、類(lèi)庫(kù)的groupid該groupid自動(dòng)生成的該類(lèi)庫(kù)的pom文件中，同時(shí)也會(huì)作為存儲(chǔ)這個(gè)類(lèi)庫(kù)的第1級(jí)目錄名稱(chēng)；1) 一般情況直接使用jar的名稱(chēng)即可(不包含版本號(hào))例：asm.jar，那么groupid填寫(xiě)asm即可1) 但是有一些類(lèi)庫(kù)是由一組相關(guān)的jar功能組成的例：commons-io.jar commons-lang.jar commons-logging.jar都是apache common組件，因此他們的group需要定義成一致的比如group都填寫(xiě)成：commonsPs:不要使用漢語(yǔ)拼音.2 Artifact:上傳的類(lèi)庫(kù)的標(biāo)識(shí)，一般也直接使用jar文件的名稱(chēng)即可(不包含版本號(hào))例：

4、ojdbc14.jar其Artifact就填寫(xiě)ojdbc14即可3 Version:類(lèi)庫(kù)版本，需要填寫(xiě)這個(gè)類(lèi)庫(kù)的準(zhǔn)確版本4 Packaging:選擇上傳的文件類(lèi)型，照實(shí)選擇即可，多為jar填寫(xiě)完后，就是選擇要上傳的文件，沒(méi)啥可說(shuō)每選擇一個(gè)文件后，點(diǎn)擊 就會(huì)把文件插入帶上傳列表中，可以添加多個(gè)文件統(tǒng)一上傳，不過(guò)考慮到性能消耗，不要一次添加過(guò)多文件，一般不要超過(guò)20個(gè)。添加完畢后，點(diǎn)擊頁(yè)面下方的的上傳按鈕即可。類(lèi)庫(kù)管理規(guī)范1 為了統(tǒng)一標(biāo)準(zhǔn)，最大限度避免重復(fù)上傳，第3方類(lèi)庫(kù)（公共類(lèi)褲腳）上傳權(quán)限統(tǒng)一控制，nexus原則上由測(cè)試部負(fù)責(zé)控制(admin權(quán)限、deploy權(quán)限)2 在確定當(dāng)前所需要的類(lèi)庫(kù)在

5、資源倉(cāng)庫(kù)中不存在，或者版本缺少的情況下(務(wù)必確認(rèn))，可以提供一份類(lèi)庫(kù)清單以及類(lèi)庫(kù)文件，發(fā)給測(cè)試部的接口人，由測(cè)試部進(jìn)行備案，并進(jìn)行上傳工作(需要發(fā)布者權(quán)限delopment)，在上傳前需要再次確認(rèn)倉(cāng)庫(kù)中并沒(méi)有存在相同的類(lèi)庫(kù)（測(cè)試部負(fù)責(zé)）。類(lèi)庫(kù)清單文件格式： <dependency> <groupId>commons</groupId> <artifactId>commons-io</artifactId> <version>1.2</version> </dependency> <depend

6、ency> <groupId>commons</groupId> <artifactId>commons-util</artifactId> <version>final</version> </dependency> <dependency> <groupId>concurrent</groupId> < groupId >concurrent</artifactId> <version></version> </

7、dependency> .其中g(shù)roupId、artifactId、version就分別對(duì)應(yīng)了上傳時(shí)要填寫(xiě)Group,Artifact,Version，該文件的格式與maven的依賴(lài)關(guān)系一致，在整理依賴(lài)關(guān)系時(shí)就可以直接得出這個(gè)清單，不會(huì)造成重復(fù)勞動(dòng)重要事項(xiàng)：對(duì)于倉(cāng)庫(kù)中不存在的類(lèi)庫(kù)，可以按照我們的規(guī)則自行指定；如果倉(cāng)庫(kù)中已存在該類(lèi)庫(kù)其他版本，則需要上傳的類(lèi)庫(kù)的groupId、artifactId必須與已上傳的資源保持一致；如果要上傳類(lèi)庫(kù)在倉(cāng)庫(kù)中并不存在，但是屬于1個(gè)組件的一部分，并且其他組成部分已經(jīng)上傳到倉(cāng)庫(kù)中，那么上傳時(shí)，需要保持與倉(cāng)庫(kù)中已上傳的其他部分保持相同的groupid總結(jié)：除非

8、太離譜的情況，否則務(wù)必要保證與已存在的資源保持一致性，哪怕錯(cuò)大家也要一起錯(cuò)，對(duì)于依賴(lài)資源，保持一致性非常重要，出了問(wèn)題也方便統(tǒng)一處理。對(duì)上傳類(lèi)庫(kù)與已存在的資源一致性檢查也需要測(cè)試部負(fù)責(zé)3 類(lèi)庫(kù)所有查詢(xún)，下載權(quán)限公開(kāi)，可以匿名訪(fǎng)問(wèn)4 每個(gè)部門(mén)都有自己的內(nèi)部項(xiàng)目，這些內(nèi)部項(xiàng)目也可以通過(guò)nexus進(jìn)行版本倉(cāng)庫(kù)管理，因此如果部門(mén)有需求，可以申請(qǐng)開(kāi)通部門(mén)內(nèi)部項(xiàng)目的倉(cāng)庫(kù)，一般包括發(fā)布版本(Release)與快照版本(Snapshot)2種版本的倉(cāng)庫(kù)(快照版本、發(fā)布版本的定義與應(yīng)用請(qǐng)參看hudson項(xiàng)目持續(xù)集成操作指南)a) 這個(gè)管理權(quán)限可以放開(kāi)給各部門(mén)（每個(gè)部門(mén)開(kāi)通單個(gè)賬號(hào)）；b) 建立倉(cāng)庫(kù)、開(kāi)通權(quán)限的工

9、作需要由測(cè)試部統(tǒng)一控制，備案；c) 類(lèi)庫(kù)管理方式與第3方類(lèi)庫(kù)保持一致。建立倉(cāng)庫(kù)、開(kāi)通權(quán)限的步驟在下面詳細(xì)說(shuō)明；添加新的倉(cāng)庫(kù)如何添加發(fā)布版本、快照版本的倉(cāng)庫(kù)呢？首先必須用倉(cāng)庫(kù)管理員的身份登錄，這時(shí)點(diǎn)擊右側(cè)時(shí)，除了顯示倉(cāng)庫(kù)列表外，還會(huì)出現(xiàn)操作選項(xiàng)點(diǎn)擊Add 即可進(jìn)入添加倉(cāng)庫(kù)的界面一般選擇第1個(gè)Hosted Repository然后填上寫(xiě)倉(cāng)庫(kù)的詳細(xì)信息Repository ID：倉(cāng)庫(kù)ID，發(fā)布版本的倉(cāng)庫(kù)：部門(mén)標(biāo)示-release快照版本版本的倉(cāng)庫(kù)：部門(mén)標(biāo)示-snapshotRepository Name：倉(cāng)庫(kù)名稱(chēng)，照實(shí)填寫(xiě)即可，與ID一樣也可以Provider：Maven2即可，暫時(shí)不會(huì)升級(jí)Repo

10、sitory Policy：如果是發(fā)布版本就選”Release”如果是快照版本就選”Snapshot”192.168.22.253上的目錄地址Override Local Storage Location：E:nexus-workstorage（與Repository ID相同的目錄,會(huì)自動(dòng)創(chuàng)建目錄）添加后的倉(cāng)庫(kù)會(huì)在Repository列表中顯示出來(lái)，可以刪除，或上傳類(lèi)庫(kù)，倉(cāng)庫(kù)中維護(hù)類(lèi)庫(kù)的流程與前面說(shuō)的一致。我們創(chuàng)建mmt-release、mmt-snapshot2個(gè)倉(cāng)庫(kù)，為了后面設(shè)置權(quán)限，以及方便管理，我們還需要?jiǎng)?chuàng)建一個(gè)倉(cāng)庫(kù)組包含著2個(gè)倉(cāng)庫(kù)還是Add 這次選擇Repository Group

11、Group ID：倉(cāng)庫(kù)組ID 使用部門(mén)標(biāo)示-repositoryGroup Name：倉(cāng)庫(kù)組如實(shí)填寫(xiě)，與倉(cāng)庫(kù)組ID保持一致也可Provider：maven2即可Pulish URL：True最后重要的是要把組包含的倉(cāng)庫(kù)加入到列表中，我們選擇mmt-release、mmt-snapshot添加到組中。管理權(quán)限創(chuàng)建各部門(mén)內(nèi)部倉(cāng)庫(kù)管理員賬號(hào)倉(cāng)庫(kù)管理員身份登錄點(diǎn)開(kāi)左側(cè)Security添加該部門(mén)倉(cāng)庫(kù)管理員的權(quán)限組該管理員權(quán)限限制只能管理本部門(mén)的倉(cāng)庫(kù)例：我們建立了mmt-release、mmt-snapshot的倉(cāng)庫(kù)那么mmt開(kāi)發(fā)部的倉(cāng)庫(kù)管理員只能有權(quán)限維護(hù)管理mmt-release、mmt-snapsh

12、ot這2個(gè)倉(cāng)庫(kù)點(diǎn)擊Privilages，出現(xiàn)添加權(quán)限頁(yè)面點(diǎn)擊AddName：權(quán)限組名稱(chēng)使用 倉(cāng)庫(kù)id-privilege例：剛才我們創(chuàng)建了mmt-release、mmt-snapshot因此分別添加這2個(gè)倉(cāng)庫(kù)的權(quán)限D(zhuǎn)escription：權(quán)限描述，如是填寫(xiě)即可（中文支持不太好，最好用英文）Repository：要?jiǎng)?chuàng)建權(quán)限的倉(cāng)庫(kù)，新建的倉(cāng)庫(kù)只需要?jiǎng)?chuàng)建1次，Repository Target：一般選擇Maven2即可點(diǎn)擊save后會(huì)執(zhí)行創(chuàng)建，創(chuàng)建完成后在權(quán)限列表中可以看到PS：列表是按照字母順序排序的添加倉(cāng)庫(kù)管理員角色點(diǎn)擊Roles出現(xiàn)角色管理頁(yè)面點(diǎn)擊 Add 選擇 Nexus RoleRole

13、Id：角色I(xiàn)D命名為 部門(mén)標(biāo)示-deployment-RoleName：與Role Id保持一致即可Description：如實(shí)填寫(xiě)即可（中文支持不太好，最好用英文）選擇權(quán)限這里需要添加的權(quán)限包括：Artifact Upload Search Repositriesmmt-release的read 、view、create、update、deletemmt-snapshot的read 、view、create、update、deletePS：左側(cè)權(quán)限列表其實(shí)很長(zhǎng)選中列表可以通過(guò)滾輪滾動(dòng)添加管理員用戶(hù)賬號(hào)點(diǎn)擊User添加用戶(hù)即可點(diǎn)擊Add添加新用戶(hù)選擇Nexus User即可User ID：用戶(hù)名推薦 部門(mén)標(biāo)示-deploymentName：相當(dāng)于姓名（中文支持不太好，最好用英文