发布构件到Maven中央仓库

一、注册jira账号

  访问如下网址: https://issues.sonatype.org/secure/Signup.jspa

 记住邮箱,用户名,密码以备以后使用,一定牢记。

 二、创建一个issue

1、创建issue

https://issues.sonatype.org/secure/CreateIssue.jspa?issuetype=21&pid=10134

 输入如下内容:

Summary: 项目说明,例如:Personal project
GroupID:就是pom.xml中的groupID,例如:com.gitee.rslai

Project URL:填写你的个人主页即可,例如:https://gitee.com/rslai

SCM url:跟Project URL写成一样即可。

2、等待Issue通过

  一般需要 1 ~ 2 天,审批通过后会发邮件通知,在提交的 Issue 下面会看到 Sonatype 工作人员的回复。

  他会问你是否是你自己的域名,你就回复是你所在组织的域名就行,例如:Yes,I’m themember of the organization with the domain ‘com.gitee.rslai’ 

3、等待Issue通过

  之后还要继续等待1~2天,成功后会收到邮件回复。

  收到如下内容代表审核通过。

三、提供GPG/PGP 的签名文件

1、安装 GnuPG

   访问 https://www.gnupg.org/download/ 下载gpg4win并安装。

2、生成 Key Pair 密钥对

   在cmd中输入如下命令生成Key Pair 密钥对

gpg --gen-key

 

  中间还要输入密码

  记住上图中的key,之后上传key还需要输入此key。

3、查看 Key Pair 密钥对(如果换机器就需要复制 pubring.kbx、trustdb.gpg文件)

gpg --list-keys

  

4、发布公钥到GPG key-servers

   Sonatype公司会在下面任意一个key-servers上进行搜索公钥,具体的key-servers 为:

http://pgp.mit.edu:11371 
http://keyserver.ubuntu.com:11371 
http://pool.sks-keyservers.net:11371

  所以随便添加到 keyserver.ubuntu.com,命令如下,其中send-keys就是“2、生成 Key Pair 密钥对”中的key

gpg --keyserver hkp://keyserver.ubuntu.com:11371 --send-keys 8230XXXXXXXXD7337

5、查看公钥

gpg --keyserver hkp://keyserver.ubuntu.com:11371 --recv-keys 8230XXXXXXXXD7337

四、修改pom.xml文件  

1、配置项目坐标 GAV

  groupId和你issue申请时填写相同

    <groupId>com.gitee.rslai.commons.http</groupId>
    <artifactId>http</artifactId>
    <version>1.0-SNAPSHOT</version>

2、项目名称、描述和URL

    <name>${project.groupId}:${project.artifactId}</name>
    <description>A application used as an example on how to set up pushing
        its components to the Central Repository.
    </description>
    <url>http://www.example.com/example-application</url>

3、License信息

<licenses>
  <license>
    <name>The Apache License, Version 2.0</name>
    <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
  </license>
</licenses>

  两个选一个即可

<licenses>
  <license>
    <name>MIT License</name>
    <url>http://www.opensource.org/licenses/mit-license.php</url>
  </license>
</licenses>

4、开发者信息

    <developers>
        <developer>
            <name>rslai</name>
            <email>netlrs@163.com</email>
            <organization>rslai</organization>
            <organizationUrl>https://gitee.com/rslai</organizationUrl>
        </developer>
    </developers>

5、SCM信息

  svn服务器如下填写

<scm>
  <connection>scm:svn:http://subversion.example.com/svn/project/trunk/</connection>
  <developerConnection>scm:svn:https://subversion.example.com/svn/project/trunk/</developerConnection>
  <url>http://subversion.example.com/svn/project/trunk/</url>
</scm>

  Git服务器GitHub如下填写

<scm>
  <connection>scm:git:git://github.com/simpligility/ossrh-demo.git</connection>
  <developerConnection>scm:git:ssh://github.com:simpligility/ossrh-demo.git</developerConnection>
  <url>http://github.com/simpligility/ossrh-demo/tree/master</url>
</scm>

  Git服务器BitBucket如下填写

<scm>
  <connection>scm:git:git://bitbucket.org/simpligility/ossrh-pipeline-demo.git</connection>
  <developerConnection>scm:git:ssh://bitbucket.org:simpligility/ossrh-pipeline-demo.git</developerConnection>
  <url>https://bitbucket.org/simpligility/ossrh-pipeline-demo/src</url>
</scm>

  Mercurial服务器BitBucket如下填写

<scm>
  <connection>scm:hg:http://bitbucket.org/juven/hg-demo</connection>
  <developerConnection>scm:hg:https://bitbucket.org/juven/hg-demo</developerConnection>
  <url>http://bitbucket.org/juven/hg-demo</url>
</scm>  

  Apache  Git服务器如下填写

<scm>
  <connection>scm:git:https://git-wip-us.apache.org/repos/asf/maven.git</connection>
  <developerConnection>scm:git:https://git-wip-us.apache.org/repos/asf/maven.git</developerConnection>
  <url>https://github.com/apache/maven/tree/${project.scm.tag}</url>
  <tag>master</tag>
</scm>

  码云Git服务器如下填写

    <scm>
        <connection>scm:git:git@gitee.com:rslai/Http.git</connection>
        <developerConnection>scm:git:ssh://gitee.com:rslai/Http.git</developerConnection>
        <url>https://gitee.com/rslai/Http.git</url>
    </scm>

6、配置分发管理服务器

    <distributionManagement>
        <snapshotRepository>
            <id>ossrh</id>
            <url>https://oss.sonatype.org/content/repositories/snapshots</url>
        </snapshotRepository>
        <repository>
            <id>ossrh</id>
            <url>https://oss.sonatype.org/service/local/staging/deploy/maven2</url>
        </repository>
    </distributionManagement>

  这就是上面你Issue通过后给你的地址

  

7、配置Profiles

  可以根据不同环境进行打包发布。 

    <profiles>
        <profile>
            <id>release</id>
            <build>
                <!--...-->
                <!--javadoc, source and gpg plugin from above-->
                <!--...-->
            </build>
        </profile>
    </profiles>

8、添加如下插件

  a)gpg签名插件,maven-gpg-plugin

  b)Nexus发布插件,nexus-staging-maven-plugin

  c)Sources插件,maven-source-plugin

  d)Javadoc插件,maven-javadoc-plugin

  如下:

    <build>
        <plugins>
            <!-- gpg sign Plugin -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-gpg-plugin</artifactId>
                <version>1.6</version>
                <executions>
                    <execution>
                        <id>sign-artifacts</id>
                        <phase>verify</phase>
                        <goals>
                            <goal>sign</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <!-- Nexus Staging Plugin -->
            <plugin>
                <groupId>org.sonatype.plugins</groupId>
                <artifactId>nexus-staging-maven-plugin</artifactId>
                <version>1.6.8</version>
                <extensions>true</extensions>
                <configuration>
                    <serverId>ossrh</serverId>
                    <nexusUrl>https://oss.sonatype.org/</nexusUrl>
                    <autoReleaseAfterClose>true</autoReleaseAfterClose>
                </configuration>
            </plugin>
             <!-- Sources Plugin -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-source-plugin</artifactId>
                <version>3.0.1</version>
                <executions>
                    <execution>
                        <id>attach-sources</id>
                        <goals>
                            <goal>jar-no-fork</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
             <!-- Javadoc Plugin -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
                <version>3.0.1</version>
                <executions>
                    <execution>
                        <id>attach-javadocs</id>
                        <goals>
                            <goal>jar</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

五、修改mvn的settings.xml文件

  打开settings.xml文件,一般在mvn安装目录或你指定的位置,例如:C:\apache-maven-3.5.0\conf

  找到servers段,将server内容copy进去

  <servers>
    <server>
      <id>ossrh</id>
      <username>netlrs</username>
      <password>qQTM*********Y0N%</password>
    </server>
  </servers>

  2、默认由于防火墙有时down不下来可以修改如下ali景象地址

  <mirrors>
	 <mirror>
            <id>nexus-aliyun</id>
            <mirrorOf>central</mirrorOf>
            <name>Nexus aliyun</name>
            <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
    </mirror>
  </mirrors>

六、发布到仓库

  进入cmd命令行,执行如下命令,发布过程中会要求输入密码输入“2、生成 Key Pair 密钥对”输入的密码即可

mvn clean deploy

  发布成功如下图

  https://oss.sonatype.org/content/repositories/snapshots/com/gitee/rslai/commons/http/http/ 这个地址就是发布后服务器地址

七、其它项目中引入此项目

  访问 https://oss.sonatype.org 网址,输入之前的groupId “com.gitee.rslai.commons.http” 找到maven配置如下,将其写入其它项目的pom.xml文件,重新导入后即可使用。

<dependency>
  <groupId>com.gitee.rslai.commons.http</groupId>
  <artifactId>http</artifactId>
  <version>1.0-SNAPSHOT</version>
</dependency>

八、其它人引入此项目

  由于发布的是 SNAPSHOT 所以只能自己引用,如果需要他人引用需要发布 release 版本

  将pom.xml中的-SNAPSHOT去掉

    <groupId>com.gitee.rslai.base.commons</groupId>
    <artifactId>util</artifactId>
    <version>0.1-SNAPSHOT</version>

  改为

    <groupId>com.gitee.rslai.base.commons</groupId>
    <artifactId>util</artifactId>
    <version>0.1</version>

  重新发布:

mvn clean deploy

  最后提示 close、release即表示发布成功。过10来分钟即可通过pom导入,过2小时可在 http://search.maven.org/ 网站查询到

九、导入密钥

  步骤如下,先生成新密钥,再导入之前密钥,然后再签名导入密码,最后将新密钥推到GPG key-servers

1、安装gpg4win

2、单击“导入”

 3、导入后需要创建一个新的key用以验证之前的密钥

 

4、创建新密钥需要密码

5、点击之前的密钥证书选择验证,输入密码即验证成功

6、发布新公钥到GPG key-servers

   查看现有keys

gpg --list-keys

   上面的是之前的公钥,下边的是本次生成的公钥

  使用之前的公钥查询

gpg --keyserver hkp://keyserver.ubuntu.com:11371 --recv-keys 1413D2A43XXXXXXXXXXXXXXXXXXXX0F9D7337

  会查到已经注册

  使用新公钥查询会看到没有注册

   重新发布公钥到GPG key-servers,再次查询就会看到已经注册

gpg --keyserver hkp://keyserver.ubuntu.com:11371 --send-keys B62CC3XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXD984E

 7、mvn deploy时报如下错误,原因是之前没有将新生成的公钥推送到key-servers,错误信息如下

  

 执行send-keys即可

gpg --keyserver hkp://keyserver.ubuntu.com:11371 --send-keys B62CC3XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXD984E

  

 

 参考文档:

  https://blog.csdn.net/xiajiqiu/article/details/77607492

posted @ 2018-08-16 13:13  rslai  阅读(681)  评论(0编辑  收藏  举报