发布制品到私服 Nexus
1. 概述
在项目中,有些通用的代码模块,有时候不想通过拷贝这么简单的方式粗暴地实现复用。因为这样不仅体现不了 jar 包的 class 变更的实时性,而且也不利于 jar 统一管理。使用maven deploy的方式,将通用的模块打成 jar 包,发布到 Nexus 服务,让其他的项目来引用,以简洁、高效的方式来实现 jar 复用和管理。
2. maven 的 settings.xml 文件中设置标签
找到 Maven 安装目录的settings.xml文件
C:\devtools\maven-3.5.0\conf\settings.xml
添加如下配置
deploy-release
admin
admin123
deploy-snapshot
admin
admin123
此处,是设置的账号和密码都是 Nexus 服务的登录的账号和密码
3. 配置项目的 pom.xml 文件
在项目的 pom.xml 文件添加如下配置
nexus-releases
Nexus Release Repository
http://127.0.0.1:8081/repository/maven-releases/
nexus-snapshots
Nexus Snapshot Repository
http://127.0.0.1:8081/repository/maven-snapshots/
这里的 IP 地址127.0.0.1 需要根据具体情况换成对应的 IP 地址。点开下图框住的仓库,即可找到这两个仓库地址。
另外,中的要和的一致,maven 在发布时,会根据此 id 来查找相应的账号密码进行登录验证并上传文件。
4. 发布 jar 到 Nexus 服务
在项目的更目录,执行如下命令
mvn deploy
出入以下信息表示发布成功
[INFO] Uploaded: http://127.0.0.1:8081/repository/maven-snapshots/com/omg/olive-web/0.0.1-SNAPSHOT/olive-web-0.0.1-20220319.104535-1.pom (1.4 kB at 2.6 kB/s)
[INFO] Downloading: http://127.0.0.1:8081/repository/maven-snapshots/com/omg/olive-web/maven-metadata.xml
[INFO] Uploading: http://127.0.0.1:8081/repository/maven-snapshots/com/omg/olive-web/0.0.1-SNAPSHOT/maven-metadata.xml
[INFO] Uploaded: http://127.0.0.1:8081/repository/maven-snapshots/com/omg/olive-web/0.0.1-SNAPSHOT/maven-metadata.xml (766 B at 2.5 kB/s)
[INFO] Uploading: http://127.0.0.1:8081/repository/maven-snapshots/com/omg/olive-web/maven-metadata.xml
[INFO] Uploaded: http://127.0.0.1:8081/repository/maven-snapshots/com/omg/olive-web/maven-metadata.xml (276 B at 938 B/s)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 8.125 s
[INFO] Finished at: 2022-03-19T18:45:38+08:00
[INFO] Final Memory: 15M/37M
[INFO] ------------------------------------------------------------------------
在 Nexus 服务也看到发布的 jar 包
5. 发布的灵活配置
maven 会判断版本后面是否带了-SNAPSHOT,如果带了就发布到 snapshots 仓库,否则发布到 release 仓库。这里可以在 pom.xm l文件中,设置
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
4.0.0
com.omg
olive-web
${project.release.version}
jar
olive-web
1.8
UTF-8
1.0.0-SNAPSHOT
product
1.0.0
deploy-release
Nexus Release Repository
http://127.0.0.1:8081/repository/maven-releases/
deploy-snapshot
Nexus Snapshot Repository
http://127.0.0.1:8081/repository/maven-snapshots/
通过占位符 ${project.release.version}来控制需要发布的版本,用命令mvn deploy -P product,发布olive-web 的 1.0 版本到 releases 库。如果使用命令 mvn deploy,则默认使用 1.0.0-SNAPSHOT 版本号,将发布 olive-web 的 1.0.0-SNAPSHOT 版本到 snapshots 库。
附
-
部署到 snapshot 仓库时,jar 包会带上时间戳;maven 会自动取相应版本最新的jar包
-
重复部署 release 报错
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-deploy-plugin:2.7:deploy (default-deploy) on project olive-web: Failed to deploy artifacts: Could not transfer artifact com.omg:olive-web:jar:1.0.0 from/to deploy-release (http://127.0.0.1:8081/repository/maven-releases/): Failed to transfer file: http://127.0.0.1:8081/repository/maven-releases/com/omg/olive-web/1.0.0/olive-web-1.0.0.jar. Return code is: 400, ReasonPhrase: Repository does not allow updating assets: maven-releases. -> [Help 1]
部署 release 仓库时,相同版本的 jar 包不能提交。因为 release 的部署策略是disable redeploy,不允许覆盖更新组件。
解决办法:升级一下版本号,再发布即可。