Maven中央倉庫發佈歷程

時間  2019-11-09
標籤 maven 中央 倉庫 發佈 歷程 欄目 Maven 简体版
原文   原文鏈接

1、前言

最近本身在學習Spring boot的過程當中開發了一個組件 multithreadpool-spring-boot-starter，經過這個組件，咱們能夠動態根據配置文件進行多個線程池的初始化。既然有這個產出後，確定是但願可以上傳到maven中央倉庫，給更多的人使用，因而就產生了此次項目發佈經歷。html

整個過程可謂是一波三折，因爲平時工做比較忙只能晚上花一個小時搞，因此在經歷了近一週的時間後，終於成功發佈上去了。java

下面把我當時的上傳過程記錄下來，但願幫助更多的朋友。git

 

2、環境準備

1> mac osx 10.14.6 : 本文主要以mac環境爲準github

2> Apache Maven 3.2.3 : 本文主要使用maven進行構建和發佈例子的說明spring

 

3、步驟說明

一、工單建立

1> 訪問sonatype並註冊帳號 https://issues.sonatype.org ，注意要記住帳號密碼，會用於咱們後續的發佈及相關操做apache

2> 如圖新建一個issue，項目須要選擇 Community Support - Open Source Project Repository Hosting服務器

 

3>  參考下圖填寫概要、Group Id、項目地址、代碼管理地址，填寫後點擊確認提交。網上不少都說須要幾個小時或者隔天才有回覆，我當時等了10分鐘就收到回覆了。此時，對方跟你說兩件事情:jsp

  • 【提醒】確保 group id對應的域名是你的
  • 【校驗】好比我是的項目地址是github上的，他會要求我在github上建立一個和issue同名的項目確保我擁有該項目的管理權限，

完成確認並建立和issue同名的項目後，記得要在issue進行回覆，具體參考: sonatype-issue 和 Github倉庫maven

4> 在經過上述的確認和校驗後，sonatype會回覆你到時候maven發佈會用到的snapshot地址和release地址，並提醒你首次發佈後須要回覆該issue，詳情參考issuespring-boot

 

二、gpg 環境安裝

gpg的主要做用是生成密鑰對，會用於後續咱們組件發佈的校驗。

1> 下載地址：https://www.gnupg.org/download/

2> 如圖紅色框所示下載並安裝

3> 在安裝完成後，執行如下命令生成密鑰對，按照提示輸入帳號、郵箱、密碼 (PS: 此處的密碼在後面發佈會用到，請務必記住)

gpg2 --gen-key 

 4> 執行命令查看密鑰, 此時控制檯會輸出相似下面的內容

$ gpg2 --list-keys 
...

  pub rsa2048 2019-04-12 [SC] [有效至：2021-04-11]
  9A1640F7A2551131612D51B12D83594B7B29D86A
  uid [ 絕對 ] xiaoxuetu <xiaoxuetu@163.com>
  sub rsa2048 2019-04-12 [E] [有效至：2021-04-11]

5> 執行如下命令將公鑰發佈到服務器中

$ gpg --keyserver hkp://subkeys.pgp.net --send-keys 9A1640F7A2551131612D51B12D83594B7B29D86A
...
gpg: 正在發送密鑰 2D83594B7B29D86A 到 hkp://subkeys.pgp.net
gpg: 發送至公鑰服務器失敗：Server indicated a failure
gpg: 發送至公鑰服務器失敗：Server indicated a failure

6> 若是控制檯輸出如上面相似的錯誤內容，則將命令中的密鑰調整爲 2D83594B7B29D86A

$ gpg --keyserver hkp://subkeys.pgp.net --send-keys 2D83594B7B29D86A

  gpg: sending key 2D83594B7B29D86A to hkp://pool.sks-keyservers.net

 

 

三、Maven全局配置

通常狀況下，maven全局配置存在於 ${HOME}/.m2/setting.xml ，若是這個目錄下沒有，則能夠從 ${MAVEN_HOME}/conf/setting.xml 拷貝一份到 ${HOME}/.m2 目錄下並進行如下修改

1> 添加服務器驗證信息

    <server>
      <id>sonatype_releases</id>
      <username>your user name</username>
      <password>your password</password>
    </server>
    <server>
      <id>sonatype_snapshots</id>
      <username>your user name</username>
      <password>your password</password>
    </server>

 

2> 配置gpg驗證命令

<settings>
  <profiles>
    <profile>
      <id>gpg</id>
      <properties>
        <!-- 因爲我電腦安裝的是gpg2，不存在gpg命令，因此須要指定執行gpg2，不然會報錯 -->
        <gpg.executable>gpg2</gpg.executable>
        <gpg.passphrase>your password</gpg.passphrase>
      </properties>
    </profile>
  </profiles>
  <activeProfiles>
    <activeProfile>gpg</activeProfile>
  </activeProfiles>
</settings>

 

四、項目maven配置

1> 在項目的pom.xml中，配置相應的開源協議、倉庫信息、開發人員信息和發佈配置

<!-- 開源簽名證書 -->
    <licenses>
        <license>
            <name>The Apache Software License, Version 2.0</name>
            <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
            <distribution>repo</distribution>
        </license>
    </licenses>

    <!-- 倉庫信息 -->
    <scm>
        <connection>scm:git:git@github.com:xiaoxuetu/multithreadpool-spring-boot-starter.git</connection>
        <developerConnection>scm:git:git@github.com:xiaoxuetu/multithreadpool-spring-boot-starter.git
        </developerConnection>
        <url>http://github.com/xiaoxuetu/multithreadpool-spring-boot-starter/tree/master</url>
    </scm>


    <!-- 開發人員信息 -->
    <developers>
        <developer>
            <name>xiaoxuetu</name>
            <email>xiaoxuetu@163.com</email>
            <organization>https://github.com/xiaoxuetu</organization>
            <timezone>+8</timezone>
        </developer>
    </developers>

    <!-- 發佈管理信息 -->
    <distributionManagement>
        <repository>
            <!-- 這裏的id必需要和全局配置中的release id 一致 -->
            <id>sonatype_releases</id>
            <name>Nexus Release Repository</name>
            <!-- 這裏就是在建立issue成功後，對方回覆的release發佈地址-->
            <url>https://oss.sonatype.org/service/local/staging/deploy/maven2</url>
        </repository>
        <snapshotRepository>
            <!-- 這裏的id必需要和全局配置中的snapshot id 一致 -->
            <id>sonatype_snapshots</id>
            <name>Nexus Snapshot Repository</name>
            <!-- 這裏就是在建立issue成功後，對方回覆的snapshot發佈地址-->
            <url>https://oss.sonatype.org/content/repositories/snapshots</url>
        </snapshotRepository>
    </distributionManagement>

 

2> 因爲發佈到maven中央倉庫會要求咱們在上傳jar到同時，必須同步發佈對應到Javadoc、source、asc(利用gpg生成到校驗)，因此須要在maven中添加如下構建插件

    <build>
        <plugins>
            <plugin>
                <groupId>org.sonatype.plugins</groupId>
                <artifactId>nexus-staging-maven-plugin</artifactId>
                <version>1.6.7</version>
                <extensions>true</extensions>
                <configuration>
                    <!-- 這裏的id必需要和全局配置中的release id 一致 -->
                    <serverId>sonatype_releases</serverId>
                    <nexusUrl>https://oss.sonatype.org/</nexusUrl>
                    <!-- 若是但願發佈後自動執行close和release操做，此處能夠調整爲true -->
                    <autoReleaseAfterClose>false</autoReleaseAfterClose>
                </configuration>
            </plugin>

            <!-- 生成java source.jar -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-source-plugin</artifactId>
                <version>2.2.1</version>
                <executions>
                    <execution>
                        <id>attach-sources</id>
                        <goals>
                            <goal>jar-no-fork</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>

            <!-- 生成asc 校驗文件 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-gpg-plugin</artifactId>
                <version>1.5</version>
                <executions>
                    <execution>
                        <!-- 必須和配置中的gpg校驗id一致 -->
                        <id>gpg</id>
                        <phase>verify</phase>
                        <goals>
                            <goal>sign</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

  

五、發佈操做

1> 執行如下命令進行發佈（若是 pom.xml 中 autoReleaseAfterClose 的值爲true，則腳本會自動完成在平臺上close、release的操做，至此你將成功發佈了，不然咱們繼續查看第2步）

 mvn clean javadoc:jar deploy -P release

 

2> 登陸https://oss.sonatype.org，而後選擇staging Repositories

 

3> 以下圖搜索並選擇須要發佈的組件，依次執行Close、Release操做

 

4> 若是Release成功，而且你是首次發佈組件，則須要到你建立到issue中回覆 「我已經成功發佈該組件」，經歷大概2小時後，該組件將會同步到對應的maven倉庫

5> 若是Close或者Release不成功，你能夠以下圖操做查看緣由並谷歌定位，或者回復諮詢

 

4、參考文檔

1> 發佈構件到 Maven 中央倉庫遇到的坑: http://www.javashuo.com/article/p-hzksyqvv-kv.html

2> Working with PGP Signatures: https://central.sonatype.org/pages/working-with-pgp-signatures.html#distributing-your-public-key

3> Deploying to OSSRH with Apache Maven: https://central.sonatype.org/pages/apache-maven.html

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程