前言 在 Java EE 開發中，我們使用 Maven 構建工具主要來管理項目的第三方庫的依賴，以及公司內部其他項目服務的依賴。因此 Maven 私服就是必不可少的一環，本文主要對 Maven 私服的三大方面進行介紹： 什麼是 Maven 私服 如何搭建 Maven 私服 如何使用 Maven 私服 ...
前言
在 Java EE 開發中，我們使用 Maven 構建工具主要來管理項目的第三方庫的依賴，以及公司內部其他項目服務的依賴。因此 Maven 私服就是必不可少的一環，本文主要對 Maven 私服的三大方面進行介紹：
- 什麼是 Maven 私服
- 如何搭建 Maven 私服
- 如何使用 Maven 私服
本文面對的讀者應有 Maven 使用經驗，瞭解 Maven 的一些基本概念，如果不太熟悉可以參見文末的參考資料學習。
什麼是 Maven 私服
在介紹 Maven 私服之前，我們首先清楚下什麼是 Maven 倉庫。
Maven 倉庫：Maven 統一存儲所有Maven項目依賴，插件，以及所上傳項目的地方。
並且 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 倉庫管理軟體 - Nexus，來快速搭建 Maven 私服，傳統的搭建方式為在 Nexus 官網上下載開源版的 Nexus OSS 進行安裝：https://www.sonatype.com/nexus-repository-oss。而本文將採用 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/repository/central 這樣一來可以更快速地訪問在中央倉庫上所需要的依賴和插件。
新建自定義的倉庫
點擊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 文件引入對應的坐標即可。
將第三方 jar 包部署到 Maven 私服
這裡說到了第三方 jar 包，不是平常所提到的開源庫，更多的是來自其他第三方系統的 jar 包，由於項目需要，使用項目導入的方式來很不方便，更好的處理方式就是將第三方系統的 jar 包手動上傳到 Maven 私服上，需要使用的項目直接從私服倉庫中拉取即可。
這種方式實現起來也比較方便，分為兩種：可視化界面操作和命令行操作。
可視化界面操作：就是在 Nexus 後臺上進去，執行上傳操作必須要對於的上傳許可權才可以，一般都是管理員賬號進行操作，選擇倉庫後進去上傳頁面，指定本地需要上傳的項目，自定義完坐標信息保存即可。
命令行方式：直接在終端輸入下麵指令即可：
- -DgroupId 和 -DartifactId 構成了該jar包在 pom.xml 的坐標， 即對應依賴的
groupId和artifactId - -
Dfile表示需要上傳的jar包的絕對路徑 - -Durl 為私服倉庫的url精確地址
- -DrepositoryId 為私服倉庫定義的id
- -Dversion 指定了版本號
- -Dpackaging 指定了打包方式
當控制台日誌出現 BUILD SUCCESS 信息時則表示打包成功，如果出現打包失敗，很有可能是 Maven 配置文件里 server 元素下的用戶許可權不足導致，需要 Nexus 後臺對用戶角色進行上傳許可權的分配。
結語
在 Java 企業級項目開發中，建立並維護私服是使用 Maven 必不可少的一步，本文從 Maven 的簡單介紹，到快速搭建和使用來進一步掌握 Maven 私服，為後續的企業微服務架構做好鋪墊。
推薦閱讀
參考資料
- Maven入門，讀完這篇就夠了：https://juejin.im/post/5a4a5e2bf265da4322418d7f#heading-2
Maven 實戰：https://book.douban.com/subject/5345682/
- 私服 maven 倉庫命令上傳 jar 包： https://www.jianshu.com/p/ccd7b643624c
What is a Maven Repository：https://medium.com/@chris.shellenbarger/what-is-a-maven-repository-6fa22991fad9
