发布Maven项目到中央库

最新推荐文章于 2024-04-19 19:04:06 发布
最新推荐文章于 2024-04-19 19:04:06 发布
阅读量167 收藏
点赞数
分类专栏： Maven
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/zou8944/article/details/104582367
版权

之前的文章介绍了如何编写一个Maven插件。那插件的使用上呢？在本地，我们可以安装到本地仓库，使用没问题；在SIT环境中，我们可以安装到公司内部的私有仓库中。但如果公司的Maven包尚未形成规模，不需要搭建私有仓库，且私有仓库需要有专人进行维护，如果只有少量包，可能过一段时间都忘了还有这么个东西。等到出问题了找半天，又是一个麻烦事。

上传到Maven中央库也许是一个非常好的选择，任何人在任何地方都可以使用该包，爽歪歪。

为了方便，使用OSSRH的发布方案。

步骤介绍

整个步骤大致有如下三步

  • 使用JIRA申请创建一个新的Repository，用于在OSSRH申请空间。
  • 向项目的pom.xml中增加必要的内容
  • 部署

其中第一步需要人工审核，时间耗费比较久，按照个人经验来说半天可以搞定。

说明：如下步骤是OSSRH Guide的实践。

仓库及空间申请

创建JIRA账号

登录Snaptype JIRA
在这里插入图片描述
收到邮件代表创建成功。

新建工单

再次登录Snaptype JIRA

依次填入概要、Group Id、Project URL（项目URL，可填github项目主页）、SCM url（项目版本控制链接）

在这里插入图片描述
工单创建成功后需要等待邮件确认，反复几个来回后才能正常发布。下图是截止申请成功的所有交流。可以看到会有如下几个步骤

  • 创建工单
  • 在自己的github主页下创建一个它要求的repository以完成验证
  • 验证完成，允许用户发布组件到仓库
  • 申请的Group Id激活，用户发布的组件能够被同步到中央仓库（但要花两个小时）

在这里插入图片描述

GPG签名准备

组件发布之前，需要进行GPG签名，发布到服务器后，服务器会使用公钥对组件进行校验。关于GPG的介绍和详细解读，大家可以参考这篇文章。这里涉及到几个点

  • 安装gnupg工具

    # 安装
$ sudo apt install gnupg
# 安装成功与否的验证
$ gpg --version
gpg (GnuPG) 2.2.4
libgcrypt 1.8.1
Copyright (C) 2017 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Home: /home/floyd/.gnupg
支持的算法：
公钥： RSA, ELG, DSA, ECDH, ECDSA, EDDSA
密文： IDEA, 3DES, CAST5, BLOWFISH, AES, AES192, AES256, TWOFISH,
    CAMELLIA128, CAMELLIA192, CAMELLIA256
散列： SHA1, RIPEMD160, SHA256, SHA384, SHA512, SHA224
压缩： 不压缩, ZIP, ZLIB, BZIP2

  • 生成密钥对

    # 执行如下命令，提示填入真实姓名和邮箱，并设置密码
$ gpg --gen-key
# 查看刚才生成的密钥
$ gpg --list-key
/home/floyd/.gnupg/pubring.kbx
------------------------------
pub   rsa3072 2020-02-29 [SC] [有效至：2022-02-28]
      EB3877C670A794E0238E66E1D4420641AADB285E
uid           [ 绝对 ] Zou Guodong <zou894475@gmail.com>
sub   rsa3072 2020-02-29 [E] [有效至：2022-02-28]

    上面生成的秘钥，其中EB3877C670A794E0238E66E1D4420641AADB285E是用户ID，记住，下一步会使用

  • 发送公钥到 key server

    这一步非常重要，否则OSSRH会因为无法验证发布的组件而导致发布失败。

    gpg --send-key EB3877C670A794E0238E66E1D4420641AADB285E

    如果发送成功，你可能会收到opengpg发送的邮件

    在这里插入图片描述
    但这一步很可能会遇到问题，这在后面的问题集中有介绍

  • 在pom.xml中配置插件（在POM修改中有对应说明）

  • 在setting.xml中配置要使用的gpg工具 （在setting.xml修改中有对应说明）

pom.xml修改

添加POM必备项

  • 项目基础信息

    <groupId>com.example.applications</groupId>
<artifactId>example-application</artifactId>
<version>1.4.7</version>

<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>

  • 证书

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

  • 开发者信息

    <developers>
    <developer>
      <name>Manfred Moser</name>
      <email>manfred@sonatype.com</email>
      <organization>Sonatype</organization>
      <organizationUrl>http://www.sonatype.com</organizationUrl>
    </developer>
  </developers>

  • SCM信息

    即版本控制信息

    <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>

添加发布相关插件

  • Javadoc 和 源码打包插件

    <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>
    <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>

  • Nexu暂存插件

    <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://oss.sonatype.org/</nexusUrl>
     <autoReleaseAfterClose>true</autoReleaseAfterClose>
  </configuration>
</plugin>

Setting.xml修改

JIRA账号

设置准备阶段设置的账号密码，以便mvn能够连接到服务器

<settings>
  <servers>
    <server>
      <id>ossrh</id>
      <username>your-jira-id</username>
      <password>your-jira-pwd</password>
    </server>
  </servers>
</settings>

GPG

添加如下配置，指定加密工具

<settings>
  <profiles>
    <profile>
      <id>ossrh</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      <properties>
        <gpg.executable>gpg</gpg.executable>
        <gpg.passphrase>the_pass_phrase</gpg.passphrase>
      </properties>
    </profile>
  </profiles>
</settings>

我的配置

作为参考，给出我的配置，看这里

发布

上述内容准备好后，可以执行如下命令进行发布。

mvn clean deploy

需要注意的是，如果我们发布的版本是release版本，即版本号不以-SNAPSHOT结尾，且刚才配置的Nexus暂存插件的autoReleaseAfterClose设置为true时，执行上述命令后，OSSRH会自动发送到中央库。

至此，发布完成。更多步骤请参考官方文档。官方文档中提供了完整的发布开发版、release版的方式，可供参考。

效果

执行成功，等待大约两个小时，你就能在中央库查询到自己的组件了。例如搜索我刚才发布的组件。
在这里插入图片描述
点击进入，可以查看详情，这里
在这里插入图片描述
而作为一个插件，可以通过如下方式使用它

      <plugin>
        <groupId>com.github.zou8944</groupId>
        <artifactId>json-loader-maven-plugin</artifactId>
        <version>1.0.0</version>
        <executions>
          <execution>
            <phase>initialize</phase>
            <goals>
              <goal>read-project-json-to-properties</goal>
            </goals>
            <configuration>
              <files>
                <file>hello.json</file>
              </files>
            </configuration>
          </execution>
        </executions>
      </plugin>

踩过的坑

  • 在snatype上无法找到对应的profile
    在这里插入图片描述
    该问题是由于pom的GroupId和第一步申请JIRA账号时指定的GroupId不一致导致，修改本地使得一致即可

  • 组件上传成功，但服务端签名校验失败
    在这里插入图片描述
    该问题在于没有上传本地生成的密钥对。执行gpg --send-key <ID>生成即可。上传后，收到opengpg发来的邮件才能确认上传成功。

  • pgp上传秘钥失败

    前后报过两个错，分别是上传失败和服务器拒绝连接。网上找了很多解决方案对我都无效。最终使用如下终极方法

    # 删除整个.gnupg目录
sudo rm -r ~./gnupg
# 重新生成秘钥，不能加sudo
gpg --gen-key
# 执行如下命令，这是解决服务器拒绝连接的关键
pkill dirmngr
# 再次发送
gpg --send-key <ID>

总结

本文主要以实践为主，介绍了如果将本地项目发布到Maven中央库。尽管没有什么原创的内容，但价值在于踩坑。

参考文档

  1. Guide to uploading artifacts to the Central Repository

  2. How to Publish a Java Library to Maven Central

  3. OSSRH Guide

  4. gnupg can not connet to key server

  5. pgp can not find secret key

zou8944
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
如何将jar包发布到中央仓库
he_qiao_2010的专栏
06-21 1336
之前在github上开发了一个简单的项目，一直想把这个jar包发布到中央仓库。一直没有时间弄这个，今天抽出点时间，按照网上的例子，操作了一遍，顺便记录一下，一遍将来参考。我的开发环境是ubuntu18.04，maven3，整个过程还是比较顺利的。 注册JIRA账号 打开https://issues.sonatype.org/secure/Dashboard.jspa ，用邮箱注册即可。 创建i...
maven 打的包在哪_maven打包
weixin_39612228的博客
12-22 1138
1. 背景工程中免不了要通过maven打包。2. maven三种打包插件pluginfunctionsitemaven-jar-pluginmaven 默认打包插件，用来创建 project jarmaven-shade-plugin用来打可执行包，executable(fat) jarhttp://maven.apache.org/plugins/maven-shade-plugin/maven...
将jar发布到maven中央仓库小记
程序猿开发日志【学习永无止境】
03-01 844
dexcoder-assistant发布也经历几个版本了，很多人反映使用不太方便，需要将源码下来后本地编译安装一下，如果能直接使用就好了。 osc提供了第三方的maven库，但终究没有官方的maven库来得方便。 本文是将dexcoder-assistant发布到Maven中央库的记录。 注册一个 Sonatype 用户 注册地址：https://issues.sonaty
如何把jar发布到中央仓库
天行健，君子以自强不息；地势坤，君子以厚德载物。
12-27 3837
java maven 发布jar到中央仓库
将项目发布到Maven中央库
Black Shadow
09-07 3752
将项目发布到Maven中央仓库
2024 发布Maven项目到中央仓库
qq_24249071的博客
04-19 672
最新发布开源项目到中央仓库的办法
Maven发布自己项目到maven中央仓库
jinchunzhao的博客
07-17 1347
上传maven项目到maven中央仓库小记
Maven发布开源框架到远程仓库
littleschemer的博客
03-22 1405
当你写了一个自我感觉良好的开源工具希望给他人分享，如果只是在github等网站进行公布之外，用户使用起来还不是很方便，特别是当你提供是特定领域的基础工具。你还可以把它部署到中央仓库，这样别人使用就会方便很多。本文主要介绍如何使用maven发布依赖到中央仓库。
Apache Maven项目构建工具-其他
06-11
Maven带有一种机制，您的项目的客户端可以使用该机制从中央JAR存储库中下载构建项目所需的任何JAR，就像Perl的CPAN一样。这使Maven的用户可以在项目之间重用JAR，并鼓励项目之间进行通信，以确保解决向后兼容性问题...
可复制中央：可复制中央：针对发布到（Maven）中央存储库的工件的重建说明
03-03
从（Maven）中央存储库重建工件 作为的可一部分，此“可复制中央”项目尝试进行以下操作： 为可用的工件编写，等效于每个Linux发行版（例如Debian的或ArchLinux的PKGBUILD）维护的打包指令，无论使用哪种构建工具...
Maven中央仓库正式成为Oracle官方JDBC驱动程序组件分发中心(推荐)
01-19
一位甲骨文的工程师发布博客：在Maven中央仓库中，现在不单单最新版本的Oracle JDBC驱动程序，而且还可以找到以往所有的Oracle JDBC驱动发行版，包括19.6.0.0、19.3.0.0、18.3.0.0、12.2.0.1和11.2.0.4。Maven中央...
maven-central-publish:只需最少的工作就可以为Gradle项目配置发布到Maven Central
04-05
Maven中央发布只需最少的工作即可为Gradle项目配置发布到Maven Central存储库。特征任务checkPublicationCredentials 确保设置了发布凭据。任务checkMavenCentralPublication 确保已准备好发布所有已配置的必需信息...
项目管理-maven（一）
11-11
依赖管理：Maven通过中央仓库（Central Repository）来管理项目所需的第三方库和框架的依赖，开发人员只需在pom.xml中声明所需的依赖，Maven就可以自动下载并管理这些依赖。 项目报告：Maven提供了一系列插件用于...
基于SSM+JSP的企业人事管理信息系统毕业设计(源码+录像+说明).rar
05-09
基于SSM+JSP的企业人事管理信息系统毕业设计(源码+录像+说明).rar 【项目技术】 开发语言：Java 框架：ssm+jsp 架构：B/S 数据库：mysql 【演示视频-编号：420】 https://pan.quark.cn/s/b3a97032fae7 【实现功能】 实现了员工基础数据的管理，考勤管理,福利管理,薪资管理,奖惩管理,考核管理,培训管理,招聘管理,公告管理,基础数据管理等功能。
node-v6.12.0-linux-ppc64le.tar.xz
最新发布
05-09
Node.js，简称Node，是一个开源且跨平台的JavaScript运行时环境，它允许在浏览器外运行JavaScript代码。Node.js于2009年由Ryan Dahl创立，旨在创建高性能的Web服务器和网络应用程序。它基于Google Chrome的V8 JavaScript引擎，可以在Windows、Linux、Unix、Mac OS X等操作系统上运行。 Node.js的特点之一是事件驱动和非阻塞I/O模型，这使得它非常适合处理大量并发连接，从而在构建实时应用程序如在线游戏、聊天应用以及实时通讯服务时表现卓越。此外，Node.js使用了模块化的架构，通过npm（Node package manager，Node包管理器）,社区成员可以共享和复用代码，极大地促进了Node.js生态系统的发展和扩张。 Node.js不仅用于服务器端开发。随着技术的发展，它也被用于构建工具链、开发桌面应用程序、物联网设备等。Node.js能够处理文件系统、操作数据库、处理网络请求等，因此，开发者可以用JavaScript编写全栈应用程序，这一点大大提高了开发效率和便捷性。 在实践中，许多大型企业和组织已经采用Node.js作为其Web应用程序的开发平台，如Netflix、PayPal和Walmart等。它们利用Node.js提高了应用性能，简化了开发流程，并且能更快地响应市场需求。
node-v6.8.0-linux-ppc64le.tar.xz
05-09
Node.js，简称Node，是一个开源且跨平台的JavaScript运行时环境，它允许在浏览器外运行JavaScript代码。Node.js于2009年由Ryan Dahl创立，旨在创建高性能的Web服务器和网络应用程序。它基于Google Chrome的V8 JavaScript引擎，可以在Windows、Linux、Unix、Mac OS X等操作系统上运行。 Node.js的特点之一是事件驱动和非阻塞I/O模型，这使得它非常适合处理大量并发连接，从而在构建实时应用程序如在线游戏、聊天应用以及实时通讯服务时表现卓越。此外，Node.js使用了模块化的架构，通过npm（Node package manager，Node包管理器）,社区成员可以共享和复用代码，极大地促进了Node.js生态系统的发展和扩张。 Node.js不仅用于服务器端开发。随着技术的发展，它也被用于构建工具链、开发桌面应用程序、物联网设备等。Node.js能够处理文件系统、操作数据库、处理网络请求等，因此，开发者可以用JavaScript编写全栈应用程序，这一点大大提高了开发效率和便捷性。 在实践中，许多大型企业和组织已经采用Node.js作为其Web应用程序的开发平台，如Netflix、PayPal和Walmart等。它们利用Node.js提高了应用性能，简化了开发流程，并且能更快地响应市场需求。
基于PaddleFL框架的联邦学习医疗影像识别系统源码+GUI界面+说明（高分）.zip
05-09
基于PaddleFL框架的联邦学习医疗影像识别系统源码+GUI界面+说明.zip该项目是个人毕设项目源码，评审分达到97分，都经过严格调试，确保可以运行！放心下载使用。该项目资源主要针对计算机相关专业的学生或从业者下载使用，也可作为期末课程设计、课程大作业、毕业设计等。 基于PaddleFL框架的联邦学习医疗影像识别系统源码+GUI界面+说明.zip该项目是个人毕设项目源码，评审分达到97分，都经过严格调试，确保可以运行！放心下载使用。该项目资源主要针对计算机相关专业的学生或从业者下载使用，也可作为期末课程设计、课程大作业、毕业设计等。 基于PaddleFL框架的联邦学习医疗影像识别系统源码+GUI界面+说明.zip该项目是个人毕设项目源码，评审分达到97分，都经过严格调试，确保可以运行！放心下载使用。该项目资源主要针对计算机相关专业的学生或从业者下载使用，也可作为期末课程设计、课程大作业、毕业设计等。 基于PaddleFL框架的联邦学习医疗影像识别系统源码+GUI界面+说明.zip该项目是个人毕设项目源码，评审分达到97分，都经过严格调试，确保可以运行！放心下载使用。该项目资源
node-v6.12.2-linux-s390x.tar.xz
05-09
Node.js，简称Node，是一个开源且跨平台的JavaScript运行时环境，它允许在浏览器外运行JavaScript代码。Node.js于2009年由Ryan Dahl创立，旨在创建高性能的Web服务器和网络应用程序。它基于Google Chrome的V8 JavaScript引擎，可以在Windows、Linux、Unix、Mac OS X等操作系统上运行。 Node.js的特点之一是事件驱动和非阻塞I/O模型，这使得它非常适合处理大量并发连接，从而在构建实时应用程序如在线游戏、聊天应用以及实时通讯服务时表现卓越。此外，Node.js使用了模块化的架构，通过npm（Node package manager，Node包管理器）,社区成员可以共享和复用代码，极大地促进了Node.js生态系统的发展和扩张。 Node.js不仅用于服务器端开发。随着技术的发展，它也被用于构建工具链、开发桌面应用程序、物联网设备等。Node.js能够处理文件系统、操作数据库、处理网络请求等，因此，开发者可以用JavaScript编写全栈应用程序，这一点大大提高了开发效率和便捷性。 在实践中，许多大型企业和组织已经采用Node.js作为其Web应用程序的开发平台，如Netflix、PayPal和Walmart等。它们利用Node.js提高了应用性能，简化了开发流程，并且能更快地响应市场需求。
node-v7.2.0-darwin-x64.tar.xz
05-09
Node.js，简称Node，是一个开源且跨平台的JavaScript运行时环境，它允许在浏览器外运行JavaScript代码。Node.js于2009年由Ryan Dahl创立，旨在创建高性能的Web服务器和网络应用程序。它基于Google Chrome的V8 JavaScript引擎，可以在Windows、Linux、Unix、Mac OS X等操作系统上运行。 Node.js的特点之一是事件驱动和非阻塞I/O模型，这使得它非常适合处理大量并发连接，从而在构建实时应用程序如在线游戏、聊天应用以及实时通讯服务时表现卓越。此外，Node.js使用了模块化的架构，通过npm（Node package manager，Node包管理器）,社区成员可以共享和复用代码，极大地促进了Node.js生态系统的发展和扩张。 Node.js不仅用于服务器端开发。随着技术的发展，它也被用于构建工具链、开发桌面应用程序、物联网设备等。Node.js能够处理文件系统、操作数据库、处理网络请求等，因此，开发者可以用JavaScript编写全栈应用程序，这一点大大提高了开发效率和便捷性。 在实践中，许多大型企业和组织已经采用Node.js作为其Web应用程序的开发平台，如Netflix、PayPal和Walmart等。它们利用Node.js提高了应用性能，简化了开发流程，并且能更快地响应市场需求。
搭建本地maven中央仓库 详细步骤
05-20
搭建本地maven中央仓库的详细步骤如下： ... 这样，项目就会被发布到maven-releases或maven-snapshots仓库中。 至此，本地maven中央仓库的搭建就完成了。可以通过访问Nexus的web界面来查看已经发布到仓库中的项目。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值