聊聊項目打包發布到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發布

如下圖

這幾種發布方式的選擇

方式一，通過distributionManagement這種方式發布，可能是大多數人的選擇。但如果要發布的項目很多，我們就可以考慮使用方式二，通過在全局的settings文件配置altSnapshotDeploymentRepository 和altReleaseDeploymentRepository進行發布，只需配置一次，所有項目就都可以發布，無需在多個項目pom指定

方式一和方式二比較適合公司自己內部開發項目，對於一些第三方提供的jar，推薦使用mvn deploy -DrepositoryId=私庫id（和settings.xml文件中的server的id保持一致） -Durl=私倉地址的方式或者直接使用nexus可視化界面上傳的方式