使用Nexus2.x为Maven3.x搭建私服构件仓库

 

前言

在笔者的前一篇博文《Use Maven3.x》中，笔者详细的讲解了如何通过使用Maven3.x来构建及管理你的项目。其中笔者提到过些关于私服的概念，但却没有明确的对私服做出详细的阐述，别着急，这便是你看笔者本篇博文的目的。

不知大家是否还有印象，Maven的本地仓库中所包含的构件全部来源于Maven的中央仓库，这个中央仓库是针对全世界的，也就是说全世界基于Mavem的项目都可以共同使用这个对外开放的中央仓库。

本篇博文笔者将详细针对Maven的本地仓库、私服仓库及中央仓库进行详细的讲解，但是在开始讲解之前，笔者希望大家先弄明白这3个仓库之间彼此的依赖关系。

 

在正式开始讲解本章之前，希望大家首先耐下心来听笔者讲解一个故事：

人物：小张、妈妈、经销商（小伟）、生产商（小红）；

情节：小张买盐；

 

故事内容：

有一天小张的妈妈看见家里没有盐了，于是就叫小张去楼下的小卖部去买一包盐，小张拿着3.5元钱高高兴兴的下楼了，但是来到经销商小伟的店里却被告知盐已经卖完了，这是小张心情有些低落，但小伟告诉小张，你不要着急，我等下便去生产商小红那里去批发一箱回来，小张一听顿时来劲了，大约等了半个小时后（笔者不知道小张妈妈油锅里的菜炒得如何了），生产商小红骑着电动车，拉着一箱盐来到了经销商小伟的店里，小伟对小张说，拿去吧，盐来了。最后小张拿着盐高高兴兴的回家去了。

 

上述故事虽然无聊但却和咱们本章的内容息息相关，为什么这么说呢？注意看，假设咱们现在要使用Maven来构建咱们的项目，Maven首先会去哪里寻找与项目相关的构件呢？没错就是本地仓库中，但本地仓库中并没有咱们需要的构件时，Maven就会选择去私服仓库寻找，假设私服仓库也没有咱们项目需要的构件时，则会去请求中央仓库，最后逐一返回（注意：并不是由中央仓库直接返回给本地仓库）。

 

或许有很多朋友有一个共同的疑问，为什么需要使用私服仓库呢？就算没有私服仓库，Maven不是也能和中央仓库建立关联，然后下载所需构件吗？这岂不是多此一举？

为什么要为自己的Maven项目搭建私服仓库呢？原因有如下3点：

 

1、我们应该尽可能的降低对Maven中央仓库的负载；

2、我们需要统一管理并规范我们项目所需的构件版本；

3、如果你所在的企业并不允许使用外网，那么你的项目将变得异常被动；

4、我们在很多时候需要节约那狗血的带宽流量；

 

请大家仔细观察Maven本地仓库、私服仓库及中央仓库之间的关联流程图：

 

 

一、下载与安装Nexus

 

想为Maven搭建私服，我们可以选择使用Nexus工具，该工具目前的最新版本为2.2.0（本文将采用最新版本），其下载地址为：http://www.sonatype.org/nexus/go

 

 

当我们成功下载好Nexus后，可以将其解压。在nexus-2.2-01-bundle\nexus-2.2-01\bin\jsw\windows-x86-32目录中我们找到console-nexus.bat文件（你可以选择对应的操作平台的启动文件），双击即可启动Nexus：

 

 

通过上图我们可以发现，Nexus服务器缺省的访问端口为8081（如果你需要修改缺省端口，你可以找到\nexus-2.2-01-bundle\nexus-2.2-01\conf目录下的nexus.properties文件，指定application-port属性为你的指定端口即可），接下来我们可以在浏览器中输入http://127.0.0.1:8081/nexus/查看Nexus是否成功启动：

 

 

通过上图我们可以发现我们已经成功的启动了Nexus，那么接下来要做的事情就更有意思了，在后续章节中笔者会陆续讲到应该如何使用Nexus工具来配置和管理咱们的私服仓库。

 

二、仓库类型 

在上一章节中，笔者讲解了如何下载与安装Nexus工具。那么本章节咱么来看看如何使用Nexus工具配置和管理私服仓库。当然在使用Nexus之前你是需要登录的，缺省账号密码为：

account：admin；

password：admin123；

 

当成功登录后，你可以单击 Repositories属性看到如下页面：

 

 

由于admin这个账号是属于Administrator权限的，你也可以通过单击Security属性进行账户的配置：

 

 

Nexus的仓库类型一共有4种，每一种仓库类型均对应有不同的操作方式：

1、group: 仓库组；

2、hosted：宿主；

3、proxy：代理；

4、virtual：虚拟；

来吧，咱们先谈谈仓库组这个概念，一个仓库组类似一个仓库集合，它和仓库之间是一对多的关系，也就是说一个仓库组可以允许包含多个仓库，Nexus仓库用例图如下：

 

 

 

在咱们弄明白仓库组的作用后，咱们接着来看宿主仓库是干什么的。其实所谓宿主仓库可以理解为自定义仓库，用于存放一些在中央仓库无法下载的构件，比如自定义构件（你可以手动将自定义构件上传至hosted中）。

 

代理仓库起到的作用是代理作用，假设本地仓库向私服进行请求时，首先会去私服仓库的本地路径中寻找构件，如果没有找到则会从中央仓库进行下载。

 

虚拟仓库省略...

 

 三、使用Nexus管理私服仓库

 

在了解Nexus的4种仓库类型后，咱们接下来要做的事情就是使用Nexus工具来管理咱们的私服仓库。先来看看Nexus为我们提供的一些缺省仓库：

 

 

 

从上图我们可以看出Nexus缺省为我们定义了1个仓库组，7个仓库。当中最主要的几个仓库为:

 

 

3rd party(宿主仓库):用于存放一些在中央仓库无法下载的构件仓库；

Apache Snapshots（代理仓库）:代理ApacheMaven仓库快照版本的构件仓库；

Central（代理仓库）:代理Maven中央仓库中发布版本构件的仓库；

 

当然你可以根据项目需要新建仓库组及仓库，但在建立这些私有的仓库之前，咱们还是先来看看如何使用Nexus为咱们提供的缺省构件仓库（其实很多时候你真没必要去新建仓库）。

 

选择Public Repositories分组，单击configuration选项，你可以为仓库组添加对应的仓库：

 

 

单击Save按钮保存即可配置完成。这里有一点需要提醒大家的是，仓库的添加顺序直接决定了构件的下载顺序，换句话来说我们应该把需要从中央仓库或者其他远程仓库下载构件的代理仓库添加在最后。

 

当咱们成功将指定的仓库集合添加进仓库组后，接下来我们来为3rd party(宿主仓库)上传自定义构件，所谓自定义构件指的是无法从Maven的中央仓库进行下载的构建。

笔者在此选用的是最简单方便的手动上传构件（当然上传构件至宿主仓库还有一些方式，但笔者还是侧重于最简便的方式）。

 

单击3rd party(宿主仓库)的Artifact Upload选项，我们首先来上传一个基于Maven项目的自定义构件：

 

 

最后别忘记了添加构件：

 

 

 

如果你的构件不是基于Maven的呢？那么你可以选择GAV Parameters属性：

 

 

其实按照上述步骤，咱们就已经成功将自定义构件上传至宿主仓库中了。那么接下来我们是不是应该让Maven的本地仓库来连接私服仓库试试构件能否正常下载呢？

 

来吧，找到你本地Maven的setting.xml文件，我们需要修改如下几个属性来指定Maven下载构件的地址为私服仓库路径而非中央仓库。

 

配置仓库属性：

<profiles> <profile> <id>myprofile</id> <repositories> <repository> <id>central</id> <url>http://central</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>central</id> <url>http://central</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile> </profiles>

 

 

  

 

 激活profile：

 

<activeProfiles> <activeProfile>myprofile</activeProfile> </activeProfiles>

 

 

 

配置镜像：

 

<mirrors> <mirror> <id>nexus</id> <url>仓库组或者仓库路径</url> <mirrorOf>*</mirrorOf> </mirror> </mirrors>

 

 

 

 

如果你和笔者一样使用的是Spring Tool Suite（基于eclipse二次开发的IDE），那么你需要将m2e自带的setting.xml文件路径更改为Maven本地的setting.xml文件路径。

 

 

替换完setting.xml配置文件后，我们打开菜单栏的Show View选择Meven Repositories视窗查看Maven下载构件仓库的位置：

 

 

通过下图我们可以看见，我们已经成功将Maven的构件下载路径从中央仓库改为了私服仓库：

 

 

 关于Maven及Nexus的相关内容笔者已经全部阐述完毕，谢谢各位赏脸观看。

 

 

评论

4 楼 josico 2014-04-01  

一切按部就班 结果出错 何解
用的是maven3.1.1和nexus-2.7.2-03

Artifact upload failed.
The version 0.0.1-SNAPSHOT does not match the repository policy!

3 楼 gao_xianglong 2012-12-07  

最后一个使用本地仓库的细节能说详细点么，或者基于最新的maven3.0.4把配置写出来。我基于3.0.4 的 setting.xml里面，节点比你上面说的不大一样。配置了mirror，下面仓库还是用的远程的。

youjianbo_han_87 写道

youjianbo_han_87 写道

最后一个使用本地仓库的细节能说详细点么，或者基于最新的maven3.0.4把配置写出来。我基于3.0.4 的 setting.xml里面，节点比你上面说的不大一样。配置了mirror，下面仓库还是用的远程的。

出来了，需要restart一下eclipse

不用重启eclipse，只需刷新Meven Repositories即可

2 楼 youjianbo_han_87 2012-12-07  

youjianbo_han_87 写道

最后一个使用本地仓库的细节能说详细点么，或者基于最新的maven3.0.4把配置写出来。我基于3.0.4 的 setting.xml里面，节点比你上面说的不大一样。配置了mirror，下面仓库还是用的远程的。

出来了，需要restart一下eclipse

1 楼 youjianbo_han_87 2012-12-07  

最后一个使用本地仓库的细节能说详细点么，或者基于最新的maven3.0.4把配置写出来。我基于3.0.4 的 setting.xml里面，节点比你上面说的不大一样。配置了mirror，下面仓库还是用的远程的。