Maven私服Nexus3.x环境构建操作记录

引入

Nexus是一个强大的Maven仓库管理器，它极大地简化了本地内部仓库的维护和外部仓库的访问。

在本地构建Nexus私服的好处有：

1）加速构建
2）节省带宽
3）节省中央maven仓库的带宽
4）稳定（应付一旦中央服务器出问题的情况）
5）控制和审计
6）能够部署第三方构件
7）可以建立本地内部仓库
8）可以建立公共仓库

设置

点击“设置”图标，在“设置”里可以添加用户、角色，对接LDAP等的设置

简介

component 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(虚拟类型)：虚拟仓库(基本用不到，重点关注上面三个仓库的使用)

Nexus仓库分类的概念：

1）Maven可直接从宿主仓库下载构件，也可以从代理仓库下载构件，而代理仓库间接的从远程仓库下载并缓存构件
2）为了方便，Maven可以从仓库组下载构件，而仓库组并没有时间的内容(下图中用虚线表示，它会转向包含的宿主仓库或者代理仓库获得实际构件的内容)

Policy(策略)

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

Public Repositories下的仓库

1）3rd party: 无法从公共仓库获得的第三方发布版本的构件仓库，即第三方依赖的仓库，这个数据通常是由内部人员自行下载之后发布上去
2）Apache Snapshots: 用了代理Apache Maven仓库快照版本的构件仓库
3）Central: 用来代理maven中央仓库中发布版本构件的仓库
4）Central M1 shadow: 用于提供中央仓库中M1格式的发布版本的构件镜像仓库
5）Codehaus Snapshots: 用来代理Codehaus Maven 仓库的快照版本构件的仓库
6）Releases: 内部的模块中release模块的发布仓库，用来部署管理内部的发布版本构件的宿主类型仓库；release是发布版本
7）Snapshots: 发布内部的SNAPSHOT模块的仓库，用来部署管理内部的快照版本构件的宿主类型仓库；snapshots是快照版本，也就是不稳定版本

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

端口

Nexus默认的端口是8081，可以在etc/nexus-default.properties配置中修改。

默认账户

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

工作路径

Nexus的工作目录是sonatype-work（路径一般在nexus同级目录下）

常见问题

当遇到奇怪问题时，重启Nexus，重启后web界面要1分钟左右后才能访问

Nexus的web界面功能介绍

Browse Server Content

Search菜单

就是类似Maven仓库上的搜索功能，就是从私服上查找是否有哪些包。

1）在Search这级是支持模糊搜索的
2）如果进入具体的目录，好像不支持模糊搜索

Browse菜单

1）Assets：这是能看到所有的资源，包含Jar，已经对Jar的一些描述信息。
2）Components：这里只能看到Jar包。

Server Adminstration And configuration

看到这个选项的前提是要进行管理员登录的

Blob Stores

文件存储的地方，Type为File，Path对应文件系统的一个目录

Repository -> Blob Stores -> Create blob store

• Type: Files
• Name: native
• Path: /data/www/sonatype-work/nexus3/blobs/native

Repositories

Proxy

代理中央Maven仓库，当PC访问中央库的时候，先通过Proxy下载到Nexus仓库，然后再从Nexus仓库下载到PC本地。
这样的优势只要其中一个人从中央仓库下载下来了，以后大家都是从Nexus私服上进行下载，私服一般部署在内网，这样大大节约的宽带。

创建Proxy的具体步骤：

（1）点击Create repository按钮

（2）选择要创建的类型Select Recipe为maven2 (proxy)

（3）配置详细信息

• Name：代理仓库名称
• Remote Storage: 代理的地址，Maven的地址为: https://repo1.maven.org/maven2/
• Blob Store: 选择代理下载包的存放路径

Hosted

Hosted是宿主的意思，就是把第三方的Jar放到私服上。Hosted有三种方式，即Releases、Snapshot、Mixed

• Releases: 一般是已经发布的Jar包
• Snapshot: 未发布的版本
• Mixed：混合的

Hosted的创建和Proxy是一致的，具体步骤和上面基本一致。如下：

（1）点击Create repository按钮

（2）选择要创建的类型Select Recipe为maven2 (hosted)

（3）配置详细信息

• Name：代理仓库名称
• Deployment Pollcy: 需要把策略改成Allow redeploy
• Blob Store: 选择代理下载包的存放路径

Group

能把两个仓库合成一个仓库来使用，目前没使用过，所以没做详细的研究。

Security

主要是用户、角色、权限的配置

Support

包含日志及数据分析

System

主要是邮件服务器，调度的设置

Maven集成

集成的方式主要分以下种情况：代理中央仓库、Snapshot包的管理、Release包的管理、第三方Jar上传到Nexus上。

代理中央仓库

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

<repositories>
    <repository>
        <id>maven-central</id>
        <name>maven-central</name>
        <url>http://192.168.1.10:8081/repository/maven-central/</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
        <releases>
            <enabled>true</enabled>
        </releases>
    </repository>
</repositories>

Snapshot包的管理

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

<servers>
    <server>
        <id>nexus</id>
        <username>admin</username>
        <password>admin123</password>
    </server>
<servers>

2）修改工程的pom文件

<distributionManagement>
    <snapshotRepository>
        <id>nexus</id>
        <name>Nexus Snapshot</name>
        <url>http://192.168.1.10:8081/repository/maven-snapshots/</url>
    </snapshotRepository>
</distributionManagement>

snapshotRepository的id与settings.xml文件中<server>的id一定要对应上

3）上传到Nexus上

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

<groupId>cn.appblog</groupId>
<artifactId>test-nexus</artifactId>
<version>1.0.0-SHAPSHOT</version>
<packaging>jar</packaging>

• 使用mvn deploy命令或Maven插件运行即可

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

Releases包的管理

1）与Snapshot大同小异，只是上传到私服上的Jar包不会自动带时间戳

2）与Snapshot配置不同的地方，就是工程的pom文件，加入repository配置

<distributionManagement>
    <repository>
        <id>nexus</id>
        <name>Nexus Snapshot</name>
        <url>http://192.168.1.10:8081/repository/maven-releases/</url>
    </repository>
</distributionManagement>

3）打包的时候需要把Snapshot去掉

<groupId>cn.appblog</groupId>
<artifactId>test-nexus</artifactId>
<version>1.0.0</version>
<packaging>jar</packaging>

第三方Jar上传到Nexus

通过命令行上传jar到nexus：

mvn deploy:deploy-file -DgroupId=cn.appblog.ams -DartifactId=ams-base -Dversion=1.0.0 -Dpackaging=jar -Dfile=C:\develop\lib\ams-base-1.1.0.jar -Durl=http://192.168.1.10:8081/repository/maven-releases/ -DrepositoryId=nexus

注意事项：-DrepositoryId=nexus对应的就是Maven中settings.xml的认证配的id