Cpp五条

这个屌丝很懒，什么也没留下！

热门标签

Maven私服仓库配置-Nexus详解_nexus maven

作者：Cpp五条 | 2024-02-21 15:24:15

踩

nexus maven

一、什么是Maven私服？

Maven 私服是一种特殊的Maven远程仓库，它是架设在局域网内的仓库服务，用来代理位于外部的远程仓库（中央仓库、其他远程公共仓库）。

当然也并不是说私服只能建立在局域网，也有很多公司会直接把私服部署到公网，具体还是得看公司业务的性质是否是保密的等等，因为局域网的话只能在公司用，部署到公网的话员工在家里也可以办公使用。

建立了 Maven 私服后，当局域网内的用户需要某个构件时，会按照如下顺序进行请求和下载。

请求本地仓库，若本地仓库不存在所需构件，则跳转到第 2 步；
请求 Maven 私服，将所需构件下载到本地仓库，若私服中不存在所需构件，则跳转到第 3 步。
请求外部的远程仓库，将所需构件下载并缓存到 Maven 私服，若外部远程仓库不存在所需构件，则 Maven 直接报错。

此外，一些无法从外部仓库下载到的构件，也能从本地上传到私服供其他人使用。

下图中展示了 Maven 私服的用途。

二、Maven 私服优势

Maven 私服具有以下 5 点优势：

节省外网带宽：大量对于外部远程仓库的重复请求，会消耗很大量的带宽，利用 Maven私服代理外部仓库后，能够消除对外部仓库的大量重复请求，降低外网带宽压力。
下载速度更快：Maven 私服位于局域网内，从私服下载构建更快更稳定。
便于部署第三方构件：有些构件是无法从任何一个远程仓库中获得的（例如，某公司或组织内部的私有构件、Oracle 的 JDBC 驱动等），建立私服之后，就可以将这些构件部署到私服中，供内部 Maven 项目使用。
提高项目的稳定性，增强对项目的控制：如果不建立私服，那么 Maven 项目的构件就高度依赖外部的远程仓库，若外部网络不稳定，则项目的构建过程也会变得不稳定。建立私服后，即使外部网络状况不佳甚至中断，只要私服中已经缓存了所需的构件，Maven 也能够正常运行。
此外，一些私服软件（如 Nexus）还提供了很多额外控制功能，例如，权限管理、RELEASE/SNAPSHOT 版本控制等，可以对仓库进行一些更加高级的控制。
降低中央仓库得负荷压力：由于私服会缓存中央仓库得构件，避免了很多对中央仓库的重复下载，降低了中央仓库的负荷。

三、Maven 私服搭建

能够帮助我们建立 Maven 私服的软件被称为 Maven 仓库管理器（Repository Manager），主要有以下 3 种：

Apache Archiva
JFrog Artifactory
Sonatype Nexus

其中，Sonatype Nexus 是当前最流行、使用最广泛的 Maven 仓库管理器。本篇文章也是重点讲解Sonatype Nexus。

关于nexus安装：https://blog.csdn.net/weixin_43888891/article/details/130675829

本篇直接基于nexus3最新版进行讲解！

四、Sonatype Nexus介绍

Nexus 的全称是 Nexus Repository Manager（Nexus 仓库管理器），是 Sonatype 公司的一个产品。Nexus 是一个强大的仓库管理器，极大地简化了内部仓库的维护和外部仓库的访问。Nexus 分为开源版和专业版，其中开源版足以满足大部分 Maven 用户的需求。

Nexus 开源版具有以下优点：

占用内存小（28 M 左右）
具有基于 ExtJs 得操作界面，用户体验较好
使用基于 Restlet 的完全 REST API
支持代理仓库、宿主仓库和仓库组
基于文件系统，不需要依赖数据库
支持仓库管理
支持构件搜索
支持在界面上上传构件

五、Nexus仓库属性和分类

这里我直接用的nexus最新版3.54.1版本。

点击左边导航栏中的 Repositories（仓库），可以看到 Nexus 自带的几个内置仓库，如下图所示。

在仓库列表中，每个仓库都具有一系列属性：

Type：仓库的类型，这里一共有三种
- proxy：用来代理远程公共仓库，如 Maven 中央仓库、JBoss 远程仓库。
- hosted：又称 Nexus 本地仓库，该仓库通常用来部署本地项目所产生的构件。 hosted 宿主仓库又分为：releases 和shapshots，分别表示依赖的版本的发行版、快照版。快照版依赖不能上传到发行版仓库，反之亦然。nexus做了限制。
- group：仓库组，用来聚合代理仓库和宿主仓库，为这些仓库提供统一的服务地址，以便 Maven 可以更加方便地获得这些仓库中的构件。
Format：仓库的格式有两种maven2、nuget。我们是搞java的，所以新建仓库一般都是选择的maven2格式。
Status：仓库的状态，只有在线状态才能被访问。
URL：仓库的路径。

为了更加直观的理解仓库组、代理仓库和宿主仓库的概念，我们通过下图展示它们的用途和区别。

由上图可知：

Maven 可以直接从宿主仓库中下载构件。
Maven 也可以从代理仓库中下载构件，代理仓库会从远程仓库下载并缓存构件。
Maven 还可以从仓库组中下载构件，仓库组会从其包含的宿主仓库和代理仓库中获取构件。

我们使用nexus私服，配置文件中配置的也就是仓库组地址，因为仓库组可以把代理仓库、宿主仓库聚合，这样就完美实现：从私服下载依赖，私服仓库找不到还能去代理仓库那找。找到了之后缓存到私服这样下次就能从私服直接获取了。

六、Nexus仓库配置以及创建仓库

刚安装好的nexus一共给我们创建了7个仓库（不同的nexus版本可能有一点差距），我们只需要关注Format为maven2的仓库即可，也就是一共有4个：

maven-central：该仓库用来代理 Maven 中央仓库，其策略为 Release，只会下载和缓存中央仓库中的发布版本的构件。
maven-releases：策略为 Release 的宿主仓库，用来部署公司或组织内部的发布版本构件。
maven-snapshots：策略为 Snapshot 的宿主仓库，用来部署公司或组织内部的快照版本构件。
maven-public：仓库组，默认聚合了以上三个仓库。

下面进行一个一个讲解：

（1）maven-central

我们也可以再新建一个代理仓库，然后代理到阿里云镜像地址。通过阿里云镜像下载依赖要比maven中央仓库快的多。

选择maven2 （proxy）

其他配置默认即可。然后代理地址写：
https://maven.aliyun.com/repository/public

（2）maven-public

maven-public仓库组就是将这几个仓库汇集到一块，然后项目使用nexus，不需要配置其他仓库的地址，只需要配置仓库组的地址即可。

（3）maven-releases

release仓库需要把这块改一下，设置为Allow redeploy代表允许我们对仓库中的依赖维护升级新版本，如果设置为disable redeploy意味着我们无法将升级版本上传上来。

七、Nexus配置用户角色

nexus预定了两个用户

admin：最高权限
1. 浏览仓库
2. 搜索仓库
3. 上传构建
4. 新建修改仓库
anonymous：没有默认密码，不可以登录管理平台，拥有的权限有如下：
1. 浏览仓库
2. 搜索仓库

在低的版本当中可能会有一个deployment角色，不知道为什么新的版本当中这个角色给取消了。

一般我们不建议maven当中直接去配置admin账户，因为admin账户有新增和删除仓库的权限，我们可以选择新增一个账户，只给这个账号赋予上传依赖和下载依赖的权限即可，由于nexus是用户角色制，所以新增账户前，首先我们需要新建一个角色。然后让角色只具备上传依赖和下载依赖的权限。然后再给用户赋予该角色权限。

（1）新增角色

Role ID和Role Name自定义即可。

具体的需要新增的权限如下：

在这里插入图片描述

别忘了右下角保存！

（2）新增用户，并指定该角色

这时候可以使用新账号登录测试一下，登录后会发现他没有设置的权限，这就是我们要的效果！

八、Maven SNAPSHOT(快照)

接下来我们可能会频繁接触SNAPSHOT版本，在这里我们先熟悉一下这个版本号。

在我们是实际开发的项目当中很少会定义beat 、alpha 这些里程碑版本，因为这些一般都是开源框架才会定义的，他代表了一个特殊的寓意，例如beat就是测试版本，而我们经常在开发中会定义SNAPSHOT版本。SNAPSHOT不同于里程碑版本，里程碑版本他也就是一个普通的版本名称，说白了只是用这些英文来代表这个版本的含义，而SNAPSHOT对于私服来说是有特殊功能的。

使用场景： 大型的应用软件通常由多个功能模块组成，这些模块有时候分别于不同的团队负责开发。假设有两个团队，他们分别负责项目中的 member-service（会员服务）和 user-service（用户服务）两个模块，且 member-service 需要依赖 user-service 项目。

基于以上假设，若 user-service 团队正在进行快节奏的 bug 修复及功能增强，会在短时间内高频率地更新代码以及发布版本。就会出现以下情况：

user-service 团队每次发布新版本更新代码时，都应该通知member-service团队。
member-service 团队则需要定期更新其 pom.xml 以获得最新的版本。

这样，势必会影响开发效率，甚至会影响项目的验收及投产。要解决这个问题，其实很简单，那就是使用 SNAPSHOT（快照）版本。

版本介绍： SNAPSHOT（快照）是一种特殊的版本，它表示当前开发进度的副本。与常规版本不同，快照版本的构件在发布时，Maven 会自动为它打上一个时间戳，有了这个时间戳后，当依赖该构件的项目进行构建时，Maven 就能从仓库中找到最新的 SNAPSHOT 版本文件。

默认情况下对于快照本本的构件，Maven 会每天从仓库中获取一次更新，用户也可以在任何 Maven 命令中使用 -U 参数强制 Maven 检查更新。命令如下：mvn clean package -U

SNAPSHOT 版本 VS RELEASE 版本

Maven 仓库分为两种，Snapshot 快照仓库和 Release 发行仓库。Snapshot 快照仓库用于保存开发过程中的不稳定 SNAPSHOT 版本，Release 发行仓库则用来保存稳定的 RELEASE 版本。Maven 会根据模块的版本号（pom.xml 文件中的 version 元素）中是否带有 -SNAPSHOT 来判断是 SNAPSHOT 版本还是正式 RELEASE 版本。带有 -SNAPSHOT 是SNAPSHOT（快照）版本，不带 -SNAPSHOT 的就是正式 RELEASE（发布）版本。

九、项目当中配置Nexus上传依赖

首先找到本地maven的setting.xml（在maven安装目录的conf目录下），打开后找到servers标签。加入以下内容

<servers>
    <!-- 这是配置访问私有仓库的用户名密码 -->
    <server>
      <!-- id标签可以随便填，只需要在servers中唯一即可，后面很多地方会使用该id -->
      <id>self-maven</id>
      <username>deplyment</username>
      <password>deplyment123</password>
    </server>
</servers>    
1
2
3
4
5
6
7
8
9

maven配置好了，接下来去maven项目中设置：

在你想上传的模块的pom文件中，写入：

<distributionManagement>
      <repository>
          <!--注意这个id一定要填写我们maven的setting.xml当中配置的id-->
          <id>self-maven</id>
          <url>http://ip:port/repository/maven-releases/</url>
      </repository>
      <snapshotRepository>
          <!--注意这个id一定要填写我们maven的setting.xml当中配置的id-->
          <id>self-maven</id>
          <url>http://ip:port/repository/maven-snapshots/</url>
      </snapshotRepository>
</distributionManagement>
1
2
3
4
5
6
7
8
9
10
11
12

distributionManagement：负责将指定的构件部署到 Nexus 指定的仓库中。
repository：代表上传release版本存储的仓库地址
snapshotRepository：代表上传snapshot版本存储的仓库地址
标签中的 id，就是上面我们配置的server id，maven会通过这个id去server中拿用户名密码去访问私服仓库。
标签中的url，就是对应仓库的地址：仓库的url复制即可，注意对应仓库，弄反了是传不上去的

会根据该模块的版本进行自动选择，如果你的版本号带有SNAPSHOT如：<version>0.0.1-SNAPSHOT</version>，那么会上传到SNAPSHOT仓库，release也是这个道理，如果版本号不存在这两个单词，如1.0.0，那么会选择release仓库上传。

（1）接下来我们进行测试，首先第一步准备一个不是web工程的项目，如下：

（2）然后进行以下步骤：

当然也可以直接运行maven命令：mvn clean deploy -DskipTests

（3）deploy执行完不报错的话就上传成功了。

（4）由于我的项目设置的是1.0-SNAPSHOT，也就是SNAPSHOT版本，所以他会自动上传到maven-snapshots仓库当中，如下：

十、项目当中配置Nexus下载依赖

接下来，配置本地maven。还是打开setting.xml，然后添加一个如下配置：

<profiles>
	<profile>
        <id>nexus</id>
        <!--声明一个或多个远程仓库  -->
		<repositories>
			<!-- 声明一个 Nexus 私服上的仓库  -->
			<repository>
				<!--仓库id,这个id就是上面配置的账号密码id  -->
				<id>self-maven</id>
				<!-- 仓库的名称 -->
				<name>nexus</name>
				<!--仓库的地址  -->
				<url>http://localhost:8081/repository/maven-public/</url>
				<!-- 是否开启该仓库的 release 版本下载支持 -->
				<releases>
					<enabled>true</enabled>
				</releases>
				<!-- 是否开启该仓库的 snapshot 版本下载支持 -->
				<snapshots>
					<enabled>true</enabled>
				</snapshots>
			</repository>
		</repositories>
		<!-- 声明一个或多个远程插件仓库 -->
		<pluginRepositories>
			<!--声明一个 Nexus 私服上的插件仓库  -->
			<pluginRepository>
				<!--插件仓库 id -->
				<id>self-maven</id>
				<!--插件仓库 名称 -->
				<name>nexus</name>
				<!-- 配置的插件仓库的地址 -->
				<url>http://localhost:8081/repository/maven-public/</url>
				<!-- 是否开启该插件仓库的 release 版本下载支持 -->
				<releases>
					<enabled>true</enabled>
				</releases>
				<!-- 是否开启该插件仓库的 snapshot 版本下载支持 -->
				<snapshots>
					<enabled>true</enabled>
				</snapshots>
			</pluginRepository>
		</pluginRepositories>
          <properties>
              <maven.compiler.source>1.8</maven.compiler.source>
              <maven.compiler.target>1.8</maven.compiler.target>
              <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
          </properties>
	<!-- 默认该profile生效 -->
          <activation>
              <activeByDefault>true</activeByDefault>
          </activation>
      </profile>
</profiles>       
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

以上配置中使用了一个 id 为 nexus 的 profile，这个 profile 中包含了与仓库相关的配置，同时配置中activeByDefault为true。当本机有 Maven 项目构建时，profile 中的仓库配置就会应用到项目中。配置当中的url就配置我们的仓库组地址即可：

（1）接下来进行测试下载依赖，首先让一个web工程引用该项目坐标

（2）紧接着我们需要找到本地maven仓库当中的introduce包给删除掉

根据坐标就可以在本地仓库找到进行删除，删除前要保证引用该依赖的工程不是启动状态，不然删除不了

（3）再次测试web工程看看能否获取到依赖，需要刷新该工程，让他再次去获取依赖。

（4）刷新过后查看仓库已经存在了该依赖jar，我们并没有手动去install该项目，那也就意味着他是通过私服进行下载的。

（5）假如缺少依赖，除了上面通过idea当中的刷新，也可以选择执行命令来下载依赖，mvn clean install的时候也会自动下载仓库当中缺少的依赖，通过下载依赖的信息我们可以知道他从哪个仓库进行下载依赖的：

Nexus 私服通常会与镜像（mirror）结合使用，使 Nexus 成为所有远程仓库的私服，这样不仅可以从 Nexus 中获取所有所需构件，还能将配置集中到 Nexus 私服中，简化 Maven 本身的配置。

我们可以创建一个匹配任何仓库的镜像，镜像的地址为 Nexus 中仓库的地址，这样 Maven 对于任何构件的下载请求都会被拦截跳转到 Nexus 私服中，在maven的setting.xml当中配置，其具体配置如下。

<mirrors>
    <mirror>
        <id>self-maven</id>
        <name>nexus name</name>
        <mirrorOf>*</mirrorOf>
        <url>http://localhost:8081/repository/maven-public/</url>
    </mirror>
</mirrors>
1
2
3
4
5
6
7
8

之前阿里的镜像可以注释了，添加的镜像标签解释：

id：之前server的id，访问仓库组也要拿用户名密码
mirrorOf：*代表所有的依赖都从私服找
url：就是仓库组的，还是去仓库组右边copy即可

这样的话项目就完全依赖于nexus仓库了，假如一旦nexus挂了，整个项目都没办法下载包了，这时候可以将镜像替换为阿里云，这样一来除了公司内部包无法下载，最起码中央仓库的包还是可以下载的。

<mirror>
    <id>alimaven</id>
    <name>aliyun maven</name>
    <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
    <mirrorOf>central</mirrorOf>
</mirror>
1
2
3
4
5
6

十一、测试SNAPSHOT版本

我们基于上面提到的introduce工程和demo工程再顺便测一下SNAPSHOT版本。一般SNAPSHOT版本是为了解决多个人同时开发所产生的问题，而我没有多台电脑，所以模拟起来也比较费劲。

（1）我们需要手动保留一份仓库当中修改前的代码。

（2）修改一下introduce工程，然后将该工程重新deploy到仓库。

（3）删除本地仓库的introduce工程，将刚刚备份的introduce1改为introduce。这时候introduce1的工程代码当中那个输出的还是1111111。

（4）看看demo工程通过mvn clean install -DskipTests -U（-U是强制更新）是否会更新

（5）成功更新了

十二、Nexus构件搜索

十三、手动上传构件

有些 Jar 文件（如 Oracle 的 JDBC 驱动）由于许可证等原因，无法存放在公开仓库中。此外，还有一些小型的开源项目，它们没有将自己的构件分发到公共仓库中，也没有维护自己的仓库，因此这些构件是无法从公共仓库中获得的。若 Maven 项目中需要这类构件，我们就需要将构件下载到本地，然后手动上传到 Nexus 私服。

（1）准备一个项目，版本号不要是SNAPSHOT版本的
（2）mvn clean install，进行打包