Maven私服仓库nexus使用入门

一、什么是nexus

1.1什么是maven私服仓

maven私服仓是指私有服务器，是架设在局域网的一种特殊的远程仓库，目的是代理远程仓库及部署第三方构建。有了私服之后，当 Maven 需要下载构件时，直接请求私服，私服上存在则下载到本地仓库；否则，私服请求外部的远程仓库，将构件下载到私服，再提供给本地仓库下载。

1.2 nexus是什么

nexus全称：Sonatype Nexus，是专门搭建私服的 Maven 仓库管理软件，常见的Maven仓库管理软件还有：Apache Archiva，Artifactory。

Nexus 专业版是需要付费的，这里我们使用开源版 Nexus OSS。

Nexus 提供两种安装包，一种是包含 Jetty 容器的 bundle 包，另一种是不包含容器的 war 包。

二、nexus本地搭建

2.1 准备

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

下载Nexus Repository OSS版本，下载之前有个表格需要随便填一填。

2.2 安装步骤

下载解压后如下有两个目录：

nexus-3.37.3-02 （安装文件目录）

sonatype-work （工作目录，日志等内容）

将bin目录添加到环境变量，可以方便启动和退出Nexus。
修改配置文件端口号：\nexus-3.37.3-02\etc\nexus-default.properties ，修改端口号为自己想要的，这里我改为18081。

启动nexus，如下：nexus /run，在3.37版本中其他命令都不对！

启动成功控制台输出如下：

使用浏览器访问：http://127.0.0.1:18081/

执行 nexus /install 将Nexus安装为Windows服务。

通过运行services.msc查看服务，可将服务启动方式设为随机自动启动。

运行日志位置： \nexus-3.37.3-02-win64\sonatype-work\nexus3\log

三、nexus的使用

3.1 nexus登陆

访问http://127.0.0.1:18081/，后登陆，首次登陆用户为admin，密码默认在：nexus-3.37.3-02-win64\sonatype-work\nexus3\admin.password 。

密码是明文，直接复制，不要直接修改文件中的密码，修改后无效！！

使用初始化密码登录之后修改密码为自己想要的密码：

3.2 nexus 仓库说明

Repositories name的一些说明：

1）maven-central：maven中央库，默认从https://repo1.maven.org/maven2/拉取jar

2）maven-releases：私库发行版jar

3）maven-snapshots：私库快照（调试版本）jar

4）maven-public：仓库分组，把上面三个仓库组合在一起对外提供服务，在本地maven基础配置settings.xml中使用。

Nexus默认的仓库类型有以下四种：

1）group(仓库组类型)：又叫组仓库，用于方便开发人员自己设定的仓库；

2）hosted(宿主类型)：内部项目的发布仓库（内部开发人员，发布上去存放的仓库）；

3）proxy(代理类型)：从远程中央仓库中寻找数据的仓库（可以点击对应的仓库的Configuration页签下Remote Storage Location属性的值即被代理的远程仓库的路径）；

4）virtual(虚拟类型)：虚拟仓库（这个基本用不到，重点关注上面三个仓库的使用）；

3.Policy(策略):

表示该仓库为发布(Release)版本仓库还是快照(Snapshot)版本仓库；

Public Repositories下的仓库

1）3rd party: 无法从公共仓库获得的第三方发布版本的构件仓库，即第三方依赖的仓库，这个数据通常是由内部人员自行下载之后发布上去；

2）Apache Snapshots: 用了代理ApacheMaven仓库快照版本的构件仓库

3）Central: 用来代理maven中央仓库中发布版本构件的仓库

4）Central M1 shadow: 用于提供中央仓库中M1格式的发布版本的构件镜像仓库

5）Codehaus Snapshots: 用来代理CodehausMaven 仓库的快照版本构件的仓库

6）Releases: 内部的模块中release模块的发布仓库，用来部署管理内部的发布版本构件的宿主类型仓库；release是发布版本；

7）Snapshots:发布内部的SNAPSHOT模块的仓库，用来部署管理内部的快照版本构件的宿主类型仓库；snapshots是快照版本，也就是不稳定版本

所以自定义构建的仓库组代理仓库的顺序为：Releases，Snapshots，3rd party，Central。也可以使用oschina放到Central前面，下载包会更快。

Nexus默认的端口是8081

可以在etc/nexus-default.properties配置中修改。

当遇到奇怪问题时，重启nexus，重启后web界面要1分钟左右后才能访问。
Nexus的工作目录是sonatype-work（路径一般在nexus同级目录下）

四、Nexus和maven集成

这部分主要讲怎么和Maven做集成,集成的方式主要分以下种情况：代理中央仓库、Snapshot包的管理、Release包的管理、第三方Jar上传到Nexus上。

4.1 代理中央仓

只要在PMO文件中配置私服的地址（比如http://127.0.0.1:18081）即可，配置如下：

  <repository>
            <id>maven-central</id>
            <name>maven-central</name>
            <url>http://127.0.0.1:18081/repository/maven-central/</url>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
            <releases>
                <enabled>true</enabled>
            </releases>
        </repository>

4.2 Snapshot包的管理

修改Maven的settings.xml文件，加入认证机制。

 <server>
            <id>myserver</id>
            <username>admin</username>
            <password>123456</password>
        </server>

修改pom.xml文件

    <distributionManagement>
             <snapshotRepository>
            <!-- id 要和maven/conf/settings.xml中配置的一致-->
            <id>myserver</id>
            <url>http://127.0.0.1:18081/repository/maven-snapshots/</url>
        </snapshotRepository>
    </distributionManagement>

4.3 上传SNAPSHOT（开发版本）到Nexus上

项目编译成的jar是Snapshot(POM文件的头部)

 <groupId>com.devtao</groupId>
    <artifactId>test-everything</artifactId>
    <version>1.1.4-SNAPSHOT</version>
    <name>TestEveryThing</name>
    <description>测试Everything</description>

2. 用mvn deploy命令运行即可。

因为Snapshot是快照版本，默认他每次会把Jar加一个时间戳，做为历史备份版本。

4.4 上传Release 版本到Nexus上

与Snapshot大同小异，只是上传到私服上的Jar包不会自动带时间戳
与Snapshot配置不同的地方，就是工程的PMO文件，加入repository配置

 <distributionManagement>
        <repository>
            <!-- id 要和maven/conf/settings.xml中配置的一致-->
            <id>myserver</id>
            <url>http://127.0.0.1:18081/repository/maven-releases/</url>
        </repository>
  </distributionManagement>

3. 打包的时候需要把Snapshot去掉。这里我使用maven-release-plugin来自动完成该步骤。

   <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-release-plugin</artifactId>
                <configuration>
                    <tagBase>${project.artifactId}-${project.version}</tagBase>
                    <!-- tag分支的名称，project.version只包含版本，不包含SNAPSHOT后缀 -->
                    <tagNameFormat>v@{project.version}</tagNameFormat>
                    <!-- 升级子模块 -->
                    <autoVersionSubmodules>true</autoVersionSubmodules>
                    <!-- 是否生成release-pom.xml-->
                    <generateReleasePoms>false</generateReleasePoms>
                    <!-- 跳过单元测试 -->
                    <arguments>-DskipTests</arguments>
                    <!-- 执行目标是install还是deploy，install安装本地,deploy部署到nexus仓 -->
                    <goals>deploy</goals>
                </configuration>
            </plugin>

注意：goals属性，执行目标是install还是deploy，install安装本地,deploy部署到nexus仓，若是install，执行mvn release:perform后不会发布到nexus仓库。

发布完成之后查看nexues的maven release仓库。

4.5 第三方Jar上传到Nexus

mvn deploy:deploy-file -DgroupId=org.jasig.cas.client -DartifactId=cas-client-core -Dversion=3.1.3 -Dpackag

注意事项：

-DrepositoryId=nexus 对应的就是Maven中settings.xml的认证配的名字。

五、问题处理

4.1 windows nexus启动无反应

启动命令错了，正确的是nexus.exe /run，不加斜杠没有任何反应。

4.2 nexus的登陆密码是什么

网上很多说是admin123的，其实从3.17版本后已经不是了，密码在nexus-3.37.3-02-win64\sonatype-work\nexus3\admin.password ，是明文密码，首次登陆需要登陆后通过页面进行修改，直接改配置文件无效。