Maven私服Nexus3.x環境構建操作記錄

散盡浮華發表於2016-12-20

 

Maven介紹
Apache Maven是一個創新的軟體專案管理和綜合工具。
Maven提供了一個基於專案物件模型(POM)檔案的新概念來管理專案的構建,可以從一箇中心資料片管理專案構建,報告和檔案。
Maven最強大的功能就是能夠自動下載專案依賴庫。
Maven提供了開發人員構建一個完整的生命週期框架。開發團隊可以自動完成專案的基礎工具建設,Maven使用標準的目錄結構和預設構建生命週期。
在多個開發團隊環境時,Maven可以設定按標準在非常短的時間裡完成配置工作。由於大部分專案的設定都很簡單,並且可重複使用,Maven讓開發人員的工作更輕鬆,同時建立報表,檢查,構建和測試自動化設定。
Maven專案的結構和內容在一個XML檔案中宣告,pom.xml 專案物件模型(POM),這是整個Maven系統的基本單元。

Maven提供了開發人員的方式來管理:
1)Builds
2)Documentation
3)Reporting
4)Dependencies
5)SCMs
6)Releases
7)Distribution
8)mailing list
概括地說,Maven簡化和標準化專案建設過程。處理編譯,分配,文件,團隊協作和其他任務的無縫連線。
Maven增加可重用性並負責建立相關的任務。
Maven最初設計,是以簡化Jakarta Turbine專案的建設。在幾個專案,每個專案包含了不同的Ant構建檔案。 JAR檢查到CVS。
Apache組織開發Maven可以建立多個專案,釋出專案資訊,專案部署,在幾個專案中JAR檔案提供團隊合作和幫助。

Maven主要目標是提供給開發人員:
1)專案是可重複使用,易維護,更容易理解的一個綜合模型。
2)外掛或互動的工具,這種宣告性的模式。

私服介紹
私服是指私有伺服器,是架設在區域網的一種特殊的遠端倉庫,目的是代理遠端倉庫及部署第三方構建。有了私服之後,當 Maven 需要下載構件時,直接請求私服,私服上存在則下載到本地倉庫;否則,私服請求外部的遠端倉庫,將構件下載到私服,再提供給本地倉庫下載。

Nexus介紹
Nexus是一個強大的Maven倉庫管理器,它極大地簡化了本地內部倉庫的維護和外部倉庫的訪問。
如果使用了公共的Maven倉庫伺服器,可以從Maven中央倉庫下載所需要的構件(Artifact),但這通常不是一個好的做法。
正常做法是在本地架設一個Maven倉庫伺服器,即利用Nexus私服可以只在一個地方就能夠完全控制訪問和部署在你所維護倉庫中的每個Artifact。
Nexus在代理遠端倉庫的同時維護本地倉庫,以降低中央倉庫的負荷,節省外網頻寬和時間,Nexus私服就可以滿足這樣的需要。
Nexus是一套“開箱即用”的系統不需要資料庫,它使用檔案系統加Lucene來組織資料。
Nexus使用ExtJS來開發介面,利用Restlet來提供完整的REST APIs,通過m2eclipse與Eclipse整合使用。
Nexus支援WebDAV與LDAP安全身份認證。
Nexus還提供了強大的倉庫管理功能,構件搜尋功能,它基於REST,友好的UI是一個extjs的REST客戶端,它佔用較少的記憶體,基於簡單檔案系統而非資料庫。

為什麼要構建Nexus私服?
如果沒有Nexus私服,我們所需的所有構件都需要通過maven的中央倉庫和第三方的Maven倉庫下載到本地,而一個團隊中的所有人都重複的從maven倉庫下載構件無疑加大了倉庫的負載和浪費了外網頻寬,如果網速慢的話,還會影響專案的程式。很多情況下專案的開發都是在內網進行的,連線不到maven倉庫怎麼辦呢?開發的公共構件怎麼讓其它專案使用?這個時候我們不得不為自己的團隊搭建屬於自己的maven私服,這樣既節省了網路頻寬也會加速專案搭建的程式,當然前提條件就是你的私服中擁有專案所需的所有構件。

總之,在本地構建nexus私服的好處有:
1)加速構建;
2)節省頻寬;
3)節省中央maven倉庫的頻寬;
4)穩定(應付一旦中央伺服器出問題的情況);
5)控制和審計;
6)能夠部署第三方構件;
7)可以建立本地內部倉庫;
8)可以建立公共倉庫
這些優點使得Nexus日趨成為最流行的Maven倉庫管理器。

Maven的安裝
下載地址:http://maven.apache.org/download.cgi
提前在伺服器上安裝jdk環境(參考:Centos中yum方式安裝java
[root@master-node ~]# cd /usr/local/src/
[root@master-node src]# wget http://mirrors.hust.edu.cn/apache/maven/maven-3/3.3.9/binaries/apache-maven-3.3.9-bin.tar.gz
[root@master-node src]# tar -zvxf apache-maven-3.3.9-bin.tar.gz
[root@master-node src]# mv apache-maven-3.3.9 /usr/local/maven

接著配置系統環境變數,在/etc/profile檔案底部新增如下內容:
[root@master-node src]# java -version
openjdk version "1.8.0_111"
OpenJDK Runtime Environment (build 1.8.0_111-b15)
OpenJDK 64-Bit Server VM (build 25.111-b15, mixed mode)
[root@master-node src]# vim /etc/profile
.....
export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk                                //java的環境變數設定
export CLASSPATH=.:$JAVA_HOME/jre/lib/rt.jar:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
export PATH=$PATH:$JAVA_HOME/bin

export MAVEN_HOME=/usr/local/maven                                                 //maven的環境變數設定
export PATH=$PATH:$MAVEN_HOME/bin
[root@master-node src]# source /etc/profile

最後驗證是否安裝成功,出現如下資訊,說明安裝成功
[root@master-node src]# mvn --version                   # 最好按照java jdk
Apache Maven 3.3.9 (bb52d8502b132ec0a5a3f4c09453c07478323dc5; 2015-11-11T00:41:47+08:00)
Maven home: /usr/local/maven
Java version: 1.8.0_111, vendor: Oracle Corporation
Java home: /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.111-2.b15.el7_3.x86_64/jre
Default locale: en_US, platform encoding: UTF-8
OS name: "linux", version: "3.10.0-327.el7.x86_64", arch: "amd64", family: "unix"

Nexus安裝
Nexus的安裝有兩種實現方式:
1)war包安裝方式
下載地址:https://sonatype-download.global.ssl.fastly.net/nexus/oss/nexus-2.14.2-01.war
直接將war包放在tomcat的根目錄下,啟動tomcat就可以用了

2)原始碼安裝方式(之前在用的是2.14.4版本,這裡是新版本)
下載地址:https://www.sonatype.com/download-oss-sonatype           (雲盤下載:http://pan.baidu.com/s/1miKFm5a
[root@master-node ~]# cd /usr/local/src/
[root@master-node src]# wget https://sonatype-download.global.ssl.fastly.net/nexus/3/nexus-3.2.0-01-unix.tar.gz
[root@master-node src]# tar -zvxf nexus-3.2.0-01-unix.tar.gz
[root@master-node src]# mv nexus-3.2.0-01 /usr/local/nexus

啟動nexus(預設埠是8081)
[root@master-node src]# /usr/local/nexus/bin/nexus
WARNING: ************************************************************
WARNING: Detected execution as "root" user. This is NOT recommended!
WARNING: ************************************************************
Usage: /usr/local/nexus/bin/nexus {start|stop|run|run-redirect|status|restart|force-reload}
[root@master-node src]# /usr/local/nexus/bin/nexus start
WARNING: ************************************************************
WARNING: Detected execution as "root" user. This is NOT recommended!
WARNING: ************************************************************
Starting nexus
上面在啟動過程中出現告警:不推薦使用root使用者啟動。這個告警不影響nexus的正常訪問和使用。
去掉上面WARNING的辦法:
[root@master-node src]# vim /etc/profile
......
export RUN_AS_USER=root
[root@master-node src]# source /etc/profile
[root@master-node src]# lsof -i:8081            //nexus服務啟動成功後,需要稍等一段時間,8081埠才起來
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
java 1486 root 859u IPv4 23504303 0t0 TCP *:tproxy (LISTEN)

在部署機上的iptables裡開啟8081埠
[root@master-node src]# vim /etc/sysconfig/iptables
....
-A INPUT -p tcp -m state --state NEW -m tcp --dport 8081 -j ACCEPT
[root@master-node src]# /etc/init.d/iptables restart

訪問nexus,即http://localhost:8081    (如果出現404,就訪問http://localhost:8081/nexus)

出現上述頁面,說明配置nexus成功!
點選右上角“Log in”,
輸入預設使用者名稱(admin)和預設密碼(admin123)登入

可以點選上面的“設定”圖示,在“設定”裡可以新增使用者、角色,對接LDAP等的設定,如下:

可以在“管理”裡檢視nexus的系統資訊

注意下面幾點說明:
1.component name的一些說明:
    1)maven-central:maven中央庫,預設從https://repo1.maven.org/maven2/拉取jar
    2)maven-releases:私庫發行版jar
    3)maven-snapshots:私庫快照(除錯版本)jar
    4)maven-public:倉庫分組,把上面三個倉庫組合在一起對外提供服務,在本地maven基礎配置settings.xml中使用。
2.Nexus預設的倉庫型別有以下四種:
    1)group(倉庫組型別):又叫組倉庫,用於方便開發人員自己設定的倉庫;
    2)hosted(宿主型別):內部專案的釋出倉庫(內部開發人員,釋出上去存放的倉庫);
    3)proxy(代理型別):從遠端中央倉庫中尋找資料的倉庫(可以點選對應的倉庫的Configuration頁簽下Remote Storage Location屬性的值即被代理的遠端倉庫的路徑);
    4)virtual(虛擬型別):虛擬倉庫(這個基本用不到,重點關注上面三個倉庫的使用);
3.Policy(策略):表示該倉庫為釋出(Release)版本倉庫還是快照(Snapshot)版本倉庫;
4.Public Repositories下的倉庫
   1)3rd party: 無法從公共倉庫獲得的第三方釋出版本的構件倉庫,即第三方依賴的倉庫,這個資料通常是由內部人員自行下載之後釋出上去;
   2)Apache Snapshots: 用了代理ApacheMaven倉庫快照版本的構件倉庫
   3)Central: 用來代理maven中央倉庫中釋出版本構件的倉庫
   4)Central M1 shadow: 用於提供中央倉庫中M1格式的釋出版本的構件映象倉庫
   5)Codehaus Snapshots: 用來代理CodehausMaven 倉庫的快照版本構件的倉庫
   6)Releases: 內部的模組中release模組的釋出倉庫,用來部署管理內部的釋出版本構件的宿主型別倉庫;release是釋出版本;
   7)Snapshots:釋出內部的SNAPSHOT模組的倉庫,用來部署管理內部的快照版本構件的宿主型別倉庫;snapshots是快照版本,也就是不穩定版本
所以自定義構建的倉庫組代理倉庫的順序為:Releases,Snapshots,3rd party,Central。也可以使用oschina放到Central前面,下載包會更快。
5.Nexus預設的埠是8081,可以在etc/nexus-default.properties配置中修改。
6.Nexus預設的使用者名稱密碼是admin/admin123
7.當遇到奇怪問題時,重啟nexus,重啟後web介面要1分鐘左右後才能訪問。
8.Nexus的工作目錄是sonatype-work(路徑一般在nexus同級目錄下)
[root@master-node local]# pwd
/usr/local
[root@master-node local]# ls nexus/
bin deploy etc lib LICENSE.txt NOTICE.txt public system
[root@master-node local]# ls sonatype-work/
nexus3
[root@master-node local]# ls sonatype-work/nexus3/
backup blobs cache db elasticsearch etc generated-bundles health-check instances keystores lock log orient port tmp

Nexus倉庫分類的概念:
1)Maven可直接從宿主倉庫下載構件,也可以從代理倉庫下載構件,而代理倉庫間接的從遠端倉庫下載並快取構件
2)為了方便,Maven可以從倉庫組下載構件,而倉庫組並沒有時間的內容(下圖中用虛線表示,它會轉向包含的宿主倉庫或者代理倉庫獲得實際構件的內容).

 

Nexus的web介面功能介紹

1.Browse Server Content

1.1  Search
這個就是類似Maven倉庫上的搜尋功能,就是從私服上查詢是否有哪些包。
注意:
1)在Search這級是支援模糊搜尋的,如圖所示:

2)如果進入具體的目錄,好像不支援模糊搜尋,如圖所示:

1.2  Browse

1)Assets
這是能看到所有的資源,包含Jar,已經對Jar的一些描述資訊。
2)Components
這裡只能看到Jar包。

2.Server Adminstration And configuration

看到這個選項的前提是要進行登入的,如上面已經介紹登陸方法,右上角點選“Sign In”的登入按鈕,輸入admin/admin123,登入成功之後,即可看到此功能,如圖所示:

2.1 Blob Stores
檔案儲存的地方,建立一個目錄的話,對應檔案系統的一個目錄,如圖所示:

2.2 Repositories

1)Proxy
這裡就是代理的意思,代理中央Maven倉庫,當PC訪問中央庫的時候,先通過Proxy下載到Nexus倉庫,然後再從Nexus倉庫下載到PC本地。
這樣的優勢只要其中一個人從中央庫下來了,以後大家都是從Nexus私服上進行下來,私服一般部署在內網,這樣大大節約的寬頻。
建立Proxy的具體步驟
1--點選“Create Repositories”按鈕

2--選擇要建立的型別

3--填寫詳細資訊
Name:就是為代理起個名字
Remote Storage: 代理的地址,Maven的地址為: https://repo1.maven.org/maven2/
Blob Store: 選擇代理下載包的存放路徑

2)Hosted
Hosted是宿主機的意思,就是怎麼把第三方的Jar放到私服上。
Hosted有三種方式,Releases、SNAPSHOT、Mixed
Releases: 一般是已經發布的Jar包
Snapshot: 未釋出的版本
Mixed:混合的
Hosted的建立和Proxy是一致的,具體步驟和上面基本一致。如下:

注意事項:
Deployment Pollcy: 需要把策略改成“Allow redeploy”。

3)Group
能把兩個倉庫合成一個倉庫來使用,目前沒使用過,所以沒做詳細的研究。

2.3 Security
這裡主要是使用者、角色、許可權的配置(上面已經提到了在這裡新增使用者和角色等)

2.4 Support
包含日誌及資料分析。

2.5 System
主要是郵件伺服器,排程的設定地方
這部分主要講怎麼和Maven做整合,整合的方式主要分以下種情況:代理中央倉庫、Snapshot包的管理、Release包的管理、第三方Jar上傳到Nexus上。

代理中央倉庫
只要在PMO檔案中配置私服的地址(比如http://192.168.1.14:8081)即可,配置如下:

<repositories>
        <repository>
            <id>maven-central</id>
            <name>maven-central</name>
            <url>http://192.168.1.14:8081/repository/maven-central/</url>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
            <releases>
                <enabled>true</enabled>
            </releases>
        </repository>
    </repositories>

Snapshot包的管理
1)修改Maven的settings.xml檔案,加入認證機制

<servers>
<server>
      <id>nexus</id>
      <username>admin</username>
      <password>admin123</password>
     </server>

2)修改工程的Pom檔案

<distributionManagement>
        <snapshotRepository>
            <id>nexus</id>
            <name>Nexus Snapshot</name>
            <url>http://192.168.1.14:8081/repository/maven-snapshots/</url>
        </snapshotRepository>
        <site>
            <id>nexus</id>
            <name>Nexus Sites</name>
            <url>dav:http://192.168.1.14:8081/repository/maven-snapshots/</url>
        </site>
    </distributionManagement>

注意事項:

上面修改的Pom檔案如截圖中的名字要跟/usr/local/maven/conf/settings.xml檔案中的名字一定要對應上。

3)上傳到Nexus上

1--專案編譯成的jar是Snapshot(POM檔案的頭部)

<groupId>com.woasis</groupId>
<artifactId>test-nexus</artifactId>
<version>1.0.0-<span style="color: #ff0000;">SHAPSHOT</span></version>
<packaging>jar</packaging>

2--使用mvn deploy命令執行即可(執行結果在此略過)

3--因為Snapshot是快照版本,預設他每次會把Jar加一個時間戳,做為歷史備份版本。

Releases包的管理

1)與Snapshot大同小異,只是上傳到私服上的Jar包不會自動帶時間戳
2)與Snapshot配置不同的地方,就是工程的PMO檔案,加入repository配置

<distributionManagement>
        <repository>
            <id>nexus</id>
            <name>Nexus Snapshot</name>
            <url>http://192.168.1.14:8081/repository/maven-releases/</url>
        </repository>

3)打包的時候需要把Snapshot去掉

<groupId>com.woasis</groupId>
    <artifactId>test-nexus</artifactId>
    <version>1.0.0</version>
<packaging>jar</packaging>

第三方Jar上傳到Nexus

[root@master-node src]# mvn deploy:deploy-file -DgroupId=org.jasig.cas.client -DartifactId=cas-client-core -Dversion=3.1.3 -Dpackag
注意事項:
-DrepositoryId=nexus 對應的就是Maven中settings.xml的認證配的名字。

相關文章