掌握 Maven 私服

時間 2020-01-09

標籤掌握 maven 欄目 Maven 简体版

原文原文鏈接

前言

在 Java EE 開發中，咱們使用 Maven 構建工具主要來管理項目的第三方庫的依賴，以及公司內部其餘項目服務的依賴。所以 Maven 私服就是必不可少的一環，本文主要對 Maven 私服的三大方面進行介紹：docker

什麼是 Maven 私服
如何搭建 Maven 私服
如何使用 Maven 私服

本文面對的讀者應有 Maven 使用經驗，瞭解 Maven 的一些基本概念，若是不太熟悉能夠參見文末的參考資料學習。

什麼是 Maven 私服

在介紹 Maven 私服以前，咱們首先清楚下什麼是 Maven 倉庫。shell

Maven 倉庫：Maven 統一存儲全部Maven項目依賴，插件，以及所上傳項目的地方。segmentfault

而且 Maven 倉庫還分紅兩類：本地倉庫和遠程倉庫。緩存

本地倉庫，就是咱們本地電腦安裝Maven後，在配置文件 setting.xml 裏 localRepository 所須要指定目錄的那個文件夾。
遠程倉庫，就是在外部網絡裏（包括局域網）指定 URL 的專門存放 Java 庫，Maven插件等的服務器，，例如中央倉庫，就是一個典型的遠程倉庫，它包含了世界上絕大多數開源的 Java 庫，相似的還有許多其餘的公開庫

而本文提到的私服，就是另外一種特殊的遠程倉庫，它一般架設在局域網內的一臺服務器上，用於代理全部外部的遠程倉庫，而且能接受內部項目的上傳和獲取。安全

而這些倉庫又有是什麼用呢？當 Maven 項目須要依賴一些其餘項目的 Java 庫時，Maven 首先會在本地倉庫查找，若是存在對應的庫，就直接使用；若是本地倉庫不存在，Maven 就會去遠程倉庫查找，找到對應的 Java 庫後下載到本地倉庫再使用，以便於下次須要該Java庫時，直接使用緩存在本地倉庫的依賴庫便可，省去了重複經過網絡查找並下載的時間，對於 Maven 插件也是一樣的過程。服務器

一般狀況下，中央倉庫是Maven 默認的遠程倉庫，而當引入了私服後，本地倉庫查找結束未找到所須要的依賴庫時，就先從私服倉庫開始查找，仍未找到的話，最後再去中央倉庫查找，具體過程能夠參考下圖：網絡

在這裏咱們再看下私服的做用有哪些：架構

內網訪問，節省外網帶寬。
一次外網下載，內網全部用戶就能夠只下載私服緩存，加速 Maven 項目構建。
容許上傳和下載私有庫，而且不被外部訪問，更加安全。
減小外部網絡因素，提供項目構建的穩定性。
方便內部項目服務的依賴引用，而不須要其餘項目的完整源代碼。

這裏對最後一小點的做用添加下具體描述：當咱們有獨立的兩個Maven 項目，好比訂單服務項目和會員服務項目，其中訂單服務項目須要會員服務，依賴會員服務的 API 包，經過私服能夠將編譯後的會員服務的 API 包上傳，而後訂單服務程序直接下載引用私服上的會員服務 API 包便可，這樣就不須要導入會員服務項目代碼，也不用關心會員服務具體實現了，起到了內部服務項目輕度引用的做用，描述可參見下圖。maven

搭建 Maven 私服

瞭解 Maven 私服以後，咱們進一步學習。咱們首先來搭建一個 Maven 私服。在這裏咱們使用最流行的開源 Maven 倉庫管理軟件 - Nexus，來快速搭建 Maven 私服，傳統的搭建方式爲在 Nexus 官網上下載開源版的 Nexus OSS 進行安裝：https://www.sonatype.com/nexu...。而本文將採用 Docker 方式安裝 Nexus，不只快速簡單，而佔用更少的機器資源。微服務

若是對 Docker 不熟悉的同窗，能夠參見 10分鐘快速掌握Docker必備基礎知識學習瞭解下，簡單使用 Docker 也是十分容易的。

下載 Nexus 鏡像

在終端控制檯上使用 Docker 指令下載 Nexus 官方提供的Docker 鏡像：

看到下圖結果時，就表示鏡像下載完成，能夠經過 docker images 查看。

啓動 Nexus 容器

使用下方指令啓動 Nexus 容器：

在這裏對輸入的 Docker 指令的參數進行簡單的說明：

-d 表示讓容器後臺運行。
-p 8081:8081 表示了容器啓動時開放內部端口 8081（後者的8081）映射主機端口的 8081 ，即經過 localhost:8081 能夠訪問到 Nexus 容器所提供的服務。
-v /Users/One/Desktop/Nexus/nexus-data:/nexus-data 表示將容器內部 /var/nexus-data 掛載到當前主機的指定目錄，須要注意的是，-v 指定的外部路徑必須爲全路徑。
--restart=always 比較簡單，表示當 docker 服務啓動時，該容器也跟着啓動。

執行上述指令後，稍等片刻，訪問 http://localhost:8081/ ，看到對應的 Nexus 後臺就表示私服安裝完成了，是否是很簡單呢。

容器啓動過程當中，因爲機器配置的不一樣，可能會出現啓動慢的狀況，只需耐心等待便可。

啓動完成後，咱們能夠在所掛載的本機目錄下查看 Nexus 容器運行產生的文件。

配置 Maven 私服

私服安裝以後，咱們首先進行登陸操做，點擊頁面左上角的 Sign In 按鈕，就會出現和下圖同樣的提示：

說明了 Nexus 默認登陸帳號爲 admin，而且密碼位於文件 /nexus-data/admin.password 下，咱們只需在本地配置的掛載目錄下查看該文件便可。

輸入默認的帳號密碼以後成功登陸以後，Nexus 就會強制要求修改 admin 的密碼,而且設置基本訪問權限，完成以後就正式進入了 Nexus 私服後臺。

這裏簡單對界面元素進行介紹：

默認的瀏覽界面，能夠搜索查看倉庫的組件，以及進行上傳操做。
用於管理私服程序的配置。
帳戶信息查看，容許修改密碼。

進入私服程序的配置界面，咱們須要對默認配置進行幾點調整。

中央倉庫的代理路徑設置

將私服配置裏中央倉庫的代理倉庫路徑更新爲阿里雲倉庫提供的代理地址：https://maven.aliyun.com/repo... 這樣一來能夠更快速地訪問在中央倉庫上所須要的依賴和插件。

新建自定義的倉庫

點擊Create repository,而後選擇類型爲 maven2(hosted)

而後輸入倉庫名稱 private-release，並在 Version policy 一欄中選擇 Release，表示這個倉庫的存儲依賴爲正式發佈的組件，而後在 Deployment policy 一欄中選擇 Allow redeploy，容許部署和更新私服上的組件。

最後點擊藍色按鈕-Create repository 以後，就能夠在倉庫列表看到自定義的倉庫了，有了 release 倉庫，咱們再按照一樣方式操做添加一個 snapshot 倉庫，只需在 Version policy 一欄調整爲 Snapshot 便可。

添加角色

Nexus 默認只有兩種角色：nx-anonymous 和 nx-admin，前者只有瀏覽的權限，後者爲管理員權限，通常狀況下，咱們還須要正對開發人員建立個角色。點擊 Create Role，添加一個 Role ID 爲 developer 的自定義角色, 而且只添加自定義倉庫的使用權限，刪除操做除外。

保存以後，新增的角色就展現在列表中，有了角色，就能夠關聯用戶，進行權限分配了。

添加用戶

跟權限相似，默認的用戶只有兩種：admin 和 anonymous，咱們一樣須要建立屬於開發者的用戶對象。點擊 Create local user，填入用戶名，密碼等必填信息以後，關聯咱們先前的建立的角色，並保存便可。

用戶建立完成以後，咱們就能夠用新的用戶登陸私服，查看對應權限的內容了，例如咱們用新建的用戶登陸，所能操做的只有查看和搜索自定義的私服倉庫。

這樣一來咱們就建立好了本身的私服倉庫，配置完成以後，開發者就能夠在 Maven 項目開發中使用了。

使用 Maven 私服

有了私服和用於開發的帳號，咱們就須要在本地 Maven 配置文件 setting.xml 進行關聯。

設置 server 帳戶信息：

設置私服倉庫地址：（這裏的地址，能夠經過 Nexus 後臺上倉庫頁面的 cpoy 按鈕自動複製獲得）

Maven 項目部署到私服

配置完成後，咱們能夠建立一個Maven工程，嘗試下打包到 Maven 私服。利用 IDE 快速生成 Maven 項目，在 POM 文件添加 distributionManagement 節點，而且指定對應的私服倉庫 id 和地址，以下：

最後只要執行部署命令 mvn clean deploy 或者利用 IDE 的部署插件便可，當控制檯出現 BUILD SUCCESS ，以下圖相似時則說明部署完成。

從日誌上能夠看出，咱們的項目上傳都了 private- snapshot 倉庫下，此時咱們能夠在私服網站上的 private- snapshot 倉庫查看到上傳的 jar。

若是部署過程當中出現以下提示：帶有 Access denied to 則說明在 setting.xml 配置的用戶權限不足，沒法將 jar 部署到對應私服倉庫上去。

須要注意的是，對於一個Maven項目而言，若是項目的版本號中有「SNAPSHOT」字樣，則表示當前處於開發版本，Maven 會將發佈到 snapshotRepository 節點對應地址上去。不然，Maven則認爲這是一個發佈版本，將程序發佈到 repository 節點對應的地址上。因爲示例項目的版本爲 1.0.0-SNAPSHOT ，因此最終項目上傳到了 private-snapshot 這個 Snapshot 類型的倉庫下。

接下來若是其餘項目要依賴這個 jar 時，只須要在其 POM 文件引入對應的座標便可。