私服介绍
私服是指私有服务器,是架设在局域网的一种特殊的远程仓库,目的是代理远程仓库及部署第三方构建。有了私服之后,当 Maven 需要下载构件时,直接请求私服,私服上存在则下载到本地仓库;否则,私服请求外部的远程仓库,将构件下载到私服,再提供给本地仓库下载。
Nexus介绍
Nexus是一个强大的Maven仓库管理器,它极大地简化了本地内部仓库的维护和外部仓库的访问。
如果使用了公共的Maven仓库服务器,可以从Maven中央仓库下载所需要的构件(Artifact),但这通常不是一个好的做法。
正常做法是在本地架设一个Maven仓库服务器,即利用Nexus私服可以只在一个地方就能够完全控制访问和部署在你所维护仓库中的每个Artifact。
Nexus在代理远程仓库的同时维护本地仓库,以降低中央仓库的负荷,节省外网带宽和时间,Nexus私服就可以满足这样的需要。
Nexus是一套“开箱即用”的系统不需要数据库,它使用文件系统加Lucene来组织数据。
Nexus使用ExtJS来开发界面,利用Restlet来提供完整的REST APIs,通过m2eclipse与Eclipse集成使用。
Nexus支持WebDAV与LDAP安全身份认证。
Nexus还提供了强大的仓库管理功能,构件搜索功能,它基于REST,友好的UI是一个extjs的REST客户端,它占用较少的内存,基于简单文件系统而非数据库。
为什么要构建Nexus私服?
如果没有Nexus私服,我们所需的所有构件都需要通过maven的中央仓库和第三方的Maven仓库下载到本地,而一个团队中的所有人都重复的从maven仓库下载构件无疑加大了仓库的负载和浪费了外网带宽,如果网速慢的话,还会影响项目的进程。很多情况下项目的开发都是在内网进行的,连接不到maven仓库怎么办呢?开发的公共构件怎么让其它项目使用?这个时候我们不得不为自己的团队搭建属于自己的maven私服,这样既节省了网络带宽也会加速项目搭建的进程,当然前提条件就是你的私服中拥有项目所需的所有构件。
总之,在本地构建nexus私服的好处有:
1)加速构建;
2)节省带宽;
3)节省中央maven仓库的带宽;
4)稳定(应付一旦中央服务器出问题的情况);
5)控制和审计;
6)能够部署第三方构件;
7)可以建立本地内部仓库;
8)可以建立公共仓库
这些优点使得Nexus日趋成为最流行的Maven仓库管理器。
下面我一步步讲解在linux下安装,使用,配置,上传二方库
第一步、下载安装
nexus下载:https://www.sonatype.com/download-oss-sonatype,选择Unix版本下载,
我下载的版本是nexus-3.12.1-01-unix.tar.gz,或许和同学下载的版本不一样,但不要紧。
上传到linux主机,解压tar -zxf nexus-3.12.1-01-unix.tar.gz
第二步:启动
cd /nexus-3.12.1-01/bin
nexus.vmoptions 是启动选项,一般配置工作目录和数据的临时目录
配置端口号和url的是在etc目录下的nexus-default.properties,
nexus默认端口号是8081
我不做任何修改。来到bin目录,执行./nexus start 启动
访问http://192.168.7.52:8081/
看到这个页面,说明已经启动成功。 登录账号密码是admin/admin123
第三步,功能介绍
首页是做浏览搜索,私服上已经存在的component.支持maven和NuGet。NuGet是.Net上类型maven的包管理工具。这篇文章只介绍maven相关的。
点击Search-maven,有groupId,artifactId,version等筛选项。帮助用户筛选库
点击打开某个component,可以看到相关的信息,它的repository,最新版本等
点击Browse,选择特定的repository,进行层次访问。
打开配置页面,前提是admin已经登录。
Blob store,用于配置库的存储路径
Repositories 配置仓库,增删仓库。maven仓库有4种类型
1,proxy 代理类型。指定一个maven中央仓库,私服没有对应的jar包,就会从proxy中下载。maven-control就是预设的,proxy的仓库地址是https://repo1.maven.org/maven2/
2.release 发布版本
3.snapshots 镜像版本,说白了是测试版本
4.group 是将多个仓库整合的意思,统一提供给外界。默认包括上诉3种仓库
第4步 本地项目使用私服
到maven的conf目录下,配置settings.xml文件
找到mirrors节点,添加mirror节点。该配置指定maven下载使用的repository,也就是我们的私服
<mirrors>
<!-- mirror
| Specifies a repository mirror site to use instead of a given repository. The repository that
| this mirror serves has an ID that matches the mirrorOf element of this mirror. IDs are used
| for inheritance and direct lookup purposes, and must be unique across the set of mirrors.
|
<mirror>
<id>mirrorId</id>
<mirrorOf>repositoryId</mirrorOf>
<name>Human Readable Name for this Mirror.</name>
<url>http://my.repository.com/repo/path</url>
</mirror>
-->
<mirror>
<id>nexus</id>
<mirrorOf>central</mirrorOf>
<name>internal nexus repository</name>
<url>http://192.168.7.52:8081/repository/maven-public/</url>
</mirror>
</mirrors>
至此,你的maven项目,已经会自动从私服下下载。
第5步,上传二方包到私服
第2方包,是指自研的jar包,合作公司提供的jar包。它们自然不能从中央仓库获取到,项目往往需要将它们进行管理,方便内部使用。
maven的setting.xml上,查找servers节点,添加配置
<servers>
<!-- server
| Specifies the authentication information to use when connecting to a particular server, identified by
| a unique name within the system (referred to by the 'id' attribute below).
|
| NOTE: You should either specify username/password OR privateKey/passphrase, since these pairings are
| used together.
|
<server>
<id>deploymentRepo</id>
<username>repouser</username>
<password>repopwd</password>
</server>
-->
<server>
<id>nexus-releases</id>
<username>admin</username>
<password>admin123</password>
</server>
<server>
<id>nexus-snapshots</id>
<username>admin</username>
<password>admin123</password>
</server>
<!-- Another sample, using keys to authenticate.
<server>
<id>siteServer</id>
<privateKey>/path/to/private/key</privateKey>
<passphrase>optional; leave empty if not used.</passphrase>
</server>
-->
</servers>
该配置授信认证
在pom.xml上添加配置
<distributionManagement>
<repository>
<id>nexus-releases</id>
<name>Nexus Release Repository</name>
<url>http://192.168.7.52:8081/repository/maven-releases/</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
<snapshotRepository>
<id>nexus-snapshots</id>
<name>Nexus snapshots Repository</name>
<url>http://192.168.7.52:8081/repository/maven-snapshots/</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</snapshotRepository>
</distributionManagement>
id一定要和setting.xml的server的id保持一致
veison后缀是-SNAPSHOT,代表是snapshot包,会上传到maven-snapshots,否则会上传到maven-releases.
上传到maven-snapshot的jar包,会自动带上时间戳,这样相同groupid,artifactid,version的包,就有多个。而release就会新的替换旧的。
执行maven deploy -U
有时候,获取到合作方的jar包,需要直接上传到私服,那么要手动执行
mvn deploy:deploy-file -DgroupId=www.hjq.cn -DartifactId=test -Dversion=1.0 -Dpackaging=jar -Dfile=test.jar -Durl=http://192.168.7.52:8081/repository/maven-releases/ -DrepositoryId=nexus-releases
快照snopshot
mvn deploy:deploy-file -DgroupId=www.hjq.cn -DartifactId=test -Dversion=1.0-SNAPSHOT -Dpackaging=jar -Dfile=test.jar -Durl=http://192.168.7.52:8081/repository/maven-snapshots/ -DrepositoryId=nexus-snapshots
DgroupId和DartifactId构成了该jar包在pom.xml的坐标,项目就是依靠这两个属性定位。自己起名字也行。
Dfile表示需要上传的jar包的绝对路径。
Durl私服上仓库的位置,打开nexus——>repositories菜单,可以看到该路径。
DrepositoryId服务器的表示id,在nexus的configuration可以看到。
Dversion表示版本信息,怎样得到一个jar包准确的版本呢?
解压该包,会发现一个叫MANIFEST.MF的文件,这个文件就有描述该包的版本信息。
比如Manifest-Version: 1.0可以知道该包的版本了。