聊聊项目打包发布到maven私仓常见的几种方式

前言

在早期没有使用maven之前，我们引用一些公有jar或者api jar，我们可能会采用这样的方式，通过手动导入这些jar到项目的classpath路径进行引用。

有了maven后，我们公司内部可能就会搭建maven私仓比如nexus，然后把这些公有jar或者api jar上传到nexus私仓，在pom.xml配置一下这些jar的坐标就可以引用。

今天我们的话题就是来聊聊项目打包发布到maven私仓常见的几种方式

发布到maven私仓的步骤

1.在maven的settings.xml中< servers >节点配置用户名和密码，形如下：

<servers>
    <server>
      <id>nexus-releases</id>
      <username>admin</username>
      <password>admin123</password>
    </server>
    <server>
      <id>nexus-snapshots</id>
      <username>admin</username>
      <password>admin123</password>
    </server>
    </servers>

注： 其中id可先看做是一个标识。username和password为nexus私仓的用户名和密码

2、指定发布到nexus私仓的url并进行发布

方式一：pom.xml文件添加distributionManagement节点

形如下：

 <distributionManagement>
         <!--正式版本-->
        <repository>
            <!-- 在settings.xml中<server>的id-->
            <id>nexus-releases</id>
            <url>http://192.168.0.11:8081/nexus/content/repositories/releases/</url>
        </repository>

         <!--快照版本-->
        <snapshotRepository>
             <id>nexus-snapshots</id>
             <url>http://192.168.0.11:8081/nexus/content/repositories/snapshots/</url>
        </snapshotRepository>
    </distributionManagement>

注：

• 如果存在parent，只需在parent中的pom.xml中配置，没有则在本项目的pom.xml配置即可
• < repository >节点下的< id >对应maven的配置文件settings.xml文件中的server的id，两者必须保持一致
• 上传到私仓的是正式版本还是快照版本，取决于pom.xml文件version中是SNAPSHOT还是RELEASE。比如你项目中配置如下

<groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>

则上传到私仓的就是快照版本

最后执行maven的deploy命令进行发布

方式二：在maven的settings.xml中< profiles >节点配置< properties >，并在< properties >指定 < altSnapshotDeploymentRepository > 和< altReleaseDeploymentRepository >

形如下：

<profiles>
     <profile>
     <id>nexus</id>
     <properties>
         <altSnapshotDeploymentRepository>
             nexus-snapshots::default::http://192.168.0.11:8081/repository/maven-snapshots/
         </altSnapshotDeploymentRepository>
         <altReleaseDeploymentRepository>
            nexus-releases::default::http://192.168.0.11:8081/repository/maven-releases/
         </altReleaseDeploymentRepository>
     </properties>
    </profile>
  </profiles>
  <activeProfiles>
    <activeProfile>nexus</activeProfile>
  </activeProfiles>

注：

• nexus-snapshots和 nexus-releases要和maven的配置文件settings.xml文件中的server的id，两者必须保持一致
• 属性altSnapshotDeploymentRepository和altReleaseDeploymentRepository是随maven-release-plugin 2.8版一起引入的。低于2.8版本，执行mvn deploy时，则会报如下错误

Deployment failed: repository element was not specified in the POM inside distributionManagement element or in -DaltDeploymentRepository=id::layout::url parameter

解决方案就是在发布的项目中指定一下2.8版本以上的插件，形如下

<build>
        <plugins>
            <plugin>
                <artifactId>maven-deploy-plugin</artifactId>
                <version>2.8.2</version>
            </plugin>
        </plugins>
    </build>

最后再执行maven的deploy命令进行发布

方式三：通过mvn deploy指定参数

• 方法一：通过-D参数指定altSnapshotDeploymentRepository和altReleaseDeploymentRepository

形如下

mvn deploy -DskipTests -DaltSnapshotDeploymentRepository=nexus-snapshots::default::https://YOUR_NEXUS_URL/snapshots
-DaltReleaseDeploymentRepository=nexus-releases::default::https://YOUR_NEXUS_URL/releases

同理上述命令要执行成功，得确保deploy插件是基于2.8版本以上

• 方法二：通过-D指定要发布的jar的相关信息以及私仓地址，私仓id，私仓id要和settings.xml文件中的server的id保持一致

形如下

mvn deploy:deploy-file -DskipTests -Dfile=jar包文件地址,绝对路径  -DgroupId=组名 -DartifactId=项目名称 -Dversion=版本号 -Dpackaging=jar -DrepositoryId=私库id（和setting.xml文件中的server的id保持一致） -Durl=私仓地址

方式四：通过nexus的可视化界面进行上传jar发布

如下图

上传jar.png

这几种发布方式的选择

方式一，通过distributionManagement这种方式发布，可能是大多数人的选择。但如果要发布的项目很多，我们就可以考虑使用方式二，通过在全局的settings文件配置altSnapshotDeploymentRepository 和altReleaseDeploymentRepository进行发布，只需配置一次，所有项目就都可以发布，无需在多个项目pom指定

方式一和方式二比较适合公司自己内部开发项目，对于一些第三方提供的jar，推荐使用mvn deploy -DrepositoryId=私库id（和settings.xml文件中的server的id保持一致） -Durl=私仓地址的方式或者直接使用nexus可视化界面上传的方式