首先介绍一下背景,公司访问外网有限制,项目组大部分人员不能访问maven的central repository,因此在局域网里找一台有外网权限的机器,搭建nexus私服,然后开发人员连到这台私服上 环境是:nexus-2.1.1、maven-3.0.4、jdk-1.6.0_32 一、用admin用户登陆nexus nexus的下载和安装都很简单,网上也有很多介绍,本文就不重复了。主要介绍一下安装之后的配置 nexus的配置需要用admin角色完成,默认的密码是admin123,进入nexus凯发k8网页登录首页之后,点击右上角,进行登录 然后就可以在左边的菜单中进行配置了 二、为nexus配置代理服务器 由于这台机器需要通过代理才能访问外网,所以首先要配置代理服务器,在administration-->server中进行配置 配置之后,nexus才能连上central repository,如果私服所在机器可以直接上外网,则可以省略这一步 三、配置repository 在views/repositories-->repositories里进行配置 nexus里可以配置3种类型的仓库,分别是proxy、hosted、group proxy是远程仓库的代理。比如说在nexus中配置了一个central repository的proxy,当用户向这个proxy请求一个artifact,这个proxy就会先在本地查找,如果找不到的话,就会从远程仓库下载,然后返回给用户,相当于起到一个中转的作用 hosted是宿主仓库,用户可以把自己的一些构件,deploy到hosted中,也可以手工上传构件到hosted里。比如说oracle的驱动程序,ojdbc6.jar,在central repository是获取不到的,就需要手工上传到hosted里 group是仓库组,在maven里没有这个概念,是nexus特有的。目的是将上述多个仓库聚合,对用户暴露统一的地址,这样用户就不需要在pom中配置多个地址,只要统一配置group的地址就可以了 nexus装好之后,已经初始化定义了一些repository,我们熟悉之后,就可以自行删除、新增、编辑 右边那个repository path可以点击进去,看到仓库中artifact列表。不过要注意浏览器缓存。我今天就发现,明明构件已经更新了,在浏览器里却看不到,还以为是bug,其实是被浏览器缓存了 四、配置central repository的proxy 最关键的一个配置,可能就是central repository的proxy配置,因为大部分的构件,都是要通过这个proxy得到的 在安装完nexus之后,这个proxy是预置的,需要做的就是把download remote indexes改为true,这样nexus才会从central repository下载索引,才能在nexus中使用artifact search的功能 网络上有一些其他公开的maven仓库,可以用同样的办法,在nexus中设置proxy,但是并不是所有maven仓库,都提供了nexus index,这种情况下,就无法建立索引了 五、配置hosted repository 一般会配置3个hosted repository,分别是3rd party、snapshots、releases,分别用来保存第三方jar(典型的比如ojdbc6.jar),项目组内部的快照、项目组内部的发布版 这里并没有什么特别的配置,只是deployment policy这个选项,一般snapshots会配置成允许,而releases和3rd party会设置为禁止 六、配置group repository 前面说过,group其实是一个虚拟的仓库,通过对实体仓库(proxy、hosted)进行聚合,对外暴露一个统一的地址 这里要注意的是,放到左边的仓库,才是会被聚合的仓库。我昨天一直搞错了,把仓库都放到右边,结果group什么都没有聚合到,是一个空的仓库。。。 七、配置用户密码 在security-->users中配置,在deployment用户上点击右键,选择set password,然后设置一个密码,做这个操作是为了后面提交做准备 八、在用户机器上配置settings.xml 经过前面的7个步骤,nexus就配置好了,接下来需要在每个开发人员的开发机器上进行配置了 配置文件在%user_home%/.m2/settings.xml xml代码
nexus-snapshots
deployment
deployment
nexus
internal nexus repository
http://10.78.68.122:9090/nexus-2.1.1/content/groups/public/
central
" quality="high" allowscriptaccess="always" type="application/x-shockwave-flash" pluginspage="http://www.macromedia.com/go/getflashplayer">
- xml version="1.0" encoding="utf-8"?>
-
- <settings xmlns="http://maven.apache.org/settings/1.0.0"
- xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"
- xsi:schemalocation="http://maven.apache.org/settings/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
-
- <servers>
-
- <server>
- <id>nexus-snapshotsid>
- <username>deploymentusername>
- <password>deploymentpassword>
- server>
-
- servers>
-
- <mirrors>
-
- <mirror>
- <id>nexusid>
- <name>internal nexus repositoryname>
- <url>http://10.78.68.122:9090/nexus-2.1.1/content/groups/public/url>
- <mirrorof>centralmirrorof>
- mirror>
-
- mirrors>
-
- settings>
这里只配置了2个元素和 首先这里配置了一个id为nexus的镜像仓库,地址是前面配置的public group的url,然后镜像目标是central maven里的超级pom,里面配置了这样一段: - <repositories>
- <repository>
- <id>centralid>
- <name>central repositoryname>
- <url>http://repo.maven.apache.org/maven2url>
- <layout>defaultlayout>
- <snapshots>
- <enabled>falseenabled>
- snapshots>
- repository>
- repositories>
-
- <pluginrepositories>
- <pluginrepository>
- <id>centralid>
- <name>central repositoryname>
- <url>http://repo.maven.apache.org/maven2url>
- <layout>defaultlayout>
- <snapshots>
- <enabled>falseenabled>
- snapshots>
- <releases>
- <updatepolicy>neverupdatepolicy>
- releases>
- pluginrepository>
- pluginrepositories>
因此,当本地的maven项目,找不到需要的构件(包括jar包和插件)的时候,默认会到central里获取 所以我们刚刚配置的镜像仓库,id也是central,这样本地maven项目对central repository的请求,就会转到镜像仓库上,也就是我们设置的nexus私服上 由于我们在项目的pom里,不会再配置其他的和元素,所以只要配置一个central的mirror,就足以阻止所有的外网访问。如果pom中还配置了其他的外网仓库,比如jboss repository等,可以把改为* 至于元素,是因为我们把项目内部的构件上传到nexus的仓库中时,nexus会进行权限控制,所以这里需要设置权限相关的信息。注意这里的nexus-snapshots,和后面maven工程里的pom设置是一致的 由于我们这里已经屏蔽了对外网仓库的请求,所以就不需要配置代理服务器了,如果需要配置代理服务器,可以用元素 九、配置maven项目的pom文件 下面是简化后的pom文件: xml代码
4.0.0
com.huawei.inoc.wfm.task
task-sla
0.0.1-snapshot
task-sla
nexus-snapshots
nexus distribution snapshot repository
http://10.78.68.122:9090/nexus-2.1.1/content/repositories/snapshots/
" quality="high" allowscriptaccess="always" type="application/x-shockwave-flash" pluginspage="http://www.macromedia.com/go/getflashplayer">
- <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.0modelversion>
- <groupid>com.huawei.inoc.wfm.taskgroupid>
- <artifactid>task-slaartifactid>
- <version>0.0.1-snapshotversion>
- <name>task-slaname>
-
-
- <distributionmanagement>
- <snapshotrepository>
- <id>nexus-snapshotsid>
- <name>nexus distribution snapshot repositoryname>
- <url>http://10.78.68.122:9090/nexus-2.1.1/content/repositories/snapshots/url>
- snapshotrepository>
- distributionmanagement>
-
- project>
这里配置了元素,其中的nexus-snapshots,与前面说的settings.xml中的元素中的配置必须一致 配置这个的目的,是当执行maven deploy时,才知道要将生成的构件部署到哪个远程仓库上,注意这里的url填的就不是public group的地址: http://10.78.68.122:9090/nexus-2.1.1/content/groups/public/ 而是snapshots的地址: http://10.78.68.122:9090/nexus-2.1.1/content/repositories/snapshots/ 但是在nexus中,snapshots也是聚合到public group里的,所以开发人员a提交到snapshots的构件,开发人员b也可以从public group里获取到 十、eclipse中的设置 经过前面的配置,已经可以通过命令行进行maven操作了。不过实际开发中,一般都是使用eclipse的m2e插件,所以还需要对eclipse进行一些额外的配置 在preferences-->maven-->user settings中,点击update settings,加载刚才我们对settings.xml的更改 然后在maven repositories视图里,可以看到仓库的情况 可以看到,从超级pom继承来的central被置灰了,不可用,后面的mirrored by nexus表示对该仓库的所有请求,都会转到镜像nexus中 十一、nexus的目录结构 nexus会安装在%user_home%/sonatype-work/nexus下,有以下目录 其中的storage目录,就是构件实际存放的地址了