nexus开源版安装笔记

来源:互联网 发布:域名防红接口 编辑:程序博客网 时间:2024/06/06 20:32
mavennexus镜像仓库
                    首先介绍一下背景,公司访问外网有限制,项目组大部分人员不能访问maven的central repository,因此在局域网里找一台有外网权限的机器,搭建nexus私服,然后开发人员连到这台私服上

环境是:nexus-2.1.1、maven-3.0.4、jdk-1.6.0_32

一、用admin用户登陆nexus

nexus的下载和安装都很简单,网上也有很多介绍,本文就不重复了。主要介绍一下安装之后的配置

nexus的配置需要用admin角色完成,默认的密码是admin123,进入nexus首页之后,点击右上角,进行登录



然后就可以在左边的菜单中进行配置了



二、为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代码 复制代码 收藏代码
  1. <?xml version="1.0"encoding="UTF-8"?> 
  2.  
  3. <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"  
  4.           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
  5.           xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> 
  6.   
  7.   <servers> 
  8.    
  9.     <server> 
  10.         <id>nexus-snapshots</id> 
  11.         <username>deployment</username> 
  12.         <password>deployment</password> 
  13.     </server> 
  14.  
  15.   </servers> 
  16.    
  17.   <mirrors> 
  18.    
  19.     <mirror> 
  20.         <id>nexus</id> 
  21.         <name>internal nexus repository</name> 
  22.         <url>http://10.78.68.122:9090/nexus-2.1.1/content/groups/public/</url> 
  23.         <mirrorOf>central</mirrorOf> 
  24.     </mirror> 
  25.      
  26.   </mirrors> 
  27.    
  28. </settings> 
<?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-snapshots</id>  <username>deployment</username>  <password>deployment</password>  </server>  </servers>    <mirrors>    <mirror>  <id>nexus</id>  <name>internal nexus repository</name>  <url>http://10.78.68.122:9090/nexus-2.1.1/content/groups/public/</url>  <mirrorOf>central</mirrorOf>  </mirror>    </mirrors>  </settings>

这里只配置了2个元素<mirrors>和<servers>

首先这里配置了一个id为nexus的镜像仓库,地址是前面配置的public group的URL,然后镜像目标是central

maven里的超级pom,里面配置了这样一段:
Xml代码 复制代码 收藏代码
  1. <repositories> 
  2.     <repository> 
  3.       <id>central</id> 
  4.       <name>Central Repository</name> 
  5.       <url>http://repo.maven.apache.org/maven2</url> 
  6.       <layout>default</layout> 
  7.       <snapshots> 
  8.         <enabled>false</enabled> 
  9.       </snapshots> 
  10.     </repository> 
  11.   </repositories> 
  12.  
  13.   <pluginRepositories> 
  14.     <pluginRepository> 
  15.       <id>central</id> 
  16.       <name>Central Repository</name> 
  17.       <url>http://repo.maven.apache.org/maven2</url> 
  18.       <layout>default</layout> 
  19.       <snapshots> 
  20.         <enabled>false</enabled> 
  21.       </snapshots> 
  22.       <releases> 
  23.         <updatePolicy>never</updatePolicy> 
  24.       </releases> 
  25.     </pluginRepository> 
  26.   </pluginRepositories> 
<repositories>    <repository>      <id>central</id>      <name>Central Repository</name>      <url>http://repo.maven.apache.org/maven2</url>      <layout>default</layout>      <snapshots>        <enabled>false</enabled>      </snapshots>    </repository>  </repositories>  <pluginRepositories>    <pluginRepository>      <id>central</id>      <name>Central Repository</name>      <url>http://repo.maven.apache.org/maven2</url>      <layout>default</layout>      <snapshots>        <enabled>false</enabled>      </snapshots>      <releases>        <updatePolicy>never</updatePolicy>      </releases>    </pluginRepository>  </pluginRepositories>

因此,当本地的maven项目,找不到需要的构件(包括jar包和插件)的时候,默认会到central里获取

所以我们刚刚配置的镜像仓库,id也是central,这样本地maven项目对central repository的请求,就会转到镜像仓库上,也就是我们设置的nexus私服上

由于我们在项目的pom里,不会再配置其他的<repositories>和<pluginRepositories>元素,所以只要配置一个central的mirror,就足以阻止所有的外网访问。如果pom中还配置了其他的外网仓库,比如jboss repository等,可以把<mirrorOf>改为*

至于<servers>元素,是因为我们把项目内部的构件上传到nexus的仓库中时,nexus会进行权限控制,所以这里需要设置权限相关的信息。注意这里的<id>nexus-snapshots</id>,和后面maven工程里的pom设置是一致的

由于我们这里已经屏蔽了对外网仓库的请求,所以就不需要配置代理服务器了,如果需要配置代理服务器,可以用<proxies>元素

九、配置maven项目的pom文件

下面是简化后的pom文件:
Xml代码 复制代码 收藏代码
  1. <project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  2.     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
  3.  
  4.     <modelVersion>4.0.0</modelVersion> 
  5.     <groupId>com.huawei.inoc.wfm.task</groupId> 
  6.     <artifactId>task-sla</artifactId> 
  7.     <version>0.0.1-SNAPSHOT</version> 
  8.     <name>task-sla</name> 
  9.  
  10.     <!-- 配置部署的远程仓库 --> 
  11.     <distributionManagement> 
  12.         <snapshotRepository> 
  13.             <id>nexus-snapshots</id> 
  14.             <name>nexus distribution snapshot repository</name> 
  15.             <url>http://10.78.68.122:9090/nexus-2.1.1/content/repositories/snapshots/</url> 
  16.         </snapshotRepository> 
  17.     </distributionManagement> 
  18.  
  19. </project> 
<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.huawei.inoc.wfm.task</groupId><artifactId>task-sla</artifactId><version>0.0.1-SNAPSHOT</version><name>task-sla</name><!-- 配置部署的远程仓库 --><distributionManagement><snapshotRepository><id>nexus-snapshots</id><name>nexus distribution snapshot repository</name><url>http://10.78.68.122:9090/nexus-2.1.1/content/repositories/snapshots/</url></snapshotRepository></distributionManagement></project>

这里配置了<distributionManagement>元素,其中的<id>nexus-snapshots</id>,与前面说的settings.xml中的<servers>元素中的配置必须一致

配置这个的目的,是当执行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目录,就是构件实际存放的地址了
  • 大小: 2.6 KB
  • 大小: 16.5 KB
  • 大小: 26.5 KB
  • 大小: 37.1 KB
  • 大小: 50.4 KB
  • 大小: 46.7 KB
  • 大小: 35.5 KB
  • 大小: 26.9 KB
  • 大小: 53.3 KB
  • 大小: 20 KB
  • 大小: 19.7 KB
  • 查看图片附件
返回顶楼
 
  • ZZX19880809
  • 等级: 初级会员
  • 性别:
  • 文章: 123
  • 积分: 0
  • 来自: 杭州
          发表时间:2012-09-12               
我们公司也是这样操作的!   
返回顶楼
回帖地址
00 请登录后投票
 
  • mlw2000
  • 等级: 初级会员
  • 性别:
  • 文章: 139
  • 积分: 60
  • 来自: 深圳
          发表时间:2012-09-13               
鉴定完毕,楼主是huawei的。   
返回顶楼
回帖地址
00 请登录后投票
 
  • steafler
  • 等级: 初级会员
  • 性别:
  • 文章: 125
  • 积分: 0
  • 来自: 成都
          发表时间:2012-09-13               
小心华为告你哦   
返回顶楼
回帖地址
00 请登录后投票
 
  • kyfxbl
  • 等级: 一钻会员
  • 性别:
  • 文章: 720
  • 积分: 950
  • 来自: 深圳
          发表时间:2012-09-13               
steafler 写道
小心华为告你哦


我贴个maven和nexus的相关知识,公司怎么会告我?   
返回顶楼
回帖地址
00 请登录后投票
 
  • 四书五经
  • 等级: 一星会员
  • 文章: 183
  • 积分: 110
                  发表时间:2012-09-16               
kyfxbl 写道
首先介绍一下背景,公司访问外网有限制,项目组大部分人员不能访问maven的central repository,因此在局域网里找一台有外网权限的机器,搭建nexus私服,然后开发人员连到这台私服上

环境是:nexus-2.1.1、maven-3.0.4、jdk-1.6.0_32

一、用admin用户登陆nexus

nexus的下载和安装都很简单,网上也有很多介绍,本文就不重复了。主要介绍一下安装之后的配置

nexus的配置需要用admin角色完成,默认的密码是admin123,进入nexus首页之后,点击右上角,进行登录



然后就可以在左边的菜单中进行配置了



二、为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代码 复制代码 收藏代码
  1. <?xml version="1.0"encoding="UTF-8"?> 
  2.  
  3. <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"  
  4.           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
  5.           xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> 
  6.   
  7.   <servers> 
  8.    
  9.     <server> 
  10.         <id>nexus-snapshots</id> 
  11.         <username>deployment</username> 
  12.         <password>deployment</password> 
  13.     </server> 
  14.  
  15.   </servers> 
  16.    
  17.   <mirrors> 
  18.    
  19.     <mirror> 
  20.         <id>nexus</id> 
  21.         <name>internal nexus repository</name> 
  22.         <url>http://10.78.68.122:9090/nexus-2.1.1/content/groups/public/</url> 
  23.         <mirrorOf>central</mirrorOf> 
  24.     </mirror> 
  25.      
  26.   </mirrors> 
  27.    
  28. </settings> 
<?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-snapshots</id>  <username>deployment</username>  <password>deployment</password>  </server>  </servers>    <mirrors>    <mirror>  <id>nexus</id>  <name>internal nexus repository</name>  <url>http://10.78.68.122:9090/nexus-2.1.1/content/groups/public/</url>  <mirrorOf>central</mirrorOf>  </mirror>    </mirrors>  </settings>

这里只配置了2个元素<mirrors>和<servers>

首先这里配置了一个id为nexus的镜像仓库,地址是前面配置的public group的URL,然后镜像目标是central

maven里的超级pom,里面配置了这样一段:
Xml代码 复制代码 收藏代码
  1. <repositories> 
  2.     <repository> 
  3.       <id>central</id> 
  4.       <name>Central Repository</name> 
  5.       <url>http://repo.maven.apache.org/maven2</url> 
  6.       <layout>default</layout> 
  7.       <snapshots> 
  8.         <enabled>false</enabled> 
  9.       </snapshots> 
  10.     </repository> 
  11.   </repositories> 
  12.  
  13.   <pluginRepositories> 
  14.     <pluginRepository> 
  15.       <id>central</id> 
  16.       <name>Central Repository</name> 
  17.       <url>http://repo.maven.apache.org/maven2</url> 
  18.       <layout>default</layout> 
  19.       <snapshots> 
  20.         <enabled>false</enabled> 
  21.       </snapshots> 
  22.       <releases> 
  23.         <updatePolicy>never</updatePolicy> 
  24.       </releases> 
  25.     </pluginRepository> 
  26.   </pluginRepositories> 
<repositories>    <repository>      <id>central</id>      <name>Central Repository</name>      <url>http://repo.maven.apache.org/maven2</url>      <layout>default</layout>      <snapshots>        <enabled>false</enabled>      </snapshots>    </repository>  </repositories>  <pluginRepositories>    <pluginRepository>      <id>central</id>      <name>Central Repository</name>      <url>http://repo.maven.apache.org/maven2</url>      <layout>default</layout>      <snapshots>        <enabled>false</enabled>      </snapshots>      <releases>        <updatePolicy>never</updatePolicy>      </releases>    </pluginRepository>  </pluginRepositories>

因此,当本地的maven项目,找不到需要的构件(包括jar包和插件)的时候,默认会到central里获取

所以我们刚刚配置的镜像仓库,id也是central,这样本地maven项目对central repository的请求,就会转到镜像仓库上,也就是我们设置的nexus私服上

由于我们在项目的pom里,不会再配置其他的<repositories>和<pluginRepositories>元素,所以只要配置一个central的mirror,就足以阻止所有的外网访问。如果pom中还配置了其他的外网仓库,比如jboss repository等,可以把<mirrorOf>改为*

至于<servers>元素,是因为我们把项目内部的构件上传到nexus的仓库中时,nexus会进行权限控制,所以这里需要设置权限相关的信息。注意这里的<id>nexus-snapshots</id>,和后面maven工程里的pom设置是一致的

由于我们这里已经屏蔽了对外网仓库的请求,所以就不需要配置代理服务器了,如果需要配置代理服务器,可以用<proxies>元素

九、配置maven项目的pom文件

下面是简化后的pom文件:
Xml代码 复制代码 收藏代码
  1. <project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  2.     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
  3.  
  4.     <modelVersion>4.0.0</modelVersion> 
  5.     <groupId>com.huawei.inoc.wfm.task</groupId> 
  6.     <artifactId>task-sla</artifactId> 
  7.     <version>0.0.1-SNAPSHOT</version> 
  8.     <name>task-sla</name> 
  9.  
  10.     <!-- 配置部署的远程仓库 --> 
  11.     <distributionManagement> 
  12.         <snapshotRepository> 
  13.             <id>nexus-snapshots</id> 
  14.             <name>nexus distribution snapshot repository</name> 
  15.             <url>http://10.78.68.122:9090/nexus-2.1.1/content/repositories/snapshots/</url> 
  16.         </snapshotRepository> 
  17.     </distributionManagement> 
  18.  
  19. </project> 
<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.huawei.inoc.wfm.task</groupId><artifactId>task-sla</artifactId><version>0.0.1-SNAPSHOT</version><name>task-sla</name><!-- 配置部署的远程仓库 --><distributionManagement><snapshotRepository><id>nexus-snapshots</id><name>nexus distribution snapshot repository</name><url>http://10.78.68.122:9090/nexus-2.1.1/content/repositories/snapshots/</url></snapshotRepository></distributionManagement></project>

这里配置了<distributionManagement>元素,其中的<id>nexus-snapshots</id>,与前面说的settings.xml中的<servers>元素中的配置必须一致

配置这个的目的,是当执行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目录,就是构件实际存放的地址了