关于nexus3
Java开发者常在内网部署nexus3作为以下用途:
- 中央仓库的的缓存;
- 内网私有仓库;
接下来分别实战这两个功能;
环境信息
- nexus3版本:3.19.1
- maven版本:3.6.3
- JDK:1.8.0_191
nexus3的部署
本文聚焦nexus3的使用,不在此讨论部署的细节,推荐使用docker来部署,我这里是在一台家用NAS上通过docker部署的,详情可参考《群晖DS218+做maven私服(nexus3)》
新建仓库用作缓存
这里的中央仓库选用阿里云的,速度和稳定性都比较出色:
- 新建仓库的操作如下图:
- 在类型选择页面选中maven2(proxy),如下图红框:
- 接下来的页面只要填两处,名字:aliyun-proxy,remote storage:http://maven.aliyun.com/nexus/content/groups/public/ ,如下图红框:
- 提交表单后回到列表页面,在新增的仓库上点击copy按钮即可得到仓库地址,如下图:
- 记下这个仓库的地址(http://192.168.50.43:8081/repository/aliyun-proxy/),内网所有电脑都能从这里地址获取中央仓库jar包,设置方法后面会说到;
新建仓库用作私有仓库
对于中央仓库没有的jar,以及项目中发布的二方库,都可以存放到私有仓库;
- 再新建一个仓库,类型选择maven2(hosted),如下图红框:
- 名字:nexus-private,其他的不需要修改:
- 这里要注意的是,如果您创建的私有仓库用来保存自己发布的二方库,最好建两个,一个用来保存正式发布的,Version policy类型:Release,另一个保存开发中的(maven本地不缓存),Version policy类型是Snapshot,本文为了简单起见只建了一个Release类型的;
- 记下这个仓库的地址:http://192.168.50.43:8081/repository/nexus-private/
- 至此,仓库创建完毕,我们一共有以下两个仓库:
缓存型:http://192.168.50.43:8081/repository/aliyun-proxy/
本地私有型:http://192.168.50.43:8081/repository/nexus-private/ - 有了仓库,接下来设置开发环境上的Maven了;
Maven设置(使用缓存仓库)
先做aliyun-proxy仓库的设置,这样就可以使用nexus3的缓存功能了:
- 打开maven的配置文件settings.xml;
- 找到mirrors节点,增加一个server而配置,内容如下:
<mirror>
<id>aliyun-proxy</id>
<mirrorOf>*</mirrorOf>
<url>http://192.168.50.43:8081/repository/aliyun-proxy/</url>
</mirror>
- 缓存仓库的设置已经完成了,接下来通过构建maven工程验证一下,下面是个最简单的maven工程的pom.xml文件:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.bolingcavalry</groupId>
<artifactId>nexus3demo</artifactId>
<version>1.0-SNAPSHOT</version>
<dependencies>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.28</version>
</dependency>
</dependencies>
</project>
- 在pom.xml所在目录执行命令:mvn clean compile -U -DskipTests ,如下图,可见是通过nexus3下载中央仓库的jar,然后项目构建成功:
中央仓库不存在的jar
私有仓库的一个重要功能,就是提供中央仓库之外的jar下载,接下来举个例子:
- 在pom.xml中添加一个中央仓库不存在的jar:
<dependency>
<groupId>io.confluent</groupId>
<artifactId>kafka-schema-registry-client</artifactId>
<version>3.3.1</version>
</dependency>
- 再去构建就会报错:
上述问题是常见的,有的jar没有发布到中央仓库,用maven构建时找不到就报错了。
上传jar到私有仓库
解决上述问题的思路:找到这个jar -> 上传到私有仓库 -> maven构建时从私有仓库下载这个jar;
- 思路有了,现在来试着用私有仓库解决上面的问题;
- 把上述jar下载到本地,下载地址:http://packages.confluent.io/maven/io/confluent/kafka-schema-registry-client/3.3.1/kafka-schema-registry-client-3.3.1.jar
- 登录nexus3,按照如下步骤操作:
- 填写表单,按照下图步骤操作,把jar文件提交到nexus3:
- 现在私有仓库中已经有jar了,接下来看看maven如何使用这个jar文件;
maven使用私有仓库
- 打开maven的配置文件settings.xml;
- 找到profiles节点,增加一个profile的配置,内容如下:
- 找到activeProfiles节点,增加一个activeProfile而配置,内容如下:
<activeProfile>nexus3</activeProfile>
- 找到刚才新增的mirror,修改其mirrorOf节点的值,修改后的mirror节点值如下:
<mirror>
<id>aliyun-proxy</id>
<mirrorOf>external:local-nexus3</mirrorOf>
<url>http://192.168.50.43:8081/repository/aliyun-proxy/</url>
</mirror>
- mirrorOf的值从之前的*改成external:local-nexus3,是做了转发逻辑的排除操作,这样做了之后,local-nexus3仓库的请求会转发到私有仓库,而其他所有的请求都转发到了缓存仓库aliyun-proxy;
- 再次构建刚才的maven项目,这次终于构建成功了,如下图,kafka-schema-registry-client相关的数据都从私有仓库下载:
至此,nexus3常用的缓存和私有仓库功能都尝试过了,如果您正在搭建私有maven仓库,希望本文能够给您提供参考。