文档章节

将项目发布到Maven中央库

路小磊
 路小磊
发布于 2014/05/29 18:13
字数 2307
阅读 8278
收藏 163
点赞 25
评论 41

前几天参考[@黄勇]1 大神的博客 http://my.oschina.net/huangyong/blog/226738 成功将我的Hutool项目发布到了Maven的中央库,发表这篇博客以做纪念,顺便重新整理步骤并说明一下在发布过程中遇到的一些原博客中没有说明的问题。

其实总结下来发布的过程是与Sonatype工作人员交互的过程,这个过程是在Sonatype的JIRA平台上完成的,过程如下:

  1. 注册
  2. 提交一个issue(提出一个发布申请),告诉工作人员我要创建一个构件。
  3. 等待工作人员审批,会给你发邮件,在这个issue下给你comment说明通过或者哪里有问题。
  4. 上传构件
  5. 发布构建,并在哪个issue下告诉工作人员我发布了
  6. 等待审核,如果通过会告诉你需要release一下并在issue上告诉工作人员我release了
  7. 发布成功

这个过程比较漫长,慢在审核的过程,所以这个过程最好在晚上进行(我23点进行的,过了几分钟就回复我了),等待也是焦急而激动的,总体说来整个过程还是很有成就感滴~


1. 注册帐户

注册地址是 https://issues.sonatype.org/secure/Signup!default.jspa 注册

字段我就不细说了,一看就懂,不过Email非常重要,之后和工作人员的交流全靠这个邮件了。

2. 创建一个 Issue

地址是 https://issues.sonatype.org/secure/CreateIssue.jspa?issuetype=21&pid=10134 创建issue

这里需要特别说明的是Group Id,如果你是托管在Github或者Git@OSC 可以使用com.github.XXX或者net.oschina.XXX,我之前注册了个自己的域名com.xiaoleilu,所以在此填写这个group,剩下的可以依照实际情况填写,例如托管的地址等等。

3. 等待Issue审批

审批过程中出现过一些问题,第一次提交是因为我的Group Id 不符合规范(我用的looly.github),工作人员给我修正为com.github.looly了,然后告诉我可以进行下一步了,当时没理解,以为没通过,结果我又重新提交了一个Issue(就是com.xiaoleilu的Group Id),然后工作人员确认这个域名是否是我自己的,我回复是(在JIRA这个Issue下加个Comment),接着就通过了。 通过审核

截图为这个Issue的截图,当看到 Configuration has been prepared, now you can: 这句话的时候,说明你已经通过了Issue的审批,可以上传构建了。

4. 使用 GPG 生成密钥对

这个步骤是不是很突然?GPG是干嘛的?我开始也很迷茫,后来看官方文档说是签名构建用的,貌似为了保证你的构件不被第三方篡改,用于验证,神马原理呢?就是用这个东西在本地生成一个公钥和一个私钥,把公钥上传上去,当发布的时候用私钥签名一下(这个由maven-gpg-plugin搞定,不用我们自己来)。其实这个步骤也折腾了我好久,按照原博客的步骤,下载Gpg4win-Vanilla,我下载的2.1版本,系统是Windows8.1,并不能正常使用(在输入密码那段老是过不去),于是我转向Cygwin,步骤如下:

  1. 安装 我使用apt-cyg安装的,具体不介绍了,如果不会就参考Windows下安装Cygwin及包管理器apt-cyg,然后运行

     apt-cyg install gnupg
    

如果你是Linux,也可以用包管理工具安装gnupg这个包。

  1. 生成公钥私钥

     gpg --gen-key
    

一路回车,然后输入用户名、邮箱等,最后重复两次输入Passphase(这个在发布的时候需要,在此牢记),如果你还是不清楚,看下这篇博客GPG入门教程

  1. 查看公钥私钥

     gpg --list-keys
     /home/loolly/.gnupg/pubring.gpg
     -------------------------------
     pub   2048R/C990D076 2014-05-28
     uid                  Looly <loolly@gmail.com>
     sub   2048R/48F6CC72 2014-05-28
    

其中 C990D076 是需要传到服务器的

  1. 发布公钥

     gpg --keyserver hkp://pool.sks-keyservers.net --send-keys C990D076
    

执行这一步在Cygwin下可能会报错

gpg: 警告:配置文件‘/home/loolly/.gnupg/gpg.conf’权限不安全
gpg: 警告:配置文件‘/home/loolly/.gnupg/gpg.conf’的关闭目录权限不安全

原因是.gnupg的权限太大,这个目录必须只有当前用户本人有写权限,所以执行

chmod 700 .gnupg

我开始的时候修改权限失败了,原因是这个目录的组是None,所以执行

chown loolly:Users .gnupg

给定了一个组名,这样chmod命令就可以正常执行了。

  1. 查看是否成功

     gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys C990D076
    

好的,我们的密钥对已经准备好了,至于如何使用,请看接下来的步骤。

5. 修改setting.xml

setting.xml这个文件存在于两个地方,一个是用户的Maven配置文件,在${user}/.m2/setting.xml${user}表示你的用户目录,这个文件只对当前用户有效,另一个在你Maven安装目录的conf/setting.xml文件,这个是全局的配置文件,考虑到我的电脑只有自己用,所以只用全局配置文件添加内容如下:

<settings>
    ...
    <servers>
        <server>
            <id>oss</id>
            <username>用户名</username>
            <password>密码</password>
        </server>
    </servers>
    ...
</settings>

这里的用户名密码就是我们在第一部注册的时候的用户名和密码。

6. 修改pom.xml文件

pom.xml在Maven中央库的审核比较严格,必须有固定的一些字段,还有发布的构件必须包含字节码jar、源码jar、文档jar,这些都可以通过maven插件搞定,具体这个文件我就不贴了,请查看我的pom做参考: https://github.com/looly/hutool/blob/master/pom.xml 其中必须字段是:

  • name
  • description
  • url
  • licenses
  • developers
  • scm

这里我按照原博客的方法,把发布限制在了一个profile里(Profile理解为一个构建行为的配置,每种行为对应一个profile,例如线上、测试的某些配置不同,就可以分为不同的profile执行,如果你还不明白就自行百度吧~),发布需要的source插件、javadoc插件、gpg插件都在这个profile里,这样只有在发布的时候才会生成源码包、文档API包和做gpg签名。distributionManagement则是定义了releasesnapshot发布的地址,这个在Issue通过审核后工作人员会给你,还有就是snapshotRepositoryrepository 中的 id 一定要与 setting.xmlserverid 保持一致。

7. 发布到OSS

这一步主要是生成相应的一些jar包和签名文件,并上传到OSS的服务器,命令也比较简单

 mvn clean deploy -P release -Dgpg.passphrase=你的Passphase

这一步特别说明下,按照原博主的说法,执行mvn clean deploy -P release会自动弹出一个对话框,我这里没有弹出来……而且报签名异常,后来百度之,得加上-Dgpg.passphrase=你的Passphase这个参数,用你自己的Passphase,就可以成功了(我严重怀疑Cygwin的问题……)还有-P参数表示使用的profile名,就是profile下<id>release</id>这个标签的内容。

8. 发布构建

进入https://oss.sonatype.org并登陆,会在左侧有个staging Repositories点击进入,在右侧面板找到你的构件,状态应该是open,你要将其置为closed,点击上方的close按钮即可(这个按钮我找了10分钟我会明说么::>_<:: )。 关闭按钮

接下来系统会自动验证有效性,如果你的Group Id和pom.xml没有错误,状态会自动变成closed,如果有问题,会在下面提示你那里有问题,加入有问题你可以点击drop按钮删掉这个构件,修改后重新执行步骤7。

接下来你需要点击release按钮发布你的构件。

9. 在Issue中通知工作人员

然后回到JIRA中你的Issue,写个comment,我写的是Component has been successfully issued.告诉工作人员我发布完成了,等待他们审核。审核通过后我们就可以在中央库搜索到我们的构件了!搜索的地址是: http://search.maven.org/

搜索hutool

10. 总结

当可以搜索出来自己的构件的那一刻实在抑制不住心中的激动,各种朋友圈去发截图炫耀(虽然朋友圈里的同学都看不懂我截图这玩意儿是干啥的……),有种公司在美国上市的赶脚有木有!没办法,屌丝只有这些追求,让自己的代码被更多的人使用,会感到非常有成就感。

PS.说下发布中的一些细节,在执行第8步的时候,我只是简单的close,没有release,结果工作人员发来邮件说"Almost done! Looks like you still need to release the staging repository",然后我才点击release,再加了个comment才发布成功。

多一个步骤

令人欣慰的是总算完成了,感谢 [@黄勇]1

参考博客

http://my.oschina.net/huangyong/blog/226738

© 著作权归作者所有

共有 人打赏支持
路小磊

路小磊

粉丝 272
博文 53
码字总数 39918
作品 5
乌海
程序员
加载中

评论(41)

撒哈拉来的企鹅
撒哈拉来的企鹅
发了不想发的东西上去,有办法删掉吗
风云决
风云决
学习了
brianway
brianway

引用来自“gogoing2”的评论

博主,我上传完了以后,在https://oss.sonatype.org中没有看到我的内容,反而在staging profiles 中。怎么解决?
我和你遇到了一样的问题, 你解决了吗?
夏天飘过的风
夏天飘过的风

引用来自“路小磊”的评论

引用来自“夏天飘过的风”的评论

请问在中央库同步之后,如何自定义里面的头像呢?

nexus有设置吧。具体我也不知道
找了很久,也找不出在哪。。。
路小磊
路小磊

引用来自“夏天飘过的风”的评论

请问在中央库同步之后,如何自定义里面的头像呢?

nexus有设置吧。具体我也不知道
夏天飘过的风
夏天飘过的风
请问在中央库同步之后,如何自定义里面的头像呢?
Fly的狐狸
Fly的狐狸
这个文章真的不错
路小磊
路小磊

引用来自“ShinEDL”的评论

请问为什么我release之后,nexus提示return forbidden?
考虑是否提交到snaoshot库了?
S
ShinEDL

引用来自“路小磊”的评论

引用来自“cnlinjie”的评论

你好~,情况貌似有些不对~。~
貌似不能插入截图。
描述下,我昨天deploy之后,
到https://oss.sonatype.org/#stagingRepositories 这个页面
里面有4条记录,我点击close 提示我403 无权限。
对比了好久,发现4个构建的拥有者都不是我
分别是:
Owner  halfdan (84.161.51.155)
Owner  mictaege (88.71.113.215)
Owner  kurtpa (213.165.190.226)
Owner  paul150792 (93.113.254.65)
。。
不知为什么。。
是遇到BUG了么。

怎么会有4条记录?按理说你做deploy之后只有一条,最后那条,剩下的都是系统生成,不要点

引用来自“cnlinjie”的评论

可以了。 之前抱着测试的心理,一直用的是{SNAPSHOT} 版本,所以一直不行。 现在改下就好了。发布之后我到issue回复了。
请问你是怎么解决403这个问题的?
S
ShinEDL
请问为什么我release之后,nexus提示return forbidden?
Maven 私服 Nexus 初识

具体详情可参考链接 http://jingyan.baidu.com/article/preview?eidEnc=fec4bce26b4729f2618d8bc8 1、Nexus仓库分类 Nexus包含了各种类型的仓库类型。在登录后的Nexus界面,单击左边的“Rep...

learn_more ⋅ 2015/06/04 ⋅ 1

maven仓库--私服(Nexus的配置使用)

maven--私服的搭建(Nexus的使用)和注意的问题 私服是什么 私服,私有服务器,是公司内部Maven项目经常需要的东东,不总结一下,不足以体现出重视。Nexus是常用的私用Maven服务器,一般是公...

wx58bcafcc6d2c9 ⋅ 2017/05/25 ⋅ 0

bboss v5.0.0 发布,J2EE 企业级开源框架

J2EE企业级开源框架bboss v5.0.0 发布。 v5.0.0是bboss有史以来最稳定、功能最全版本,完全兼容之前版本功能。全面采用gradle构建和发布版本,并将版本提交到maven中央库。可以在github获取b...

bboss ⋅ 2016/07/05 ⋅ 6

Maven/JCenter,Ant/Gradle

> jcenter仓库 Android 快速发布开源项目到jcenter- http://blog.csdn.net/lmj623565791/article/details/51148825 使用Gradle发布Android开源项目到JCenter- http://blog.csdn.net/maosidi......

shareus ⋅ 2017/11/24 ⋅ 0

Maven私服 Nexus的搭建

背景: 私服:私有服务器,是公司内部Maven项目经常用到的私有仓库。Nexus就是一款常用的私用Maven服务器,一般是公司内部使用。 下载地址是:http://www.sonatype.org/nexus/go 默认本地地址...

huoyoung ⋅ 2016/09/11 ⋅ 0

maven配置开源中国镜像

介绍 亲爱的小伙伴们,开源中国的 Maven 库上线咯!为了方便广大开发同学,开源中国特别推出国内的 Maven 中央库,提供高速稳定的网络和服务,为国内 Maven 使用者提供便捷服务。本 Maven 库...

雨巷1 ⋅ 2016/04/04 ⋅ 4

Maven依赖本地jar包,上传第三方jar包

前言:maven管理项目,经常用到中央仓库没有的第三方jar包,需要将本地的jar包发布到私有库供项目使用。 打包到本地仓库 直接依赖本地的jar包 <dependency><groupId>org.alipay</groupId><ar...

王念博客 ⋅ 2016/05/05 ⋅ 0

Maven私有库搭建

如果构建的 n Maven 项目本地仓库没有对应的依赖包,那么就会去 s Nexus 私服去下载,如果 Nexus 私服也没有此依赖包, 就回去远程中央仓库下载依赖, 这些中央仓库就是 proxy 。 Nexus 私服...

longload ⋅ 2016/07/29 ⋅ 0

Maven 中央仓库启用 SSL

为了应对黑客可以向Maven中央仓库上传普通代码库的恶意版本这一问题,Sonatype公司启用了SSL连接以供测试之用。Sonatype公司之所以这样做的目的是为了在经历一个过渡期之后让SSL这一连接模式...

夕水溪下 ⋅ 2014/08/08 ⋅ 6

Maven私有库Nexus的安装和使用

Maven私有库Nexus的安装和使用 曾静的技术博客2017-07-2141 阅读 Mavennexus安装 在进行Java开发的时候,通常会使用 Maven 进行第三方库的管理,类似于iOS中的Cocoapods。我们在使用Cocoapo...

曾静的技术博客 ⋅ 2017/07/21 ⋅ 0

没有更多内容

加载失败,请刷新页面

加载更多

下一页

Java Web如何操作Cookie的添加修改和删除

创建Cookie对象 Cookie cookie = new Cookie("id", "1"); 修改Cookie值 cookie.setValue("2"); 设置Cookie有效期和删除Cookie cookie.setMaxAge(24*60*60); // Cookie有效时间 co......

二营长意大利炮 ⋅ 今天 ⋅ 0

【每天一个JQuery特效】淡入淡出显示或隐藏窗口

我是JQuery新手爱好者,有时间就练练代码,防止手生,争取每天一个JQuery练习,在这个博客记录下学习的笔记。 本特效主要采用fadeIn()和fadeOut()方法显示淡入淡出的显示效果显示或隐藏元...

Rhymo-Wu ⋅ 今天 ⋅ 0

Spring JDBC使用方法

普通实现: 1、创建数据表customer。 可以使用任何数据库实现,在项目中要引入相应数据库驱动包并配置相应数据库连接。 2、创建Customer pojo。 Customer类的属性对应数据库的属性,除了为每...

霍淇滨 ⋅ 今天 ⋅ 0

Contos 7 安装Jenkins

Jenkins是一款能提高效率的软件,它能帮你把软件开发过程形成工作流,典型的工作流包括以下几个步骤 开发 提交 编译 测试 发布 有了Jenkins的帮助,在这5步中,除了第1步,后续的4步都是自动...

欧虞山 ⋅ 今天 ⋅ 0

revel

revel install go get github.com/revel/revelgo get github.com/revel/cmd create new app revel new git.oschina.net/zdglf/myapp run app revel run git.oschina.net/zdglf/myapp ot......

zdglf ⋅ 今天 ⋅ 0

49. Group Anagrams - LeetCode

Question 49. Group Anagrams Solution 思路:维护一个map,key是输入数组中的字符串(根据字符排好序) Java实现: public List<List<String>> groupAnagrams(String[] strs) { Map<Strin......

yysue ⋅ 今天 ⋅ 0

spring Email

使用spring发Email其实就是使用spring自己封装携带的一个javamail.JavaMailSenderImpl类而已。这个类可以当一个普通的java对象来使用,也可以通过把它配置变成spring Bean的方式然后注入使用...

BobwithB ⋅ 今天 ⋅ 0

spark 整理的一些知识

Spark 知识点 请描述spark RDD原理与特征? RDD全称是resilient distributed dataset(具有弹性的分布式数据集)。一个RDD仅仅是一个分布式的元素集合。在Spark中,所有工作都表示为创建新的...

tuoleisi77 ⋅ 今天 ⋅ 0

思考

时间一天天过感觉自己有在成长吗?最怕的是时光匆匆而过,自己没有收获!下面总结下最近自己的思考。 认识自己 认识另一个自己,人们常说要虚心听取别人意见和建议。然而人往往是很难做到的,...

hello_hp ⋅ 今天 ⋅ 0

没有更多内容

加载失败,请刷新页面

加载更多

下一页

返回顶部
顶部