文章目录
Nexus介绍
Nexus是Maven仓库管理器,如果你使用Maven,你可以从Maven中央仓库下载所需要的构件(artifact),但这通常不是一个好的做法,你应该在本地架设一个Maven仓库服务器,在代理远程仓库的同时维护本地仓库,以节省带宽和时间,Nexus就可以满足这样的需要。此外,他还提供了强大的仓库管理功能,构件搜索功能,它基于REST,友好的UI是一个extjs的REST客户端,它占用较少的内存,基于简单文件系统而非数据库。这些优点使其日趋成为最流行的Maven仓库管理器。除此之外,Nexus还可以管理Docker镜像。
注:Maven简介可参考Maven简介
私服的好处
没有私服时:本地仓库没有,则去中央仓库下载
搭建私服后:本地仓库没有,再去私服下载,私服没有,再去中央仓库下载
- 减少网络带宽流量
- 加速Maven构建
- 部署第三方构件
- 提高稳定性、增强控制
- 降低中央仓库的负载
使用Docker安装Nexus私服
注意:请先自行安装Docker
查找Nexus3镜像
docker search nexus3
拉取Nexus3镜像
docker pull sonatype/nexus3
注:最新版本的Nexus3.18在下载依赖时有点问题,建议安装3.17版本的Nexus
具体报错是这样的:Caused by: org.apache.maven.wagon.authorization.AuthorizationException: Not authorized
查看镜像
docker images
运行Nexus容器
#进入/opt目录,创建宿主机挂载目录并设置权限cd /opt
mkdir nexus-data
chown -R 200 nexus-data
#运行nuxus私服# -d:后台运行# -p:将容器内部端口向外映射,第一个参数是宿主机端口,第二个参数容器端口# --name:命名容器名称# --restart always在容器退出时总是重启容器# -v:将容器内配置、日志、数据文件等文件夹挂载到宿主机指定目录docker run -d --name nexus3 -p 8081:8081 --restart always -v /opt/nexus-data:/nexus-data sonatype/nexus3
如果没有设置权限,运行nexus时就会报如下错误
Warning: Cannot open log file: ../sonatype-work/nexus3/log/jvm.logWarning: Forcing option -XX:LogFile=/tmp/jvm.log
Unable to update instance pid: Unable to create directory /nexus-data/instances
/nexus-data/log/karaf.log (No such file or directory)Unable to update instance pid: Unable to create directory /nexus-data/instances
mkdir: cannot create directory '../sonatype-work/nexus3/log': Permission denied
mkdir: cannot create directory '../sonatype-work/nexus3/tmp': Permission denied
OpenJDK 64-Bit Server VM warning: Cannot open file ../sonatype-work/nexus3/log/jvm.log due to No such file or directory
登录Nexus
访问web地址:http://ip:8081
从3.17版本开始默认密码不再是admin123,密码是随机生成。首次登录页面会显示admin用户的密码在/nexus-data/admin.password
注意:我们刚才安装的时候把/nexus-data目录挂载到宿主机的/opt/nexus-data,所以密码在/opt/nexus-data/admin.password
执行命令vim /opt/nexus-data/admin.password,即可查看到如9c3ac7fb-4264-4457-8e48-4aa84c71e7ad这样的密码,然后登录即可。用户名:admin,密码:/opt/nexus-data/admin.password里面的密码
登录后会让用户设置新的密码。这里把用户名和密码设置为admin/admin123
登录后界面如下
默认仓库说明
maven-central:maven中央库,默认从https://repo1.maven.org/maven2/拉取jarmaven-releases:私库发行版jar,初次安装请将Deployment policy设置为Allow redeploy
maven-snapshots:私库快照(调试版本)jar
maven-public:仓库分组,把上面三个仓库组合在一起对外提供服务,在本地maven基础配置settings.xml或项目pom.xml中使用
仓库类型
Group:这是一个仓库聚合的概念,用户仓库地址选择Group的地址,即可访问Group中配置的,用于方便开发人员自己设定的仓库。maven-public就是一个Group类型的仓库,内部设置了多个仓库,访问顺序取决于配置顺序,3.x默认Releases,Snapshots,Central,当然你也可以自己设置。Hosted:私有仓库,内部项目的发布仓库,专门用来存储我们自己生成的jar文件
3rd party:未发布到公网的第三方jar (3.x去除了)Snapshots:本地项目的快照仓库
Releases: 本地项目发布的正式版本
Proxy:代理类型,从远程中央仓库中寻找数据的仓库(可以点击对应的仓库的Configuration页签下Remote Storage属性的值即被代理的远程仓库的路径),如可配置阿里云maven仓库
Central:中央仓库
Apache Snapshots:Apache专用快照仓库(3.x去除了)
配置阿里云公共仓库
Nexus的maven-group的默认查找方式为:maven-releases --> maven-snapshots --> maven-central,我们在中间再加一个阿里云仓库,加快访问速度。
选择proxy类型
信息填写如下
仓库名字:maven-aliyun
阿里云远程maven仓库地址:http://maven.aliyun.com/nexus/content/groups/public/
其他选项:默认即可
修改maven-public中的仓库引用及顺序:
至此,配置完毕!我们在maven使用maven-public仓库地址的时候,会按照如下顺序访问:本地仓库 --> 私服maven-releases --> 私服maven-snapshots --> 远程阿里云maven仓库 --> 远程中央仓库。
Maven配置使用Nexus私服
Maven配置私服下载依赖方式
maven配置私服下载有两种方式
-
setting.xml:该文件配置的是全局模式
-
pom.xml:该文件的配置的是项目独享模式
若pom.xml和setting.xml同时配置了,以pom.xml为准
setting.xml文件配置
这个时候不需要再配置pom.xml文件,即可使用私服下载jar依赖包
配置私服镜像
<mirrors> <mirror> <!--该镜像的唯一标识符。id用来区分不同的mirror元素。 --> <id>nexus-releases</id> <!--*指的是访问任何仓库都使用我们的私服--> <mirrorOf>*</mirrorOf> <!--该镜像的URL。构建系统会优先考虑使用该URL,而非使用默认的服务器URL。 --> <url>http://10.172.0.201:8081/repository/maven-public/</url> </mirror> <mirror> <id>nexus-snapshots</id> <mirrorOf>*</mirrorOf> <url>http://10.172.0.201:8081/repository/maven-snapshots/</url> </mirror> </mirrors>
镜像的URL可以从页面中的copy按钮直接复制
配置从私服下载jar包
<profiles> <profile> <!--profile的id--> <id>nexus</id> <repositories> <repository> <!--仓库id,repositories可以配置多个仓库,保证id不重复--> <id>nexus-releases</id> <!--仓库地址,即nexus仓库组的地址--> <url>http://nexus-releases</url> <releases> <!--是否下载releases构件--> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> <repository> <id>nexus-snapshots</id> <url>http://nexus-snapshots</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <!-- 插件仓库,maven的运行依赖插件,也需要从私服下载插件 --> <pluginRepository> <!-- 插件仓库的id不允许重复,如果重复后边配置会覆盖前边 --> <id>nexus-releases</id> <url>http://nexus-releases</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </pluginRepository> <pluginRepository> <id>nexus-snapshots</id> <url>http://nexus-snapshots</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile> </profiles><!--激活profile--><activeProfiles> <activeProfile>nexus</activeProfile> </activeProfiles>
pom.xml文件配置
如果你配置了pom.xml,则以pom.xml为准
<repositories><repository><id>maven-nexus</id><name>maven-nexus</name><url>http://10.172.0.201:8081/repository/maven-public/</url><releases><enabled>true</enabled></releases><snapshots><enabled>true</enabled></snapshots></repository></repositories>
配置Maven连接私服打包上传项目
第一步,修改setting.xml文件,指定releases和snapshots server的用户名和密码
<servers><server><id>releases</id><username>admin</username><password>admin123</password></server><server><id>snapshots</id><username>admin</username><password>admin123</password></server></servers>
第二步,在项目的pom.xml文件中加入distributionManagement节点
注意:repository里的id需要和第一步里的server id名称保持一致
<distributionManagement><repository><id>releases</id><name>Releases</name><url>http://10.172.0.201:8081/repository/maven-releases/</url></repository><snapshotRepository><id>snapshots</id><name>Snapshot</name><url>http://10.172.0.201:8081/repository/maven-snapshots/</url></snapshotRepository></distributionManagement>
第三步,执行发布
mvn deploy
登录Nexus,查看对应的仓库已经有相关的依赖包了。
注意以下几点:
- 若项目版本号末尾带有 -SNAPSHOT,则会发布到snapshots快照版本仓库
- 若项目版本号末尾带有 -RELEASES 或什么都不带,则会发布到releases正式版本仓库