Nexus 可以用来管理二进制制品,如果是 Java 的应用,则可以与 Apache Maven 结合使用进行二进制制品的部署,这篇文章使用简单的示例来对使用方法进行说明。
构建结束之后,使用Apache Maven Deploy Plugin可以将构建所生成的二进制制品添加至远端仓库以便其他开发者和项目所共享。这种情况一般有如下的使用场景:
Apache Maven Deploy Plugin主要有如下两种使用方式:
早前的 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 #
详细参看如下文章:
设定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 #
使用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"
设定Nexus的hosttyped的Maven私库,详细可参看:
上述示例使用版本为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>
命令行示例: 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 for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building springbootdemo 0.0.1-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- maven-resources-plugin:3.0.2:resources (default-resources) @ springbootdemo ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] skip non existing resourceDirectory /root/demo/src/main/resources
[INFO] skip non existing resourceDirectory /root/demo/src/main/resources
[INFO]
[INFO] --- maven-compiler-plugin:3.7.0:compile (default-compile) @ springbootdemo ---
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 1 source file to /root/demo/target/classes
[INFO]
[INFO] --- maven-resources-plugin:3.0.2:testResources (default-testResources) @ springbootdemo ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] skip non existing resourceDirectory /root/demo/src/test/resources
[INFO]
[INFO] --- maven-compiler-plugin:3.7.0:testCompile (default-testCompile) @ springbootdemo ---
[INFO] No sources to compile
[INFO]
[INFO] --- maven-surefire-plugin:2.21.0:test (default-test) @ springbootdemo ---
[INFO] No tests to run.
[INFO]
[INFO] --- maven-jar-plugin:3.0.2:jar (default-jar) @ springbootdemo ---
[INFO] Building jar: /root/demo/target/springbootdemo-0.0.1-SNAPSHOT.jar
[INFO]
[INFO] --- spring-boot-maven-plugin:2.0.6.RELEASE:repackage (default) @ springbootdemo ---
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building springbootdemo 0.0.1-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- maven-deploy-plugin:2.8.2:deploy-file (default-cli) @ springbootdemo ---
Downloading from nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.1-SNAPSHOT/maven-metadata.xml
Uploading to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.1-SNAPSHOT/springbootdemo-0.0.1-20190522.122144-1.jar
Uploaded to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.1-SNAPSHOT/springbootdemo-0.0.1-20190522.122144-1.jar (16 MB at 5.7 MB/s)
Uploading to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.1-SNAPSHOT/springbootdemo-0.0.1-20190522.122144-1.pom
Uploaded to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.1-SNAPSHOT/springbootdemo-0.0.1-20190522.122144-1.pom (409 B at 942 B/s)
Downloading from nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/maven-metadata.xml
Uploading to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.1-SNAPSHOT/maven-metadata.xml
Uploaded to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.1-SNAPSHOT/maven-metadata.xml (777 B at 2.8 kB/s)
Uploading to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/maven-metadata.xml
Uploaded to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/maven-metadata.xml (287 B at 1.3 kB/s)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 15.337 s
[INFO] Finished at: 2019-05-22T20:21:48+08:00
[INFO] Final Memory: 29M/111M
[INFO] ------------------------------------------------------------------------
~/demo #
而在Nexus所创建的Maven的仓库中也可以看到刚刚上传的文件, 除了jar文件之外还有sha1和md5的校验信息文件,由于generatePom设定为了true,因此还生成了pom.xml文件和相关的校验文件,详细信息如下图所示。
在实际的情况下,更多则是二进制制品本身需要带pom.xml或者不带的情况,一般也可以使用-DpomFile=pom.xml用于指定特定的pom文件。如果仅仅上传二进制制品的情况下,可根据实际的使用需要进行调整,只需将generatePom设定为false即可。这里为了演示方便,此处将Version修改为0.0.2
~/demo # mvn clean package deploy:deploy-file -DgroupId=com.liumiaocn \
> -DartifactId=springbootdemo \
> -Dversion=0.0.2-SNAPSHOT \
> -Dpackaging=jar \
> -Dfile=target/springbootdemo-0.0.2-SNAPSHOT.jar \
> -DgeneratePom=false \
> -DrepositoryId=nexus-repo \
> -Durl=http://192.168.163.141:32004/repository/mvnhosted/
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building springbootdemo 0.0.2-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- maven-clean-plugin:3.0.0:clean (default-clean) @ springbootdemo ---
[INFO] Deleting /root/demo/target
[INFO]
[INFO] --- maven-resources-plugin:3.0.2:resources (default-resources) @ springbootdemo ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] skip non existing resourceDirectory /root/demo/src/main/resources
[INFO] skip non existing resourceDirectory /root/demo/src/main/resources
[INFO]
[INFO] --- maven-compiler-plugin:3.7.0:compile (default-compile) @ springbootdemo ---
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 1 source file to /root/demo/target/classes
[INFO]
[INFO] --- maven-resources-plugin:3.0.2:testResources (default-testResources) @ springbootdemo ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] skip non existing resourceDirectory /root/demo/src/test/resources
[INFO]
[INFO] --- maven-compiler-plugin:3.7.0:testCompile (default-testCompile) @ springbootdemo ---
[INFO] No sources to compile
[INFO]
[INFO] --- maven-surefire-plugin:2.21.0:test (default-test) @ springbootdemo ---
[INFO] No tests to run.
[INFO]
[INFO] --- maven-jar-plugin:3.0.2:jar (default-jar) @ springbootdemo ---
[INFO] Building jar: /root/demo/target/springbootdemo-0.0.2-SNAPSHOT.jar
[INFO]
[INFO] --- spring-boot-maven-plugin:2.0.6.RELEASE:repackage (default) @ springbootdemo ---
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building springbootdemo 0.0.2-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- maven-deploy-plugin:2.8.2:deploy-file (default-cli) @ springbootdemo ---
Downloading from nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.2-SNAPSHOT/maven-metadata.xml
Uploading to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.2-SNAPSHOT/springbootdemo-0.0.2-20190522.122713-1.jar
Uploaded to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.2-SNAPSHOT/springbootdemo-0.0.2-20190522.122713-1.jar (16 MB at 4.7 MB/s)
Downloading from nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/maven-metadata.xml
Downloaded from nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/maven-metadata.xml (287 B at 1.6 kB/s)
Uploading to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.2-SNAPSHOT/maven-metadata.xml
Uploaded to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.2-SNAPSHOT/maven-metadata.xml (604 B at 5.6 kB/s)
Uploading to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/maven-metadata.xml
Uploaded to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/maven-metadata.xml (327 B at 2.7 kB/s)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 15.198 s
[INFO] Finished at: 2019-05-22T20:27:17+08:00
[INFO] Final Memory: 29M/113M
[INFO] ------------------------------------------------------------------------
~/demo #
可以看到并未生成pom.xml和相关的校验文件信息
在此示例的pom.xml文件中添加如下部署管理distributionManagement相关的信息(加入到projects段中),即可直接通过mvn deploy来进行部署。
<distributionManagement>
<repository>
<id>nexus-repo</id>
<name>Nexus Repository</name>
<url>http://192.168.163.141:32004/repository/mvnhosted/</url>
</repository>
</distributionManagement>
如果不设定此项,执行mvn deploy的时候则会提示repository element was not specified in the POM inside distributionManagement element的错误信息。
此处为了演示方便,同时将Version设定为0.0.3,从如下执行示例日志中可以看到,只需要执行mvn deploy:deploy或者mvn deploy即可完成部署了
~/demo # mvn clean package deploy:deploy
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building springbootdemo 0.0.3-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- maven-clean-plugin:3.0.0:clean (default-clean) @ springbootdemo ---
[INFO] Deleting /root/demo/target
[INFO]
[INFO] --- maven-resources-plugin:3.0.2:resources (default-resources) @ springbootdemo ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] skip non existing resourceDirectory /root/demo/src/main/resources
[INFO] skip non existing resourceDirectory /root/demo/src/main/resources
[INFO]
[INFO] --- maven-compiler-plugin:3.7.0:compile (default-compile) @ springbootdemo ---
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 1 source file to /root/demo/target/classes
[INFO]
[INFO] --- maven-resources-plugin:3.0.2:testResources (default-testResources) @ springbootdemo ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] skip non existing resourceDirectory /root/demo/src/test/resources
[INFO]
[INFO] --- maven-compiler-plugin:3.7.0:testCompile (default-testCompile) @ springbootdemo ---
[INFO] No sources to compile
[INFO]
[INFO] --- maven-surefire-plugin:2.21.0:test (default-test) @ springbootdemo ---
[INFO] No tests to run.
[INFO]
[INFO] --- maven-jar-plugin:3.0.2:jar (default-jar) @ springbootdemo ---
[INFO] Building jar: /root/demo/target/springbootdemo-0.0.3-SNAPSHOT.jar
[INFO]
[INFO] --- spring-boot-maven-plugin:2.0.6.RELEASE:repackage (default) @ springbootdemo ---
[INFO]
[INFO] --- maven-deploy-plugin:2.8.2:deploy (default-cli) @ springbootdemo ---
Downloading from nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.3-SNAPSHOT/maven-metadata.xml
Uploading to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.3-SNAPSHOT/springbootdemo-0.0.3-20190522.130006-1.jar
Uploaded to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.3-SNAPSHOT/springbootdemo-0.0.3-20190522.130006-1.jar (16 MB at 6.3 MB/s)
Uploading to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.3-SNAPSHOT/springbootdemo-0.0.3-20190522.130006-1.pom
Uploaded to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.3-SNAPSHOT/springbootdemo-0.0.3-20190522.130006-1.pom (1.6 kB at 5.0 kB/s)
Downloading from nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/maven-metadata.xml
Downloaded from nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/maven-metadata.xml (327 B at 1.9 kB/s)
Uploading to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.3-SNAPSHOT/maven-metadata.xml
Uploaded to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/0.0.3-SNAPSHOT/maven-metadata.xml (777 B at 3.9 kB/s)
Uploading to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/maven-metadata.xml
Uploaded to nexus-repo: http://192.168.163.141:32004/repository/mvnhosted/com/liumiaocn/springbootdemo/maven-metadata.xml (367 B at 2.1 kB/s)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 14.998 s
[INFO] Finished at: 2019-05-22T21:00:09+08:00
[INFO] Final Memory: 29M/112M
[INFO] ------------------------------------------------------------------------
~/demo #
从Nexus上也可以看到二进制制品上传的结果,详细如下图所示
作者:liumiaocn 原文链接:https://blog.csdn.net/liumiaocn/article/details/90452108