自己jar包推送到远程(中央)仓库的操作

问题描述

有个多嘴的同事,开会时多了一嘴:要不要把我们的项目推送到中央仓库管理起来(我们项目是在gitHub开源的);然后领导同意了,本来事情落他身上了,但奈何他身上任务太多,最后这活还是分配到我身上了,提前说一声,我对这里的操作,所知=0;但还好有百度,只能做起来;

这里参考了好多个博主的文章,偷偷把一个写的比较清晰完善的拿过来一下,嘿嘿,最后会挂上此博主文章的链接;随后我也会补充上自己遇到的恶心问题

发送流程

0.先来说一下首次上传的核心步骤,由于步骤中的过程相对较复杂,所以先抽象下基本思路,再展开讲解,避免大家看不懂.

抽象步骤:

  • 注册账号
  • 提交工单
  • 人工审核及确认
  • 上传SNAPSHOT版本
  • 上传release版本

画了张流程图,过程大致如下:
在这里插入图片描述
jar包是不能直接发布到中央仓库的,只能先推到第三方,然后第三方检验jar包没问题了,才能通过第三方发送到远程仓库

具体发布流程操作

1.注册sonatype账号

Sign up for Jira - Sonatype JIRA

密码要求比较高,大小写数字符号啥的都要有,所以务必要记住此密码,记不住的事先保存好,后面要经常用到账号和密码.

2.创建Issue

用上面创建的账号密码登录后,点击页面上方导航栏的Create按钮创建Issue:
在这里插入图片描述
在这里插入图片描述
通过以上两个步骤,你的工单就被创建完成了,接下来就耐心等待工作人员审核,由于美国和中国的时差,所以基本上大部分时候回复你都是23:00以后,注意留意你注册账号时填写的邮箱,回复内容会在邮箱里通知你.(我是工作日下午申请的,我申请了2次,一般在20分钟内就回复了)

3.确认邮件

在收到工作人员的确认邮件后,在邮件内容中他们通常会要求验证你填写的groupId中的域名或github账户是不是你本人的

  • 如果你填写的是域名,他们会要去你用该域名的邮箱给他们发一封邮件进行确认
  • 如果你填写的是github账户,他们会要求你在你的github中创建一个指定名称的仓库进行验证(如下图,按要求去创建即可)
    在这里插入图片描述
    这里多说一句,我申请了2次,一次使用github作为groupId,一次是用我们的官网作为groupId,但用官网作为groupId时,还需要添加一个什么DNS TXT文件(如下图),我对域名这方面的知识不太了解,而且我们部门往中央仓库推jar包的也少之又少,所以最后使用的io.github.XXX作为的groupId;只需要在自己的gitHub仓库,按他的要求创建一个名字为OSSRH-85817的仓库就可以了(每个人的编号不一样,需要看邮箱中的名字,这个仓库没什么用,只是为了验证下这个gitHub仓库是你所属,验证完毕后就可以删除,我这里也没有gitHub仓库的权限,是让领导创建了仓库)
    在这里插入图片描述
    创建完以后,点击页面的Respond按钮,重新提交即可
    在这里插入图片描述
    过一会刷新状态为 已解决 就已经创建完成了, 刚刚创建的临时仓库可以删除
    在这里插入图片描述
4.上传至中央仓库

在这里插入图片描述

4.1上传SNAPSHOT的步骤

如果步骤走不下去,请务必查阅官方文档,以官方文档为准,因为可能会有更新
参考文档地址:OSSRH Guide - The Central Repository Documentation ,然后点击页面的Apache Maven按钮,里面就是要配置的内容(maven的setting.xml文件和项目的pom依赖)

流程:配置秘钥->配置settings.xml->配置pom.xml->上传

1. 配置秘钥:

下载并安装GPG:

https://www.gnupg.org/download/index.html
根据你电脑当前系统选择合适的安装包下载并安装,安装按默认勾选的配置一路安装即可.
生成秘钥有两种方式,敲命令和UI界面两种,这里仅演示通过命令创建的方式

 生成秘钥:
 
gpg --gen-key
 Real name: 名字(E文)
 Email address: 邮箱(自己的邮箱,我记得这个邮箱是要接收邮件,做验证用的,千万别瞎填一个不能用的邮箱)
 You selected this USER-ID:
 "xxx[xxx@qq.com](mailto:xxx@qq.com)"
 Change (N)ame, (E)mail, or (O)kay/(Q)uit? o
 之后往下,会让你输入用户名和邮箱,还有一个Passphase(输入两次,务必牢记,建议先找个地方记下来,后续要用到)
 
查看公钥
C:\Users\86151>gpg --list-key

查询结果:
C:\Users\86151\AppData\Roaming\gnupg\pubring.kbx
------------------------------------------------
pub   ed25519 2022-11-02 [SC] [expires: 2024-11-01]
      A66E2623D457CA43088FE730892152C51A188059
uid           [ultimate] lei_1997 <2987866881@qq.com>
sub   cv25519 2022-11-02 [E] [expires: 2024-11-01]
其中A66E2623D457CA43088FE730892152C51A188059就是你的公钥key

可能安装GPG也会安装一个可视化页面,此时可视化页面的证书下就会有你刚生成的公钥key,但注意,可视化页面上显示的秘钥并不完整,只是后16位,不要以为是秘钥不对,如下图
在这里插入图片描述

发布公钥:
gpg --keyserver hkp://keyserver.ubuntu.com:11371 --send-keys A66E2623D457CA43088FE730892152C51A188059
gpg --keyserver hkp://keyserver.ubuntu.com:11371 --recv-keys A66E2623D457CA43088FE730892152C51A188059
 
成功的话会有如下结果
gpg: key 892152C51A188059: "lei_1997 <2987866881@qq.com>" not changed
gpg: Total number processed: 1
gpg:              unchanged: 1

为什么要发布公钥呢,因为往第三方库去推jar包时,需要秘钥,而且只能发布到第三方允许的地址

2. 配置settings.xml

找到你IDEA自带或者你安装的Maven所在的目录:
File->settings->Build->Maven->MavenHomePath,进入此目录在conf文件夹下就可以看到settings.xml文件,如果没有的话可以自己新建一个.

setting.xml中配置如下:

  <servers>
	  <server>
        <id>ossrh</id>
        <username>第一步SonaType账号</username>
        <password>填你注册SonaType时填写的密码</password>
	  </server>
  </servers>

<-- 这个配置,是为了执行 mvn clean deploy 过程中,让你输入一次Passphase的操作,
如果在这里配置了,估计在执行mvn clean deploy 中就不用输入了,我这里没有配置,在mvn clean deploy输了一次Passphase,大家根据自己情况决定是否添加,
个人觉得还是不要添加吧,就在mvn clean deploy中输入一次密码而已,万一加上再报了什么不可知的错误了呢  !-->
<profiles>
    <profile>
      <id>ossrh</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      <properties>
        <!--这里填你安装的GnuPG位置-->
        <gpg.executable>E:\GnuPG\bin\gpg.exe</gpg.executable>
        <gpg.passphrase>填写你生成秘钥时输入的Passphase</gpg.passphrase>
        <!--这里填你秘钥在磁盘上的位置,可通过上面步骤的 gpg --list-keys找到-->
        <gpg.homedir>C:\Users\86151\AppData\Roaming\gnupg\</gpg.homedir>
      </properties>
    </profile>
  </profiles>
3. 配置Pom.xml

因为我们的项目是父项目下有多个子项目,我们现在只是发布其中一个子项目,所以在子项目的pom.xml中配置的以下内容
注意:如果要发布的子项目中,引了其他子项目,是不能发布的,除非引的这个子项目已经发布到中央仓库了;换句话说,项目中的dependency都得是在中央仓库能找到的

<groupId>io.github.cas-bigdatalab</groupId>
<artifactId>piflow-core</artifactId>
<!--需要特别注意,你上传的是SNAPSHOT仓库,所以此处版本号后缀必须带SNAPSHOT-->
<version>0.9-SNAPSHOT</version>

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

<!--项目信息...-->
<name>piflow-core</name>
<description>Test upload minimum version</description>
<url>https://github.com/cas-bigdatalab/piflow</url>


<!--开源协议...-->
<licenses>
    <license>
        <name>The Apache Software License, Version 2.0</name>
        <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
    </license>
</licenses>

 <!--开发者信息-->
<developers>
    <developer>
        <id>piflow</id>
        <name>piflow-core</name>
        <email>填写一个开发者的email就行,没多大用</email>
        <roles>
            <role>admin</role>
        </roles>
        <timezone>+8</timezone>
    </developer>
</developers>

<!--项目的一些依赖,如果项目有其他的依赖,不要删-->
<dependencies>
   <dependency>
        <groupId>org.quartz-scheduler</groupId>
        <artifactId>quartz</artifactId>
        <version>2.3.0</version>
    </dependency>
    <dependency>
        <groupId>net.liftweb</groupId>
        <artifactId>lift-json_2.11</artifactId>
        <version>2.6.1</version>
    </dependency>
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>fastjson</artifactId>
        <version>1.2.62</version>
    </dependency>
</dependencies>

<distributionManagement>
	<!--注意,此id必须与setting.xml中指定的一致-->
	<repository>
		<id>ossrh</id>
		<!--如果是要推到自己的私服,这里地址应该改为自己私服的地址?具体的可以在百度百度-->
		<url>https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/</url>
	</repository>
	<snapshotRepository>
		<id>ossrh</id>
		<url>https://s01.oss.sonatype.org/content/repositories/snapshots/</url>
	</snapshotRepository>
</distributionManagement>

<profiles>
    <profile>
        <!--注意,此id必须与setting.xml中指定的一致,不要自作聪明改它名字-->
        <id>ossrh</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <build>
            <plugins>
            	<!--发布到中央SNAPSHOT仓库插件-->
                <plugin>
                    <groupId>org.sonatype.plugins</groupId>
                    <artifactId>nexus-staging-maven-plugin</artifactId>
                    <version>1.6.7</version>
                    <extensions>true</extensions>
                    <configuration>
                        <serverId>ossrh</serverId>
                        <nexusUrl>https://s01.oss.sonatype.org/</nexusUrl>
                        <autoReleaseAfterClose>true</autoReleaseAfterClose>
                    </configuration>
                </plugin>

                <!--生成源码插件-->
                <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>

                <!--生成API文档插件-->
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-javadoc-plugin</artifactId>
                    <version>2.9.1</version>
                    <executions>
                        <execution>
                            <id>attach-javadocs</id>
                            <goals>
                                <goal>jar</goal>
                            </goals>
                        </execution>
                    </executions>
                </plugin>

                <!--gpg插件-->
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-gpg-plugin</artifactId>
                    <version>1.5</version>
                    <executions>
                        <execution>
                            <id>sign-artifacts</id>
                            <phase>verify</phase>
                            <goals>
                                <goal>sign</goal>
                            </goals>
                        </execution>
                    </executions>
                </plugin>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-surefire-plugin</artifactId>
                    <version>2.3.1</version>
                    <configuration>
                        <skip>true</skip>
                    </configuration>
                </plugin>
            </plugins>
        </build>
    </profile>
</profiles>

以上配置,都不可缺少,我之前少写了一个developers,虽然打包没问题,但最后提交到第三方时,检测有问题,可以参考上面挂的链接从文档中粘贴过来就行,这里再写一次链接
完成上述配置,你已经基本上走完了80%的步骤了,此时,你可以通过Maven尝试打包一下你的项目,期间可能会出现弹窗让你填一次Passphase
但同时坑也来了,这个坑曾浪费了我两天时间,其实也不是很大的问题,这里大家留意一下:因为大多数人,安装maven时都不会把maven安装到默认位置(C盘),但这里我无论是用idea的插件打包还是mvn命令打包,都会报401错误,如下图:
在这里插入图片描述
其实401错误,大部分就是权限问题,奈何第一次发布jar包到远程仓库,根本无从排查问题;然后百度上说的百分之98的解决方案都是在maven的setting.xml文件中添加配置:

<server>
	<id>releases</id>
	<username>SonaType账号</username>
	<password>SonaType密码</password>
</server>
<server>
	<id>snapshots</id>
	<username>SonaType账号</username>
	<password>SonaType密码</password>
</server>

<!--那对应的pom中的配置的id也要改-->
<distributionManagement>
	<repository>
		<id>releases</id> <!--改成和setting文件中的id一致-->
		<url>https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/</url>
	</repository>
	<snapshotRepository>
		<id>snapshots</id> <!--改成和setting文件中的id一致-->
		<url>https://s01.oss.sonatype.org/content/repositories/snapshots/</url>
	</snapshotRepository>
</distributionManagement>

但这种方法我尝试了,还是报401错误,并没有解决;所以这种解决方法就是胡扯(我尝试的记得把setting新加的配置去掉,还有pom中的id也还改回来)

最后卡了2天,无意中看到了一个解决方案,最后也成功解决了我报的401错误,如下:
在这里插入图片描述
所以这里要把setting.xml,复制一份到C盘的.m2文件夹下(我是windows环境),然后再执行mvn clean deploy命令;就成功了;如下:
在这里插入图片描述
至此,SNAPSHOT版本已被上传至中央SNAPSHOT仓库,可以在浏览器访问Nexus Repository Manager,登录后查看结果如下图:
在这里插入图片描述

4.2 上传release版本

整体流程和上传SNAPSHOT版本一致,下面仅贴出差异点:

1.settings.xml
<!--将原来server标签和profile标签中的的ossrh替换为release-->
<id>release</id>
<servers>
  <server>
       <!--<id>ossrh</id>-->
       <id>release</id>
       <username>第一步SonaType账号</username>
       <password>填你注册SonaType时填写的密码</password>
  </server>
 </servers>
2. pom.xml

<!--修改GAV中的版本号,把SNAPSHOT后缀去掉-->
<version>0.9</version>

<!--将原来server标签和profile标签中的的ossrh替换为release-->
<id>release</id>

<!--移除此发布到中央SNAPSHOT仓库插件,并替换为下面的发布到中央release仓库的插件-->
<!--
<plugin>
     <groupId>org.sonatype.plugins</groupId>
     <artifactId>nexus-staging-maven-plugin</artifactId>
     <version>1.6.7</version>
     <extensions>true</extensions>
     <configuration>
         <serverId>ossrh</serverId>
         <nexusUrl>https://s01.oss.sonatype.org/</nexusUrl>
         <autoReleaseAfterClose>true</autoReleaseAfterClose>
     </configuration>
 </plugin>
-->

<!--发布到中央release仓库插件-->
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-release-plugin</artifactId>
    <version>2.5.3</version>
    <configuration>
        <autoVersionSubmodules>true</autoVersionSubmodules>
        <useReleaseProfile>false</useReleaseProfile>
        <releaseProfiles>release</releaseProfiles>
        <goals>deploy</goals>
    </configuration>
</plugin>

然后执行mvn clean deploy命令即可;然后会接收到系统发的邮件:
在这里插入图片描述

在完成了SNAPSHOT和release版本上传之后,你会收到系统发来的邮件
至此,恭喜你已首次完成将项目发布至中央仓库.

5.后续

在之后,随着你项目的迭代,你可能需要发布新的版本至中央仓库,此时你可以跳过上传SNAPSHOT,直接上传release版本至中央仓库,由于非首次发布,他们的机器人也不再会帮助你自动同步了,此过程需要你手动触发,在上传完release包之后,打开官方页面,进入操作,具体流程如下图:
在这里插入图片描述
这里大家要留意一下,仔细看上面的步骤,点完 close后,等待几十秒(我是等了2分钟),就可以点击Refresh按钮了,别傻傻的等着close结束,我第一次没仔细看步骤,下午4点点了close,下班还没结束,然后电脑没关机,第二天上班还没结束!!! 所以自己点Refresh,而且刷新后才可以看close过程中是否发生错误,如果有错误,根据错误提示去修改即可(我曾就在pom中少写了developers信息,在这里报错了,然后点击Drop删除包,在pom中补充了developers信息,重新上传,close后点击Refresh就没再出现报错信息)

点完Release就同步到中央仓库了,但看其他的博主说不会立刻在[中央仓库](https://mvnrepository.com/)搜到,会有个时间差,具体时间差是多少,我给忘了

以上内容均是参考这个博主的文章写的,我另加了一点补充,算是有些抄袭吧

这里也附上一个我看的bilibili视频地址,这个up主解释了域名s01和oss的区别,还有一些其他的东西,大家有时间得可以看看:地址

总结

由于是第一次搞这个东西,期间虽然跟着百度和视频做的,但由于401错误让我怀疑是不是哪一步做错了,期间我还秘钥卸载重新弄了2次;但好在最后成功解决了问题,我最后虽然没发布到中央仓库,其实close没问题,点击一下Release按钮就发布到中央仓库了,但因为我这里groupId是用的io.github.XXX,我们是要用域名的,但域名问题还没搞定,毕竟一旦上传到中央仓库,就没有权限去操作这个jar包了,所以我没走最后一步

  • 3
    点赞
  • 8
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值