DevOps - 项目私库 - Nexus Repository

相关链接

Sonatype官网：https://www.sonatype.com

Products: Nexus Repository OSS2.x & 3.x

Documentation: https://help.sonatype.com/docs 文档分为Nexus Repository OSS 2.x & 3.x 版本，点击 Switch 可以切换

Download: https://www.sonatype.com/download-oss-sonatype 浏览器状态下，点击 选择版本 下载3.x版本，页面底部点击 Nexus 2.x 可以下载2.x版本，也可以在Documentation页面点击 Dounload 页面下载。

Linux 使用 wget 下载需要获取真实的下载地址，可以在浏览器中下载相应版本，拷贝相应地址到终端下载。

https://sonatype-download.global.ssl.fastly.net/repository/repositoryManager/3/nexus-3.13.0-01-unix.tar.gz

官方Docker镜像：https://hub.docker.com/u/sonatype/

Nexus Repository OSS 3.x 支持的格式

Nexus 概述

Nexus 是“开箱即用”的系统，不需要数据库，它使用文件系统加 Lucene 来组织数据，支持 WebDAV 与 LDAP 安全身份认证。Nexus 还提供了强大的仓库管理功能，构件搜索功能，它基于 REST，友好的 UI 是一个 extjs 的 REST 客户端，它占用较少的内存，基于简单文件系统而非数据库。Nexus 极大地简化了本地内部仓库的维护和外部仓库的访问。另外，Nexus 还可以在代理远程仓库的同时维护本地仓库，以降低中央仓库的负荷，节省外网带宽和时间。

本篇 Nexus 选择 3.x 版本，Nexus3.x 相较 2.x 版本有很大的改变：

1）从底层重构，从而提高性能，增强扩展能力，并改善用户体验
2）升级界面，增加更多的浏览，搜索和管理功能
3）提供安装包，使部署更简单（安装完自动添加成服务，省去手动添加的麻烦）
4）增加 Docker，NuGet，npm，Bower的支持
5）提供新的管理接口，从而能自动管理任务。
注意：3.x版本只能运行在JVM8及以上

总之，本地内部仓库在本地构建nexus私服的好处有：

1）加速构建、稳定；
2）节省带宽、节省中央maven仓库的带宽；
3）控制和审计；
4）能够部署第三方构件；
5）可以建立本地内部仓库、可以建立公共仓库

这些优点使得Nexus日趋成为最流行的Maven仓库管理器。

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

概念

内置 Repository

登录Nexus

Nexus默认管理员用户名和密码为：admin/admin123

Nexus 内置仓库介绍

Maven Gentral：该残酷代理Maven中央仓库，其策略为Release，因此只会下载和缓存中央仓库中的发布版本构件。

Release:这是一个策略为Release的宿主类型仓库，用来部署组织内部的发布版本构件。

Snapshots：这是一个策略为Snapshot的宿主类型仓库，用来部署组织内部的快照版本构件。

3rd party：这是一个策略为Release的宿主类型仓库，用来部署无法从公共仓库获得的第三方发布版本构件。

Apache Snapshots: 这是一个策略为Snapshot的代理仓库，用来代理Apache Maven仓库的快照版本构件。

Codehaus Snapshots: 这是一个策略为Snapshot的代理仓库，用来代理Codehaus Maven仓库的快照版本构件。

Google code: 这是一个策略为Release的代理仓库，用来代理Google Code Maven仓库发布版本构件。

java.net Maven2：这是一个策略为Release的代理仓库，用来代理java.net Maven仓库的发布版本构件

Public Repositories：该仓库组将上述所有策略为Release的仓库聚合并通过一致的地址提供服务

Public Snapshot Repositories： 该仓库组将上述所有的策略为Snapshot的仓库聚合并通过一致的地址提供服务。（在nexus-oss-webapp-1.9.2.3 这版本中没有此项）

Repository Type

HostedRepository- nexus本机的资源库（相当于nexus所在服务器硬盘上已经存在的jar、pom文件库）
ProxyRepository-代理库，很多开源官方组织都在互联网上公布了Repository，供全世界的开发者使用，nexus中设置该类型的资源库后，其它使用nexus的开发者，表面上是在请求nexus服务器上的jar包，但nexus实质是背后是在请求这些互联网资源，首次会把服务器上没有的资源，从网上download到nexus服务器（以文件形式保存到硬盘上），然后再返回给开发者，下次再有同样的pom/jar请求时，直接从服务器硬盘上返回，不再请求互联网
Repository Group-资源组，比如我们有很多资源库：资源库A、资源库B...，可以把它们再成组合一个特殊的资源C，然后其它开发人员，在maven里配置资源C地址，这样maven在向资源C请求jar包里，实质会搜索资源A、资源B

Repository Format

安装运行

Java Runtime Environment

Windows

Unix/Linux

启动nexus（默认端口是8081）
[root@master-node src]# /usr/local/nexus/bin/nexus 
WARNING: ************************************************************
WARNING: Detected execution as "root" user. This is NOT recommended!
WARNING: ************************************************************
Usage: /usr/local/nexus/bin/nexus {start|stop|run|run-redirect|status|restart|force-reload}
[root@master-node src]# /usr/local/nexus/bin/nexus start
WARNING: ************************************************************
WARNING: Detected execution as "root" user. This is NOT recommended!  
WARNING: ************************************************************
Starting nexus
上面在启动过程中出现告警：不推荐使用root用户启动。这个告警不影响nexus的正常访问和使用。
去掉上面WARNING的办法：
[root@master-node src]# vim /etc/profile
......
export RUN_AS_USER=root
[root@master-node src]# source /etc/profile
[root@master-node src]# lsof -i:8081            //nexus服务启动成功后，需要稍等一段时间，8081端口才起来
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
java 1486 root 859u IPv4 23504303 0t0 TCP *:tproxy (LISTEN)

在部署机上的iptables里打开8081端口
[root@master-node src]# vim /etc/sysconfig/iptables
....
-A INPUT -p tcp -m state --state NEW -m tcp --dport 8081 -j ACCEPT
[root@master-node src]# /etc/init.d/iptables restart

访问nexus，即http://localhost:8081    （如果出现404，就访问http://localhost:8081/nexus）

Docker

WebUI 配置管理

访问nexus，即http://localhost:8081    （如果出现404，就访问http://localhost:8081/nexus）

出现上述页面，说明配置nexus成功！
点击右上角“Log in”，
输入默认用户名(admin)和默认密码（admin123）登录

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

可以在“管理”里查看nexus的系统信息

注意下面几点说明：
1.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中使用。
2.Nexus默认的仓库类型有以下四种：
    1）group(仓库组类型)：又叫组仓库，用于方便开发人员自己设定的仓库；
    2）hosted(宿主类型)：内部项目的发布仓库（内部开发人员，发布上去存放的仓库）；
    3）proxy(代理类型)：从远程中央仓库中寻找数据的仓库（可以点击对应的仓库的Configuration页签下Remote Storage Location属性的值即被代理的远程仓库的路径）；
    4）virtual(虚拟类型)：虚拟仓库（这个基本用不到，重点关注上面三个仓库的使用）；
3.Policy(策略):表示该仓库为发布(Release)版本仓库还是快照(Snapshot)版本仓库；
4.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前面，下载包会更快。
5.Nexus默认的端口是8081，可以在etc/nexus-default.properties配置中修改。
6.Nexus默认的用户名密码是admin/admin123
7.当遇到奇怪问题时，重启nexus，重启后web界面要1分钟左右后才能访问。
8.Nexus的工作目录是sonatype-work（路径一般在nexus同级目录下）
[root@master-node local]# pwd
/usr/local
[root@master-node local]# ls nexus/
bin deploy etc lib LICENSE.txt NOTICE.txt public system
[root@master-node local]# ls sonatype-work/
nexus3
[root@master-node local]# ls sonatype-work/nexus3/
backup blobs cache db elasticsearch etc generated-bundles health-check instances keystores lock log orient port tmp

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

 

Nexus的web界面功能介绍

1.Browse Server Content

1.1  Search
这个就是类似Maven仓库上的搜索功能，就是从私服上查找是否有哪些包。
注意：
1）在Search这级是支持模糊搜索的，如图所示：

2）如果进入具体的目录，好像不支持模糊搜索，如图所示：

1.2  Browse

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

2.Server Adminstration And configuration

看到这个选项的前提是要进行登录的，如上面已经介绍登陆方法，右上角点击“Sign In”的登录按钮，输入admin/admin123,登录成功之后，即可看到此功能，如图所示：

2.1 Blob Stores
文件存储的地方，创建一个目录的话，对应文件系统的一个目录，如图所示：

2.2 Repositories

1）Proxy
这里就是代理的意思，代理中央Maven仓库，当PC访问中央库的时候，先通过Proxy下载到Nexus仓库，然后再从Nexus仓库下载到PC本地。
这样的优势只要其中一个人从中央库下来了，以后大家都是从Nexus私服上进行下来，私服一般部署在内网，这样大大节约的宽带。
创建Proxy的具体步骤
1--点击“Create Repositories”按钮

2--选择要创建的类型

3--填写详细信息
Name：就是为代理起个名字
Remote Storage: 代理的地址，Maven的地址为: https://repo1.maven.org/maven2/
Blob Store: 选择代理下载包的存放路径

2）Hosted
Hosted是宿主机的意思，就是怎么把第三方的Jar放到私服上。
Hosted有三种方式，Releases、SNAPSHOT、Mixed
Releases: 一般是已经发布的Jar包
Snapshot: 未发布的版本
Mixed：混合的
Hosted的创建和Proxy是一致的，具体步骤和上面基本一致。如下：

注意事项：
Deployment Pollcy: 需要把策略改成“Allow redeploy”。

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

2.3 Security
这里主要是用户、角色、权限的配置（上面已经提到了在这里添加用户和角色等）

2.4 Support
包含日志及数据分析。

2.5 System

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

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

代理中央仓库
只要在PMO文件中配置私服的地址（比如http://192.168.1.14:8081）即可，配置如下：

1 2 3 4 5 6 7 8 9 10 11 12 13

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

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

1 2 3 4 5 6

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

2）修改工程的Pom文件

1 2 3 4 5 6 7 8 9 10 11 12

<distributionManagement>         <snapshotRepository>             <id>nexus</id>             <name>Nexus Snapshot</name>             <url>http://192.168.1.14:8081/repository/maven-snapshots/</url>         </snapshotRepository>         <site>             <id>nexus</id>             <name>Nexus Sites</name>             <url>dav:http://192.168.1.14:8081/repository/maven-snapshots/</url>         </site>     </distributionManagement>

注意事项:

上面修改的Pom文件如截图中的名字要跟/usr/local/maven/conf/settings.xml文件中的名字一定要对应上。

3）上传到Nexus上

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

1 2 3 4

<groupId>com.woasis</groupId> <artifactId>test-nexus</artifactId> <version>1.0.0-<span style="color: #ff0000;">SHAPSHOT</span></version> <packaging>jar</packaging>

2--使用mvn deploy命令运行即可（运行结果在此略过）

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

Releases包的管理

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

1 2 3 4 5 6

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

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

1 2 3 4

<groupId>com.woasis</groupId>     <artifactId>test-nexus</artifactId>     <version>1.0.0</version> <packaging>jar</packaging>

第三方Jar上传到Nexus

[root@master-node src]# mvn deploy:deploy-file -DgroupId=org.jasig.cas.client -DartifactId=cas-client-core -Dversion=3.1.3 -Dpackag
注意事项：
-DrepositoryId=nexus 对应的就是Maven中settings.xml的认证配的名字。

***************当你发现自己的才华撑不起野心时，就请安静下来学习吧***************