掌握 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/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 私服后台。

这里简单对界面元素进行介绍：

1. 默认的浏览界面，能够搜索查看仓库的组件，以及进行上传操做。
2. 用于管理私服程序的配置。
3. 帐户信息查看，容许修改密码。

进入私服程序的配置界面，咱们须要对默认配置进行几点调整。

中央仓库的代理路径设置

将私服配置里中央仓库的代理仓库路径更新为阿里云仓库提供的代理地址：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 文件引入对应的坐标便可。

将第三方 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 私服，为后续的企业微服务架构作好铺垫。

推荐阅读

• 一文掌握 Spring Boot Profiles
• 如何优雅关闭 Spring Boot 应用
• 须要接口管理的你了解一下？
• Java 之 Lombok 必知必会
• Java 微服务新生代之 Nacos

参考资料

• Maven入门，读完这篇就够了：https://juejin.im/post/5a4a5e...
• Maven 实战：https://book.douban.com/subje...
• 私服 maven 仓库命令上传 jar 包： https://www.jianshu.com/p/ccd...
• What is a Maven Repository：https://medium.com/@chris.she...