1. 什么是 Nexus
Nexus 是一个强大的仓库管理器,极大地简化了内部仓库的维护和外部仓库的访问。
2016 年 4 月 6 日 Nexus 3.0 版本发布,相较 2.x 版本有了很大的改变:
- 对低层代码进行了大规模重构,提升性能,增加可扩展性以及改善用户体验。
- 升级界面,极大的简化了用户界面的操作和管理。
- 提供新的安装包,让部署更加简单。
- 增加对 Docker, NeGet, npm, Bower 的支持。
- 提供新的管理接口,以及增强对自动任务的管理。
2. Docker搭建Nexus服务器
演示环境及内容为:Centos7、Docker1.13.1、Nexus3、Docker-compose1.25.5。
2.1. Nexus服务器安装
第一步:使用docker命令,从中央仓库拉取Nexus3镜像。
docker pull sonatype/nexus3
第二步:创建Nexus数据存放目录,如:/usr/local/docker/nexus/data
第三步:在上面创建的nexus目录中,创建docker-compose.yml文件,编写容器创建命令和端口映射,添加内容如下:
version: '3.1'
services:
nexus:
restart: always
image: sonatype/nexus3
container_name: nexus
ports:
- 8081:8081
volumes:
- /usr/local/docker/nexus/data:/nexus-data
第四步:给第二步中创建的data目录赋予读写权限,执行命令如下:
chmod 777 /usr/local/docker/nexus/data
第五步:在nexus目录下执行启动命令,启动nexus服务(-d:后台启动)。
docker-compose up
注:查看日志,如果发现有权限问题不能启动成功,执行下面操作,再重试。
1、修改/etc/selinux/config 文件
2、将SELINUX=enforcing改为SELINUX=disabled
3、reboot重启机器即可
2.2. 登录Nexus服务界面
第一步:在浏览器中输入地址:ip:8081,访问。出现下图所示,表示服务启动成功。
第二步:在映射的宿主机地址/usr/local/docker/nexus/data目录下找到admin.password文件,打开这个文件,里面存放的是nexus登录的初始密码,用户名为:admin。
第三步:输入用户名和密码,登录成功。
3. Maven仓库介绍
3.1. 代理仓库(Proxy Repository)
第三方仓库,如:maven-central、nuget.org-proxy
版本策略(Version Policy):
Release: 正式版本
Snapshot: 快照版本
Mixed: 混合模式
布局策略(Layout Policy):
Strict:严格
Permissive:宽松
3.2. 宿主仓库(Hosted Repository)
存储本地上传的组件和资源的:
maven-releases
maven-snapshots
nuget-hosted
部署策略(Deployment Policy):
Allow Redeploy:允许重新部署
Disable Redeploy:禁止重新部署
Read-Only:只读
3.3. 仓库组(Repository Group)
通常包含了多个代理仓库和宿主仓库,在项目中只要引入仓库组就可以下载到代理仓库和宿主仓库中的包,如:maven-public、nuget-group。
4. 项目中Maven私服的使用
4.1. Snapshots 与 Releases 的区别
nexus-releases: 用于发布 Release 版本
nexus-snapshots: 用于发布 Snapshot 版本(快照版)
在项目 pom.xml 中设置的版本号添加 SNAPSHOT 标识的都会发布为 SNAPSHOT 版本,没有 SNAPSHOT 标识的都会发布为 RELEASE 版本。
SNAPSHOT 版本会自动加一个时间作为标识,如:1.0.0-SNAPSHOT 发布后为变成 1.0.0-SNAPSHOT-20180522.123456-1.jar
4.2. 配置认证信息
在 Maven的settings.xml文件中的servers 节点下添加 Nexus 认证信息(注意这里的password为修改之后的密码):
<server>
<id>nexus-releases</id>
<username>admin</username>
<password>admin</password>
</server>
<server>
<id>nexus-snapshots</id>
<username>admin</username>
<password>admin</password>
</server>
4.3. 自动化部署到仓库
第一步:在Maven项目的pom.xml文件中,添加如下配置:
<distributionManagement>
<repository>
<id>nexus-releases</id>
<name>Nexus Release Repository</name>
<url>http://ip:8081/repository/maven-releases/</url>
</repository>
<snapshotRepository>
<id>nexus-snapshots</id>
<name>Nexus Snapshot Repository</name>
<url>http://ip:8081/repository/maven-snapshots/</url>
</snapshotRepository>
</distributionManagement>
注意事项:
1、ID 名称必须要与 settings.xml 中 Servers 配置的 ID 名称保持一致。
2、项目版本号中有 SNAPSHOT 标识的,会发布到 Nexus Snapshots Repository, 否则发布到 Nexus Release Repository,并根据 ID 去匹配授权账号。
第二步:执行命令,部署到仓库。
mvn deploy -Dmaven.test.skip=true
4.4. 上传第三方jar包
可使用 maven 命令,也可以使用Nexus界面进行上传:
# 如第三方JAR包:dubbo-2.8.4.jar
mvn deploy:deploy-file -DgroupId=com.alibaba -DartifactId=dubbo -Dversion=2.8.4 -Dpackaging=jar -Dfile=D:\ dubbo-2.8.4.jar -Durl=http://ip:8081/repository/ maven-releases/ -DrepositoryId=nexus-releases
注意事项:
1、建议在上传第三方 JAR 包时,创建单独的第三方 JAR 包管理仓库,便于管理有维护。(maven-3rd)
2、-DrepositoryId=nexus-releases 对应的是 settings.xml 中 Servers 配置的 ID 名称。(授权)
4.5. Maven项目配置代理仓库
在Maven项目的pom.xml中配置代理仓库,项目会自动在nexus私服中拉取jar包依赖到本地。
<repositories>
<repository>
<id>nexus</id>
<name>Nexus Repository</name>
<url>http://ip:8081/repository/maven-public/</url>
<snapshots>
<enabled>true</enabled>
</snapshots>
<releases>
<enabled>true</enabled>
</releases>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>nexus</id>
<name>Nexus Plugin Repository</name>
<url>http://ip:8081/repository/maven-public/</url>
<snapshots>
<enabled>true</enabled>
</snapshots>
<releases>
<enabled>true</enabled>
</releases>
</pluginRepository>
</pluginRepositories>
文档下载地址:
https://wenku.baidu.com/view/aced70251cb91a37f111f18583d049649b660ea9