Nexus可以用来管理二进制制品,如果是Java的应用,则可以与Apache Maven结合使用进行二进制制品的部署,这篇文章使用简单的示例来对使用方法进行说明。
Apache Maven Deploy Plugin
构建结束之后,使用Apache Maven Deploy Plugin可以将构建所生成的二进制制品添加至远端仓库以便其他开发者和项目所共享。这种情况一般有如下的使用场景:
- 此二进制制品(通常是jar文件)是项目其他部分所依赖的组件
- 此二进制制品可能是第三方提供的jar文件,为项目所需要使用的组件
由于仓库管理的内容并不仅仅包含二进制制品,同时可能会包含POM文件和metadata等其他信息,而这些都会在Apache Maven Deploy Plugin中得到保证。
使用方式
Apache Maven Deploy Plugin主要有如下两种使用方式:
-
deploy:deploy
-
deploy:deploy-file
Nexus的制品上传
早前的Nexus3的版本中并没有提供二进制制品的上传功能,此项功能特性为3.9版本之后添加,如果使用的是诸如3.2.1这样早期的版本,则可以考虑结合mvn deploy来实现二进制制品的上传。
事前准备
代码准备
事前准备spring boot的demo代码,只需要创建相关目录以及2个文件(pom.xml和java文件)
~ # mkdir demo
~ # cd demo
~/demo # vi pom.xml
~/demo # ls
pom.xml
~/demo # mkdir -p src/main/java/com/liumiaocn/springbootdemo
~/demo # cd src/main/java/com/liumiaocn/springbootdemo
~/demo/src/main/java/com/liumiaocn/springbootdemo # vi SpringbootdemoApplication.java
~/demo/src/main/java/com/liumiaocn/springbootdemo # cd ~/demo
~/demo # ls
pom.xml src
~/demo #
详细参看如下文章:
- https://blog.csdn.net/liumiaocn/article/details/83548217
Maven环境
设定Maven环境,版本依赖要求Maven版本>3.0.0,此处为3.5.2
~/demo # mvn --version
Apache Maven 3.5.2 (138edd61fd100ec658bfa2d307c43b76940a5d7d; 2017-10-18T15:58:13+08:00)
Maven home: /usr/local/share/maven
Java version: 1.8.0_121, vendor: Oracle Corporation
Java home: /usr/lib/java-8-oracle/jre
Default locale: en_US, platform encoding: ANSI_X3.4-1968
OS name: "linux", version: "3.10.0-957.el7.x86_64", arch: "amd64", family: "unix"
~/demo #
Nexus环境
使用docker镜像方式启动Nexus的3.16.1版本的服务。docker-compose.yml信息如下所示:
version: '2'
services:
# Repository service: Nexus
nexus:
image: sonatype/nexus3:3.16.1
ports:
- "32004:8081"
volumes:
- /home/local/nexus/data/:/nexus-data
environment:
- JAVA_MAX_MEN=512m
- JAVA_MIN_MEN=128m
restart: "no"
Maven私库
设定Nexus的hosttyped的Maven私库,详细可参看:
- https://blog.csdn.net/liumiaocn/article/details/61931847
上述示例使用版本为3.2.1,本文使用示例为3.16.1,但使用方式相差无几
私库设定
连接Nexus私库需要设定用户名和密码,否则会提示Return code is: 401, ReasonPhrase: Unauthorized认证失败的信息。以下为未设定情况下的错误提示信息示例
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-deploy-plugin:2.8.2:deploy-file (default-cli) on project springbootdemo: Failed to deploy artifacts: Could not transfer artifact com.liumiaocn:springbootdemo:jar:0.0.1-20190522.114757-1 from/to nexus-repo (http://192.168.163.141:32004/repository/mvnhosted/): Failed to transfer file: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.1-SNAPSHOT/springbootdemo-0.0.1-20190522.114757-1.jar. Return code is: 401, ReasonPhrase: Unauthorized. -> [Help 1]
设定信息:在settings.xml的servers段中添加如下Nexus连接信息
<server>
<id>nexus-repo</id>
<username>admin</username>
<password>admin123</password>
</server>
deploy:deploy-file方式
命令行示例:
mvn package deploy:deploy-file -DgroupId=com.liumiaocn
-DartifactId=springbootdemo
-Dversion=0.0.1-SNAPSHOT
-Dpackaging=jar
-Dfile=target/springbootdemo-0.0.1-SNAPSHOT.jar
-DgeneratePom=true
-DrepositoryId=nexus-repo
-Durl=http://192.168.163.141:32004/repository/mvnhosted/
- 执行日志示例
~/demo # ls
pom.xml src
~/demo # pwd
/root/demo
~/demo # mvn package deploy:deploy-file -DgroupId=com.liumiaocn \
> -DartifactId=springbootdemo \
> -Dversion=0.0.1-SNAPSHOT \
> -Dpackaging=jar \
> -Dfile=target/springbootdemo-0.0.1-SNAPSHOT.jar \
> -DgeneratePom=true \
> -DrepositoryId=nexus-repo \
> -Durl=http://192.168.163.141:32004/repository/mvnhosted/
[INFO] Scanning