環(huán)境是:nexus-2.1.1、maven-3.0.4、jdk-1.6.0_32
一、用admin用戶登陸nexus
nexus的下載和安裝都很簡單,網(wǎng)上也有很多介紹,本文就不重復(fù)了。主要介紹一下安裝之后的配置
nexus的配置需要用admin角色完成,默認(rèn)的密碼是admin123,進(jìn)入nexus首頁之后,點(diǎn)擊右上角,進(jìn)行登錄
然后就可以在左邊的菜單中進(jìn)行配置了
二、為nexus配置代理服務(wù)器
由于這臺(tái)機(jī)器需要通過代理才能訪問外網(wǎng),所以首先要配置代理服務(wù)器,在Administration-->Server中進(jìn)行配置
配置之后,nexus才能連上central repository,如果私服所在機(jī)器可以直接上外網(wǎng),則可以省略這一步
三、配置repository
在Views/Repositories-->Repositories里進(jìn)行配置
nexus里可以配置3種類型的倉庫,分別是proxy、hosted、group
proxy是遠(yuǎn)程倉庫的代理。比如說在nexus中配置了一個(gè)central repository的proxy,當(dāng)用戶向這個(gè)proxy請(qǐng)求一個(gè)artifact,這個(gè)proxy就會(huì)先在本地查找,如果找不到的話,就會(huì)從遠(yuǎn)程倉庫下載,然后返回給用戶,相當(dāng)于起到一個(gè)中轉(zhuǎn)的作用
hosted是宿主倉庫,用戶可以把自己的一些構(gòu)件,deploy到hosted中,也可以手工上傳構(gòu)件到hosted里。比如說oracle的驅(qū)動(dòng)程序,ojdbc6.jar,在central repository是獲取不到的,就需要手工上傳到hosted里
group是倉庫組,在maven里沒有這個(gè)概念,是nexus特有的。目的是將上述多個(gè)倉庫聚合,對(duì)用戶暴露統(tǒng)一的地址,這樣用戶就不需要在pom中配置多個(gè)地址,只要統(tǒng)一配置group的地址就可以了
nexus裝好之后,已經(jīng)初始化定義了一些repository,我們熟悉之后,就可以自行刪除、新增、編輯
右邊那個(gè)Repository Path可以點(diǎn)擊進(jìn)去,看到倉庫中artifact列表。不過要注意瀏覽器緩存。我今天就發(fā)現(xiàn),明明構(gòu)件已經(jīng)更新了,在瀏覽器里卻看不到,還以為是BUG,其實(shí)是被瀏覽器緩存了
四、配置Central Repository的proxy
最關(guān)鍵的一個(gè)配置,可能就是Central Repository的proxy配置,因?yàn)榇蟛糠值臉?gòu)件,都是要通過這個(gè)proxy得到的
在安裝完nexus之后,這個(gè)proxy是預(yù)置的,需要做的就是把Download Remote Indexes改為true,這樣nexus才會(huì)從centralrepository下載索引,才能在nexus中使用artifact search的功能
網(wǎng)絡(luò)上有一些其他公開的maven倉庫,可以用同樣的辦法,在nexus中設(shè)置proxy,但是并不是所有maven倉庫,都提供了nexus index,這種情況下,就無法建立索引了
五、配置hosted repository
一般會(huì)配置3個(gè)hosted repository,分別是3rd party、Snapshots、Releases,分別用來保存第三方j(luò)ar(典型的比如ojdbc6.jar),項(xiàng)目組內(nèi)部的快照、項(xiàng)目組內(nèi)部的發(fā)布版
這里并沒有什么特別的配置,只是Deployment Policy這個(gè)選項(xiàng),一般Snapshots會(huì)配置成允許,而Releases和3rd party會(huì)設(shè)置為禁止
六、配置group repository
前面說過,group其實(shí)是一個(gè)虛擬的倉庫,通過對(duì)實(shí)體倉庫(proxy、hosted)進(jìn)行聚合,對(duì)外暴露一個(gè)統(tǒng)一的地址
這里要注意的是,放到左邊的倉庫,才是會(huì)被聚合的倉庫。我昨天一直搞錯(cuò)了,把倉庫都放到右邊,結(jié)果group什么都沒有聚合到,是一個(gè)空的倉庫。。。
七、配置用戶密碼
在Security-->Users中配置,在deployment用戶上點(diǎn)擊右鍵,選擇Set Password,然后設(shè)置一個(gè)密碼,做這個(gè)操作是為了后面提交做準(zhǔn)備
八、在用戶機(jī)器上配置settings.xml
經(jīng)過前面的7個(gè)步驟,nexus就配置好了,接下來需要在每個(gè)開發(fā)人員的開發(fā)機(jī)器上進(jìn)行配置了
配置文件在%USER_HOME%/.m2/settings.xml
Xml代碼
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
<servers>
<server>
<id>nexus-snapshots</id>
<username>deployment</username>
<password>deployment</password>
</server>
</servers>
<mirrors>
<mirror>
<id>nexus</id>
<name>internal nexus repository</name>
<url>http://10.78.68.122:9090/nexus-2.1.1/content/groups/public/</url>
<mirrorOf>central</mirrorOf>
</mirror>
</mirrors>
</settings>
這里只配置了2個(gè)元素<mirrors>和<servers>
首先這里配置了一個(gè)id為nexus的鏡像倉庫,地址是前面配置的public group的URL,然后鏡像目標(biāo)是central
maven里的超級(jí)pom,里面配置了這樣一段:
Xml代碼
<repositories>
<repository>
<id>central</id>
<name>Central Repository</name>
<url>http://repo.maven.apache.org/maven2</url>
<layout>default</layout>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>central</id>
<name>Central Repository</name>
<url>http://repo.maven.apache.org/maven2</url>
<layout>default</layout>
<snapshots>
<enabled>false</enabled>
</snapshots>
<releases>
<updatePolicy>never</updatePolicy>
</releases>
</pluginRepository>
</pluginRepositories>
因此,當(dāng)本地的maven項(xiàng)目,找不到需要的構(gòu)件(包括jar包和插件)的時(shí)候,默認(rèn)會(huì)到central里獲取
所以我們剛剛配置的鏡像倉庫,id也是central,這樣本地maven項(xiàng)目對(duì)central repository的請(qǐng)求,就會(huì)轉(zhuǎn)到鏡像倉庫上,也就是我們?cè)O(shè)置的nexus私服上
由于我們?cè)陧?xiàng)目的pom里,不會(huì)再配置其他的<repositories>和<pluginRepositories>元素,所以只要配置一個(gè)central的mirror,就足以阻止所有的外網(wǎng)訪問。如果pom中還配置了其他的外網(wǎng)倉庫,比如jboss repository等,可以把<mirrorOf>改為*
至于<servers>元素,是因?yàn)槲覀儼秧?xiàng)目內(nèi)部的構(gòu)件上傳到nexus的倉庫中時(shí),nexus會(huì)進(jìn)行權(quán)限控制,所以這里需要設(shè)置權(quán)限相關(guān)的信息。注意這里的<id>nexus-snapshotsid>,和后面maven工程里的pom設(shè)置是一致的
由于我們這里已經(jīng)屏蔽了對(duì)外網(wǎng)倉庫的請(qǐng)求,所以就不需要配置代理服務(wù)器了,如果需要配置代理服務(wù)器,可以用<proxies>元素
九、配置maven項(xiàng)目的pom文件
下面是簡化后的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/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.huawei.inoc.wfm.task</groupId>
<artifactId>task-sla</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>task-sla</name>
<!-- 配置部署的遠(yuǎn)程倉庫 -->
<distributionManagement>
<snapshotRepository>
<id>nexus-snapshots</id>
<name>nexus distribution snapshot repository</name>
<url>http://10.78.68.122:9090/nexus-2.1.1/content/repositories/snapshots/</url>
</snapshotRepository>
</distributionManagement>
</project>
這里配置了<distributionManagement>元素,其中的<id>nexus-snapshots</id>,與前面說的settings.xml中的<servers>元素中的配置必須一致
配置這個(gè)的目的,是當(dāng)執(zhí)行maven deploy時(shí),才知道要將生成的構(gòu)件部署到哪個(gè)遠(yuǎn)程倉庫上,注意這里的URL填的就不是public group的地址:
http://10.78.68.122:9090/nexus-2.1.1/content/groups/public/
而是snapshots的地址:
http://10.78.68.122:9090/nexus-2.1.1/content/repositories/snapshots/
但是在nexus中,snapshots也是聚合到public group里的,所以開發(fā)人員A提交到snapshots的構(gòu)件,開發(fā)人員B也可以從public group里獲取到
十、eclipse中的設(shè)置
經(jīng)過前面的配置,已經(jīng)可以通過命令行進(jìn)行maven操作了。不過實(shí)際開發(fā)中,一般都是使用eclipse的m2e插件,所以還需要對(duì)eclipse進(jìn)行一些額外的配置
在Preferences-->Maven-->User Settings中,點(diǎn)擊Update Settings,加載剛才我們對(duì)settings.xml的更改
然后在Maven Repositories視圖里,可以看到倉庫的情況
可以看到,從超級(jí)pom繼承來的central被置灰了,不可用,后面的mirrored by nexus表示對(duì)該倉庫的所有請(qǐng)求,都會(huì)轉(zhuǎn)到鏡像nexus中
十一、nexus的目錄結(jié)構(gòu)
nexus會(huì)安裝在%USER_HOME%/sonatype-work/nexus下,有以下目錄
其中的storage目錄,就是構(gòu)件實(shí)際存放的地址了