Maven发布到Nexus

1.概述

在本系列的上一篇文章中，我们将Maven设置为Nexus的部署过程 。 在本文中，我们将在项目的pom以及Jenkins作业中使用Maven配置发布过程 。

2.

为了使Maven能够发布到Nexus Repository Server，我们需要通过distributionManagement元素定义存储库信息：

<distributionManagement>
   <repository>
      <id>nexus-releases</id>
      <url>http://localhost:8081/nexus/content/repositories/releases</url>
   </repository>
</distributionManagement>

托管的Release Repository在Nexus上是开箱即用的，因此无需显式创建它。

3. Maven

发布过程将与项目的源代码管理进行交互–这意味着我们首先需要在pom.xml中定义<scm>元素：

<scm>
   <connection>scm:git:https://github.com/user/project.git</connection>
   <url>http://github.com/user/project</url>
   <developerConnection>scm:git:https://github.com/user/project.git</developerConnection>
</scm>

或者，使用git协议：

<scm>
   <connection>scm:git:git@github.com:user/project.git</connection>
   <url>scm:git:git@github.com:user/project.git</url>
   <developerConnection>scm:git:git@github.com:user/project.git</developerConnection>
</scm>

4.发布插件

发布流程使用的标准Maven插件是maven-release-plugin-此插件的配置最少：

<plugin>
   <groupId>org.apache.maven.plugins</groupId>
   <artifactId>maven-release-plugin</artifactId>
   <version>2.4.1</version>
   <configuration>
      <tagNameFormat>v@{project.version}</tagNameFormat>
      <autoVersionSubmodules>true</autoVersionSubmodules>
      <releaseProfiles>releases</releaseProfiles>
   </configuration>
</plugin>

这里重要的是，releaseProfiles配置实际上将强制Maven的轮廓-在释放配置文件-在释放过程变得活跃。

在此过程中，使用nexus-staging-maven-plugin进行部署到nexus-releases Nexus存储库：

<profiles>
   <profile>
      <id>releases</id>
      <build>
         <plugins>
            <plugin>
               <groupId>org.sonatype.plugins</groupId>
               <artifactId>nexus-staging-maven-plugin</artifactId>
               <version>1.4.4</version>
               <executions>
                  <execution>
                     <id>default-deploy</id>
                     <phase>deploy</phase>
                     <goals>
                        <goal>deploy</goal>
                     </goals>
                  </execution>
               </executions>
               <configuration>
                  <serverId>nexus-releases</serverId>
                  <nexusUrl>http://localhost:8081/nexus/</nexusUrl>
                  <skipStaging>true</skipStaging>
               </configuration>
            </plugin>
         </plugins>
      </build>
   </profile>
</profiles>

该插件被配置为在没有部署机制的情况下执行与之前相同的Release流程，用于Deployment流程（ skipStaging = true ）。

而且与部署过程类似，“ 释放到Nexus”是一项安全的操作 -因此，我们将再次使用Nexus的“开箱即用” 部署用户。

我们还需要在全局settings.xml （ ％USER_HOME％/。m2 / settings.xml ）中为nexus-releases服务器配置凭据：

<servers>
   <server>
      <id>nexus-releases</id>
      <username>deployment</username>
      <password>the_pass_for_the_deployment_user</password>
   </server>
</servers>

这是完整的配置

5.发布过程

让我们将发布过程分为几个小步骤和重点突出的步骤。 当项目的当前版本为SNAPSHOT版本（例如0.1-SNAPSHOT）时，我们正在执行发布。

5.1。 释放：干净

清洁发行版将：

• 删除发布描述符（ release.properties ）
• 删除所有备份POM文件

5.2。 发布：准备

发布过程的下一部分是准备发布 ; 这将：

• 执行一些检查–不应有未提交的更改，项目应不依赖于SNAPSHOT依赖项
• 将pom文件中的项目版本更改为完整发行版号（删除SNAPSHOT后缀）–在我们的示例中– 0.1
• 运行项目测试套件
• 提交并推送更改
• 根据此非SNAPSHOT版本代码创建标签
• 在pom中增加项目的版本 -在我们的示例中-0.2-SNAPSHOT
• 提交并推送更改

5.3。 发布：执行

发布过程的后半部分是执行发布 ; 这将：

• 来自SCM的结帐发布标签
• 构建和部署发布的代码

该过程的第二步取决于Prepare步骤的输出– release.properties 。

6.关于詹金斯

Jenkins可以通过以下两种方式之一执行发布过程-它可以使用其自己的发布插件，也可以仅使用标准的maven作业运行正确的发布步骤来执行发布。

专注于发布过程的现有Jenkins插件为：

• 发布插件
• M2发布插件

但是，由于执行发布的Maven命令非常简单，因此我们只需定义一个标准的Jenkins作业即可执行该操作-无需插件。

因此，对于一个新的Jenkins作业（构建一个maven2 / 3项目）–我们将定义2个String参数： releaseVersion = 0.1和developmentVersion = 0.2-SNAPSHOT 。

在“ 构建配置”部分，我们只需配置以下Maven命令即可运行：

release:clean release:prepare release:perform 
   -DreleaseVersion=${releaseVersion} -DdevelopmentVersion=${developmentVersion}

运行参数化作业时，Jenkins将提示用户为这些参数指定值-因此，每次运行作业时，我们都需要为releaseVersion和developmentVersion填写正确的值。

另外，值得使用Workspace Cleanup插件并选中此构建的“ 在构建开始之前删除工作区”选项。 但是请记住，发行版的执行步骤必须由与prepare相同的命令运行 步骤–这是因为后面的执行步骤将使用prepare准备创建的release.properties文件。 这意味着我们不能让Jenkins Job运行准备和另一个运行的Perform 。

7.结论

本文介绍了如何在有或没有Jenkins的情况下发布Maven项目的过程。 与Deployment类似，此过程使用nexus-staging-maven-plugin与Nexus进行交互，并专注于git项目。

参考：我们的JCG合作伙伴 Eugen Paraschiv在baeldung博客上向Nexus发布的Maven 。

翻译自: https://www.javacodegeeks.com/2013/05/maven-release-to-nexus.html