Nexus安装配置

时间:2021-10-17 07:05:38

一、下载最新版本的nexus

1、下载地址:http://www.sonatype.org/nexus/go

2、官网如果下载不了,就找个zip下载,我下载的是:nexus-2.10.0-02-bundle.zip

3、 解压zip文件,出现两个文件夹:

   Nexus安装配置

4、 打开D:\tools\Nexus-oss\nexus-2.10.0-02\bin\jsw\,选择合适的系统,打开对应的文件夹:

  Nexus安装配置

二、安装nexus

1、安装

  点击install-nexus.bat,然后访问http://localhost:8081/nexus/ 启动后如下页面,在右上角有个Log in 的超链接,点击登录

默认的用户名是 admin 密码是 admin123

  Nexus安装配置

2、修改登录信息:

  Nexus安装配置

3、配置代理

配置一下maven的代理服务器(前提是你的电脑不能连接外网,如果可以上外网,这里也没有意思,只是介绍一下)

  Nexus安装配置

添加你的代理服务器就可以了。

4、使用3rd party

使用3rd party这个第三方的功能,将maven仓库中没有构件的jar包上传到服务器

  Nexus安装配置

5、修改central repo的默认地址

maven3使用nexus作为代理服务器时需要修改*库的url地址,maven默认的*库的地址是http://repo.maven.apache.org/maven2/,而nexus默认的*代理库的地址是http://repo1.maven.org/maven2/,可能是maven3启用了新的*库,解决办法是:

修改nexus的*库central配置:

把默认的*库的url:http://repo1.maven.org/maven2/

修改为: http://repo.maven.apache.org/maven2/

三、 在项目中配置Nexus Repository的信息

配置工程的pom.xml,使用nexus repository的jar包:

1、添加本地仓库地址

在Maven项目的pom.xml中添加如下的本地仓库地址:

<repositories>

<repository>

<id>nexus</id>

<name>nexus</name>

<url>http://10.10.10.41:8081/nexus/content/groups/public/</url>

<releases>

<enabled>true</enabled>

</releases>

<snapshots>

<enabled>true</enabled>

</snapshots>

</repository>

</repositories>

2、添加插件仓库地址:

在Maven项目的pom.xml中添加如下的本地仓库地址:

<pluginRepositories>

<pluginRepository>

<id>nexus</id>

<name>nexus</name>

<url>http://10.10.10.41:8081/nexus/content/groups/public/</url>

<releases>

<enabled>true</enabled>

</releases>

<snapshots>

<enabled>true</enabled>

</snapshots>

</pluginRepository>

</pluginRepositories>

3、分发构件至远程仓库

mvn install 会将项目生成的构件安装到本地Maven仓库,mvn deploy 用来将项目生成的构件分发到远程Maven仓库。本地Maven仓库的构件只能供当前用户使用,在分发到远程Maven仓库之后,所有能访问该仓库的用户都能使用你的构件。

所以我们需要配置工程中POM的distributionManagement来指定Maven分发构件的位置

<distributionManagement>

<repository>

<id>releases</id>

<name>Nexus Release Repository</name>

<url>http://10.10.10.41:8081/nexus/content/repositories/releases/</url>

</repository>

<snapshotRepository>

<id>snapshots</id>

<name>Nexus Snapshot Repository</name>

<url>http://10.10.10.41:8081/nexus/content/repositories/snapshots/</url>

</snapshotRepository>

</distributionManagement>

四、用Nexus Repository取代Maven Central Repository

配置maven的settings.xml文件

4.1、文件存放位置

全局配置: ${M2_HOME}/conf/settings.xml

用户配置: ${user.home}/.m2/settings.xml

备注:用户配置优先于全局配置。${user.home} 和和所有其他系统属性只能在3.0+版本上使用。请注意windows和Linux使用变量的区别。

4.2、配置server

<servers>

<server>

<id>releases</id>

<username>admin</username>

<password>admin123</password>

</server>

<server>

<id>snapshots</id>

<username>admin</username>

<password>admin123</password>

</server>

<server>

<id>nexus</id>

<username>admin</username>

<password>admin123</password>

</server>

</servers>

备注:settings.xml中server元素下id的值必须与POM中repository下id的值完全一致。将认证信息放到settings下而非POM中,是因为POM往往是他人可见的,而settings.xml是本地的。

4.3、用Nexus取代Maven Central Repository

目前我们只是创建了一个专属的Nexus Repository,我们的项目默认还是使用的Maven Central Repository,所以这时我们需要将Maven Central Repository换成自己创建的Nexus Repository,可以通过修改~/.m2/settings.xml来达到这样的目的。

在settings.xml文件中(没有的话可以创建一个),加入以下配置:

<mirrors>

<mirror>

<id>nexus-releases</id>

<mirrorOf>*</mirrorOf>

<url>http://10.10.10.41:8081/nexus/content/groups/public</url>

</mirror>

<mirror>

<id>nexus-snapshots</id>

<mirrorOf>*</mirrorOf>

<url>http://10.10.10.41:8081/nexus/content/groups/public-snapshots</url>

</mirror>

</mirrors>

<profiles>

<profile>

<id>nexus</id>

<repositories>

<repository>

<id>releases</id>

<url>http://10.10.10.41:8081/nexus/content/repositories/releases</url>

<releases><enabled>true</enabled></releases>

<snapshots><enabled>true</enabled></snapshots>

</repository>

<repository>

<id>snapshots</id>

<url>http://10.10.10.41:8081/nexus/content/repositories/snapshots</url>

<releases><enabled>true</enabled></releases>

<snapshots><enabled>true</enabled></snapshots>

</repository>

</repositories>

<pluginRepositories>

<pluginRepository>

<id>releases</id>

<url>http://10.10.10.41:8081/nexus/content/repositories/releases</url>

<releases><enabled>true</enabled></releases>

<snapshots><enabled>true</enabled></snapshots>

</pluginRepository>

<pluginRepository>

<id>snapshots</id>

<url>http://10.10.10.41:8081/nexus/content/repositories/snapshots</url>

<releases><enabled>true</enabled></releases>

<snapshots><enabled>true</enabled></snapshots>

</pluginRepository>

</pluginRepositories>

</profile>

</profiles>

以上配置通过mirror和profile的方式将central Repository全部转向到我们自己的Public Repositories,包括release版本和snapshot版本(Maven默认允许从Maven Central Repository下载release版本,这是合理的,如果你使用了别人的snapshot版本,一边你在使用,一边别人在开发,别人将API签名一换,你就悲剧了)。这样一来,我们项目中的所有依赖都从Nexus的Public Repositories下载,由于其中包含了对Maven Central Repository的代理,所以此时Maven Central Repository中的类库也是可以间接下载到的。此时你可以将~/.m2/repository/中所有的内容删除掉,再在项目中执行“mvn clean install”,你将在终端中看到Maven已经开始从Nexus 的Public Repositories中下载依赖了。

OK,完成了nexus私服的搭建,项目组开发人员开发时,只要在项目的pom.xml文件中,添加如下pom.xml信息即可获取私服的jar.

如果添加其他的构件时,会先在nexus中下载好,以后才会下载到本地。以后,如果发现nexus已经存在某一jar包,则会直接从nexus下载,如果没有再去网络上下载。这就是搭建nexus的好处。

所以很有必要搭建nexus。

五、FAQ

5.1、was cached in the local repository

  5.1.1、问题描述:

    在使用maven私服仓库编译项目时,由于缺少jar包编译失败,然后上传缺失的jar包至nexus私服仓库,但是编译还失败了,

  出现错误:was cached in the local repository, resolution will not be reattempted until the update interval of nexus has elapsed or updates are forced ->   [Help 1]

  5.1.2、问题原因:

    Maven默认会使用本地缓存的库来编译工程,对于上次下载失败的库,maven会在~/.m2/repository/ / / /目录下创建xxx.lastUpdated文件

  5.1.3、解决办法:

    删除~/.m2/repository/ / / /目录下的*.lastUpdated文件,然后再次编译工程