发布制品到私服 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 库。

  1. 部署到 snapshot 仓库时,jar 包会带上时间戳;maven 会自动取相应版本最新的jar包

  2. 重复部署 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,不允许覆盖更新组件。

解决办法:升级一下版本号,再发布即可。