公司在自己的局域网内搭建自己的远程仓库服务器,称为私服,私服服务器即是公司内部的maven远程仓库,每个员工的电脑上安装maven软件并且连接私服服务器,员工将自己开发的项目打成jar并发布到私服服务器,其它项目组从私服服务器下载所依赖的构件(jar)。私服还充当一个代理服务器,当私服上没有jar包会从互联网中央仓库自动下载,如下图:
Nexus 是Maven仓库管理器,通过nexus可以搭建maven仓库,同时nexus还提供强大的仓库管理功能,构件搜索功能等。
nexus下载
下载地址:http://www.sonatype.org/nexus/archived/
下载后解压nexus-2.12.0-01-bundle.zip
可以将nexus-2.12.0-01理解成是一个tomcat
将sonatype-work理解成是一个web项目。
Nexus安装cmd进入bin目录,执行nexus.bat install
安装成功在服务中查看有nexus服务:
卸载nexus
cmd进入nexus的bin目录,执行:nexus.bat uninstall
查看window服务列表nexus已被删除。
启动nexus
方法1:
cmd进入bin目录,执行nexus.bat start
方法2:
直接启动nexus服务
查看nexus的配置文件conf/nexus.properties
# Jetty section
application-port=8081 # nexus的访问端口配置
application-host=0.0.0.0 # nexus主机监听配置(不用修改)
nexus-webapp=${bundleBasedir}/nexus # nexus工程目录
nexus-webapp-context-path=/nexus # nexus的web访问路径
# Nexus section
nexus-work=${bundleBasedir}/../sonatype-work/nexus # nexus仓库目录
runtime=${bundleBasedir}/nexus/WEB-INF # nexus运行程序目录
启动服务,可以访问http://localhost:8081/nexus/
使用Nexus 内置账户admin/admin123登陆:
点击右上角的Log in,输入账号和密码 登陆
关于私服仓库类型
1.hosted,宿主仓库,部署自己的jar到这个类型的仓库,包括releases/正式版和snapshot/测试版两部分,Releases公司内部发布版本仓库、 Snapshots 公司内部测试版本仓库
2.proxy,代理仓库,用于代理远程的公共仓库,如maven中央仓库,用户连接私服,私服自动去中央仓库下载jar包或者插件。
3.group,仓库组,用来合并多个hosted/proxy仓库,通常我们配置自己的maven连接仓库组。
4.virtual(虚拟):兼容Maven1 版本的jar或者插件
nexus仓库默认在sonatype-work目录中:
central:代理仓库,代理中央仓库
apache-snapshots:代理仓库
存储snapshots构件,代理地址https://repository.apache.org/snapshots/
central-m1:virtual类型仓库,兼容Maven1 版本的jar或者插件
releases:本地仓库,存储releases构件。
snapshots:本地仓库,存储snapshots构件。
thirdparty:第三方仓库
public:仓库组
使用私服
搜索构件
私服可以作为代理仓库,比如代理中央仓库,通过私服可以搜索中央仓库中的构件, nexus提供搜索中央仓库构件的功能,比如:输入junit可以搜索出所有junit的版本。
创建索引
nexus是基于全文检索技术搜索构件,全文检索需要索引文件才可搜索,首先需要创建索引,创建索引方法如下:
1、自动下载
将central 中央仓库自动创建索引开关打开,这样nexus自动可以从中央仓库下载索引文件。
执行:
update index
2、手动下载
从中央仓库下载索引,手动拷贝到nexus工作目录。
下载地址:http://repo.maven.apache.org/maven2/.index/
下载如下文件:
从网上下载:indexer-cli-5.1.0.jar
将这三者放在一个文件夹,cmd执行:
java -jar indexer-cli-5.1.0.jar -u nexus-maven-repository-index.gz -d indexer
会自动在本目录生成索引文件目录,如下图:
将上图的索引文件目录拷贝至:sonatype-work\nexus\indexer\central-ctx
重启nexus:
搜索构件
索引创建完毕,进入nexus界面搜索构件:
查看构件的坐标:
向私服上传
企业中多个团队协作开发通常会将一些公用的组件、开发模块等发布到私服供其它团队或模块开发人员使用。
第一步: 需要在客户端 maven环境 settings.xml 配置连接私服的用户和密码
Setting文件中配置私服,id是私服中仓库的ID,用户名密码。
releases 连接发布版本项目仓库
snapshots 连接测试版本项目仓库
1.在maven的settings.xml文件中配置
<server>
<id>releases</id>
<username>admin</username>
<password>admin123</password>
</server>
<server>
<id>snapshots</id>
<username>admin</username>
<password>admin123</password>
</server>
第二步
2.在pom.xml文件中配置
指定私服的地址和仓库名
<distributionManagement>
<repository>
<id>releases</id>
<url>http://localhost:8081/nexus/content/repositories/releases/</url>
</repository>
<snapshotRepository>
<id>snapshots</id>
<url>http://localhost:8081/nexus/content/repositories/snapshots/</url>
</snapshotRepository>
</distributionManagement>
注意:pom.xml这里<id> 和 settings.xml 配置 <id> 对应!
第三步: 将项目发布到私服 mvn deploy 命令
1、首先启动nexus
2、将项目发布到nexus,执行deploy
在项目的pom.xml上run as 上传到私服。
将项目上传到私服Mvn deploy
根据本项目pom.xml中version定义决定发布到哪个仓库,如果version定义为snapshot,执行deploy后查看nexus的snapshot仓库,如果version定义为release则项目将发布到nexus的release仓库,本项目将发布到snapshot仓库:
也可以通过http方式查看:
从私服下载jar包
没有配置nexus之前,如果本地仓库没有,去中央仓库下载,通常在企业中会在局域网内部署一台私服服务器,程序员连接私服从私服下载jar包,这样做的好处是一方面由私服对公司项目的依赖统一管理,一方面提高下载速度,毕竟局域网速度比公网快。
管理仓库组
nexus中包括很多仓库,hosted中存放的是企业自己发布的或第三方的jar,proxy中存放的是中央仓库的jar,为了方便从私服下载jar包可以将多个仓库组成一个仓库组,项目通过连接nexus的仓库组下载jar包。
打开nexus配置仓库组:
上图中仓库组包括了本地仓库、代理仓库等。
Setting文件中配置镜像
在maven的setting.xml文件中配置mirror镜像,镜像地址为nexus仓库组的地址,本地项目当需要下载依赖时,先查看本地仓库如果没有则从镜像下载,镜像没有从中央仓库下载,镜像相当于一个代理。
镜像地址为nexus仓库组的地址:
<mirror>
<!--镜像id,mirrors中可以配置多个镜像,保证id不重复-->
<id>nexus</id>
<!--mirrorOf指定仓库id,仓库组包括了id为 releases、snapshots、thirdparty 、central 的仓库,可以配置具体的id,如果镜像所有的仓库则设置为*-->
<mirrorOf>*</mirrorOf>
<!--镜像地址-->
<url>http://localhost:8081/nexus/content/groups/public/</url>
</mirror>
*代表仓库组中的所有仓库,会从所有的仓库中找。
测试:
项目pom.xml添加依赖一个本地仓库和私服都没有jar包,maven先从本地仓库找,本地仓库没有再从私服找,私服没有再去中央仓库下载,下载成功jar在私服、本地仓库分别存储一份。