vlambda博客
学习文章列表

Maven私服Nexus安装与使用

Nexus介绍

Nexus是Maven仓库管理器,如果你使用Maven,你可以从Maven中央仓库下载所需要的构件(artifact),但这通常不是一个好的做法,你应该在本地架设一个Maven仓库服务器,在代理远程仓库的同时维护本地仓库,以节省带宽和时间,Nexus就可以满足这样的需要。此外,他还提供了强大的仓库管理功能,构件搜索功能,它基于REST,友好的UI是一个extjs的REST客户端,它占用较少的内存,基于简单文件系统而非数据库。这些优点使其日趋成为最流行的Maven仓库管理器。除此之外,Nexus还可以管理Docker镜像。

注:Maven简介可参考Maven简介


私服的好处

没有私服时:本地仓库没有,则去中央仓库下载

搭建私服后:本地仓库没有,再去私服下载,私服没有,再去中央仓库下载

  • 减少网络带宽流量

  • 加速Maven构建

  • 部署第三方构件

  • 提高稳定性、增强控制

  • 降低中央仓库的负载

使用Docker安装Nexus私服

注意:请先自行安装Docker

查找Nexus3镜像

docker search nexus3

拉取Nexus3镜像

docker pull sonatype/nexus3

注:最新版本的Nexus3.18在下载依赖时有点问题,建议安装3.17版本的Nexus

具体报错是这样的:Caused by: org.apache.maven.wagon.authorization.AuthorizationException: Not authorized


查看镜像

docker images


运行Nexus容器

#进入/opt目录,创建宿主机挂载目录并设置权限cd /optmkdir nexus-datachown -R 200 nexus-data#运行nuxus私服# -d:后台运行# -p:将容器内部端口向外映射,第一个参数是宿主机端口,第二个参数容器端口# --name:命名容器名称# --restart always在容器退出时总是重启容器# -v:将容器内配置、日志、数据文件等文件夹挂载到宿主机指定目录docker run -d --name nexus3 -p 8081:8081 --restart always -v /opt/nexus-data:/nexus-data sonatype/nexus3

如果没有设置权限,运行nexus时就会报如下错误

Warning: Cannot open log file: ../sonatype-work/nexus3/log/jvm.logWarning: Forcing option -XX:LogFile=/tmp/jvm.logUnable to update instance pid: Unable to create directory /nexus-data/instances/nexus-data/log/karaf.log (No such file or directory)Unable to update instance pid: Unable to create directory /nexus-data/instancesmkdir: cannot create directory '../sonatype-work/nexus3/log': Permission deniedmkdir: cannot create directory '../sonatype-work/nexus3/tmp': Permission deniedOpenJDK 64-Bit Server VM warning: Cannot open file ../sonatype-work/nexus3/log/jvm.log due to No such file or directory


登录Nexus

从3.17版本开始默认密码不再是admin123,密码是随机生成。首次登录页面会显示admin用户的密码在/nexus-data/admin.password

注意:我们刚才安装的时候把/nexus-data目录挂载到宿主机的/opt/nexus-data,所以密码在/opt/nexus-data/admin.password

执行命令vim /opt/nexus-data/admin.password,即可查看到如9c3ac7fb-4264-4457-8e48-4aa84c71e7ad这样的密码,然后登录即可。用户名:admin,密码:/opt/nexus-data/admin.password里面的密码


登录后会让用户设置新的密码。这里把用户名和密码设置为admin/admin123


登录后界面如下

Maven私服Nexus安装与使用

默认仓库说明

maven-central:maven中央库,默认从https://repo1.maven.org/maven2/拉取jarmaven-releases:私库发行版jar,初次安装请将Deployment policy设置为Allow redeploymaven-snapshots:私库快照(调试版本)jarmaven-public:仓库分组,把上面三个仓库组合在一起对外提供服务,在本地maven基础配置settings.xml或项目pom.xml中使用


仓库类型

Group:这是一个仓库聚合的概念,用户仓库地址选择Group的地址,即可访问Group中配置的,用于方便开发人员自己设定的仓库。maven-public就是一个Group类型的仓库,内部设置了多个仓库,访问顺序取决于配置顺序,3.x默认Releases,Snapshots,Central,当然你也可以自己设置。Hosted:私有仓库,内部项目的发布仓库,专门用来存储我们自己生成的jar文件3rd party:未发布到公网的第三方jar (3.x去除了)Snapshots:本地项目的快照仓库Releases:本地项目发布的正式版本Proxy:代理类型,从远程中央仓库中寻找数据的仓库(可以点击对应的仓库的Configuration页签下Remote Storage属性的值即被代理的远程仓库的路径),如可配置阿里云maven仓库Central:中央仓库Apache Snapshots:Apache专用快照仓库(3.x去除了)


配置阿里云公共仓库

Nexus的maven-group的默认查找方式为:maven-releases --> maven-snapshots --> maven-central,我们在中间再加一个阿里云仓库,加快访问速度。

Maven私服Nexus安装与使用

选择proxy类型

Maven私服Nexus安装与使用

信息填写如下

Maven私服Nexus安装与使用

修改maven-public中的仓库引用及顺序:

Maven私服Nexus安装与使用


Maven配置使用Nexus私服

Maven配置私服下载依赖方式

maven配置私服下载有两种方式

  • setting.xml:该文件配置的是全局模式

  • pom.xml:该文件的配置的是项目独享模式

若pom.xml和setting.xml同时配置了,以pom.xml为准

setting.xml文件配置

这个时候不需要再配置pom.xml文件,即可使用私服下载jar依赖包

配置私服镜像
<mirrors><mirror><!--该镜像的唯一标识符。id用来区分不同的mirror元素。--><id>nexus-releases</id><!--*指的是访问任何仓库都使用我们的私服--><mirrorOf>*</mirrorOf><!--该镜像的URL。构建系统会优先考虑使用该URL,而非使用默认的服务器URL。--><url>http://10.172.0.201:8081/repository/maven-public/</url></mirror><mirror><id>nexus-snapshots</id><mirrorOf>*</mirrorOf><url>http://10.172.0.201:8081/repository/maven-snapshots/</url></mirror></mirrors>

镜像的URL可以从页面中的copy按钮直接复制


配置从私服下载jar包
<profiles>
<profile><!--profile的id--><id>nexus</id><repositories><repository><!--仓库id,repositories可以配置多个仓库,保证id不重复--><id>nexus-releases</id><!--仓库地址,即nexus仓库组的地址--><url>http://nexus-releases</url><releases><!--是否下载releases构件--><enabled>true</enabled></releases><snapshots><enabled>true</enabled></snapshots></repository><repository><id>nexus-snapshots</id><url>http://nexus-snapshots</url><releases><enabled>true</enabled></releases><snapshots><enabled>true</enabled></snapshots></repository></repositories><pluginRepositories><!-- 插件仓库,maven的运行依赖插件,也需要从私服下载插件 --><pluginRepository><!-- 插件仓库的id不允许重复,如果重复后边配置会覆盖前边 --><id>nexus-releases</id><url>http://nexus-releases</url><releases><enabled>true</enabled></releases><snapshots><enabled>true</enabled></snapshots></pluginRepository><pluginRepository><id>nexus-snapshots</id><url>http://nexus-snapshots</url><releases><enabled>true</enabled></releases><snapshots><enabled>true</enabled></snapshots></pluginRepository></pluginRepositories></profile>
</profiles>
<!--激活profile--><activeProfiles><activeProfile>nexus</activeProfile></activeProfiles>


pom.xml文件配置

如果你配置了pom.xml,则以pom.xml为准

<repositories><repository><id>maven-nexus</id><name>maven-nexus</name><url>http://10.172.0.201:8081/repository/maven-public/</url><releases><enabled>true</enabled></releases><snapshots><enabled>true</enabled></snapshots></repository></repositories>


配置Maven连接私服打包上传项目

第一步,修改setting.xml文件,指定releases和snapshots server的用户名和密码

<servers><server><id>releases</id><username>admin</username><password>admin123</password></server><server><id>snapshots</id><username>admin</username><password>admin123</password></server></servers>

第二步,在项目的pom.xml文件中加入distributionManagement节点

注意:repository里的id需要和第一步里的server id名称保持一致

<distributionManagement><repository><id>releases</id><name>Releases</name><url>http://10.172.0.201:8081/repository/maven-releases/</url></repository><snapshotRepository><id>snapshots</id><name>Snapshot</name><url>http://10.172.0.201:8081/repository/maven-snapshots/</url></snapshotRepository></distributionManagement>

第三步,执行发布

mvn deploy

登录Nexus,查看对应的仓库已经有相关的依赖包了。

注意以下几点:

  • 若项目版本号末尾带有 -SNAPSHOT,则会发布到snapshots快照版本仓库

  • 若项目版本号末尾带有 -RELEASES 或什么都不带,则会发布到releases正式版本仓库


上传第三方jar包


原文链接:

https://blog.csdn.net/ThinkWon/article/details/94346681