最近在写一些开源我的项目，想把本人写的货色放到maven地方仓库，提供给更多的人应用。所以写这一篇文章，记录一下自研开源我的项目jar包上传同步maven地方仓库胜利的整个过程，这其中还是有不少的坑的。
[TOC]

  • 首先须要在sonatype JIRA治理平台实现新建我的项目的申请，审核通过之后能力进行上传jar的操作
  • 上传过程首先必定是要本地进行打包，为保整我的项目信息完整性及上传过程安全性，须要进行非凡的操作，后文详述
  • 本地打包之后首先传入sonatype Nexus staging库，这个库只做长期存储，校验内容残缺、信息残缺之后能力通过平台操作转移到release库。
  • 开源我的项目jar转到到release库之后，实际上须要咱们操作的内容就全都实现了。sonatype maven库的我的项目会主动同步到maven地方仓库，这个过程会有延时，但延时很短。
  • 如果你应用国内的maven地方仓库的镜像，与maven地方仓库会有比拟大的延时，请急躁期待同步之后，才能够应用。

一、OSSRH账号注册于配置

sonatype是由社区反对的开源我的项目托管服务（Open Source Project Repository Hosting，简称OSSRH），它收费，开发者能够将本人的开源我的项目生成的maven jar包托管到这里。当将maven我的项目打包部署到这里之后，将主动同步到maven地方仓库。 所以不管怎样，咱们都须要先注册一个sonatype平台账号。

1.1.账号注册

注册地址：https://issues.sonatype.org/s...!default.jspa ，依照下图所示的内容填写本人的邮箱、全名、登陆用户名username、登陆密码passwprd，填写验证码即可实现注册。情谊提醒：注册过程中的明码的强度要求十分高，填写实现之后最好找个记事本把明码先记下来，以面后续应用的时候遗记。另外，注册实现之后，没有任何“注册胜利”相干的提醒，而是间接跳转到登录界面。

应用咱们刚刚注册的用户登陆进去，登陆进去之后会提醒咱们抉择语言：我习惯中文，当然选中文；而后会提醒咱们抉择一个头像；而后会提醒咱们要进行什么工作，“浏览以后我的项目即可”，这一步不重要。

进入JIRA治理平台之后，点击顶部导航栏的“新建”按钮，而后在弹出的模态框中填写信息，如下：

  • 我的项目和问题类型，肯定要选对，按图操作
  • 概要内容填写项目名称即可，Group Id 依据我的项目的maven坐标按需填写，与maven我的项目pom配置统一。（这里须要留神：实际操作的时候，先把下文中的《1.2.域名认证》看完，再做这部操作，存在对应关系防止做错）
  • 代码上传GitHub之后的我的项目URL、scm版本治理url(带.git)顺次如图填写。

点击新建即可，新建问题之后。实际上是发动了一个新建我的项目审核的审核工作流，会有人审核你所填写的信息。

1.2.域名认证

因为上文中Group ID我填写的是我本人购买的域名，所以我须要证实这个域名是我的。证实的形式也很简略，就是在我的域名购买的平台，给域名减少一条txt的域名解析记录，域名解析记录的值会在JIRA平台的流程审核后果记录中给出，如下图中的红色框起来的内容（本次新建我的项目申请的流水编号：OSSRH-83481）。

如果没有域名怎么办？没有域名你能够给Group Id填写github的用户域，如：com.github.<gihub用户名>。填写github用户域，验证形式也不一样，须要你在github中新建一个空的仓库，仓库的名称是OSSRH-83481 。


因为我的域名是在阿里云买的，所以我去阿里云为该域名增加一个TXT类型的解析记录值。

如果你不太确定TXT解析记录值是否失效，能够通过windows CMD命令行，响应如下的信息证实设置正确

> nslookup -type=TXT 你的域名服务器:  dns.googleAddress:  8.8.8.8非权威应答:你的域名       text =        "OSSRH-83481"

域名解析记录值增加实现之后，回到sonatype JIRA治理平台。在OSSRH-83481问题外面如下图所示的地位，有一个Respose按钮，点击该按钮证实你曾经实现了域名认证操作。（因为我是操作实现之后，写的这篇文章，所以这个按钮曾经没了，我模仿了一个）

在整个的新建问题，我的项目流程审核过程中，你的注册邮箱会一直的收到sonatype JIRA治理平台收回的邮件，提醒你审核流程进行到了什么阶段。（这个审核过程十分迅速，应该是机器人参加的审核，不是人为操作的，我用了5分钟就实现了整个审核流程）. 审核通过之后，你会看到如下的状态：已解决。

二、装置GnuPG软件，并生成签名

新建我的项目审核通过之后，咱们须要在开发PC上装置GnuPG，因为咱们上传到sonatype maven库的所有文件都要通过GnuPG进行签名，不通过签名的文件无奈上传胜利。下载地址：https://gpg4win.org/thanks-fo... 。下载实现之后，傻瓜式的“下一步”“下一步”装置即可。
下载实现之后，咱们关上windows的 CMD命令行，执行如下命令。（留神：我的操作都是在CMD命令行上面执行的，不要power shell ，不要git bash。我都试过，不是不行，是操作过程不统一。如果和我的操作过程不统一，可能导致你操作失败！）

gpg --gen-key

下图中红色的局部是我填写的内容，我的名字、邮箱，以及一个O示意ok。会提醒咱们输出一个Passphrase，填写2遍。这个Passphrase就是一个明码，肯定要记住，下文会用到。

GnuPG签名的公钥私钥对生成实现之后，能够应用如下命令查看后果

C:\Users\hanxt>gpg --list-keygpg: checking the trustdbgpg: marginals needed: 3  completes needed: 1  trust model: pgpgpg: depth: 0  valid:   1  signed:   0  trust: 0-, 0q, 0n, 0m, 0f, 1ugpg: next trustdb check due at 2024-08-09C:\Users\hanxt\AppData\Roaming\gnupg\pubring.kbx------------------------------------------------pub   ed25519 2022-08-10 [SC] [expires: 2024-08-09]      6B4F6A477A1BE195326AEAFA0EE41461FB92CD0Buid           [ultimate] HanXiaotong <hanxiaotongtong@163.com>sub   cv25519 2022-08-10 [E] [expires: 2024-08-09]

密钥对生成实现之后，将其公钥发往sonatype认可的keyserver，公钥的字符串能够通过上文中的gpg --list-key查看到

gpg --keyserver keyserver.ubuntu.com --send-keys 6B4F6A477A1BE195326AEAFA0EE41461FB92CD0B

通过上面的命令行，能够校验公钥的字符串发往服务器是否胜利。

gpg --keyserver keyserver.ubuntu.com --recv-keys 6B4F6A477A1BE195326AEAFA0EE41461FB92CD0B

三、我的项目根底配置

实现上述的筹备工作，咱们要对我的项目进行打包了，打包工具我用的maven。须要查看如下信息是否配置残缺，如果没有配置残缺，请补充！短少这些信息，maven我的项目后续将无奈转成release状态。请依据本人我的项目的理论状况填写。

<groupId>com.zimug</groupId><artifactId>zimug-monitor-threadpool</artifactId><version>1.0</version><name>${project.groupId}:${project.artifactId}</name><description>spring boot starter  for thread pool monitor  </description><url>https://github.com/hanxt/zimug-monitor-threadpool</url>

license中填写开源协定，scm填写我的项目的git代码仓库地址，developer填写开发人员的联系方式。

  <licenses>    <license>      <name>BSD 3-Clause</name>      <url>https://spdx.org/licenses/BSD-3-Clause.html</url>    </license>  </licenses>  <scm>    <connection>https://github.com/hanxt/zimug-monitor-threadpool.git</connection>    <url>https://github.com/hanxt/zimug-monitor-threadpool</url>  </scm>  <developers>    <developer>      <name>zimug</name>      <email>hanxiaotongtong@163.com</email>      <roles>        <role>Developer</role>      </roles>      <timezone>+8</timezone>    </developer>  </developers>

四、maven打包配置

只有在sonatype JIRA治理平台上注册的用户，能力将开源我的项目 jar上传到sonatype Nexus 仓库。所以咱们在上传jar文件的时候，有必要告知服务器端咱们的注册用户名及明码。找到maven的setting.xml,增加如下配置：

<servers>    <server>      <id>ossrh</id>       <username>sonatype注册username</username>      <password>sonatype注册用户的password</password>    </server></servers>

setting.xml是针对maven进行全局配置，除此之外还须要针对我的项目进行配置pom.xml，首先配置近程仓库的地址。须要留神的是这里的id与setting.xml中sever配置的id要统一。

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

这里有几个须要留神的中央，

  • snapshotRepository是我的项目快照版本snapshot上传地址，如果我的项目的版本号，如：1.0-SNAPSHOT，会上传到这个仓库。
  • 通常状况下repository是咱们真正须要公布我的项目的近程仓库上传地址。须要留神的是咱们这里写的是staging暂存地址，而不是release版本的地址。（为什么这么做？后文详述）
  • 另外须要留神的是，咱们上传的近程仓库的地址是带s01前缀的，而比拟旧的文章中不带s01前缀。这是因为旧的sonatype maven仓库曾经资源满载了，所以官网新建了一个s01 maven仓库，将来可能还会有s02、s03。 现阶段在sonatype JIRA治理平台上注册的用户，只能上传这个新的s01仓库。

近程仓库配置实现之后，咱们还须要针对我的项目pom.xml减少一些打包配置，这些配置根本不必批改，原样粘贴进去即可。（其中maven-gpg-plugin插件会调用上文中装置的GnuPG软件，对文件进行签名）

<profiles>  <profile>    <id>release</id>    <build>      <plugins>        <!-- Source -->        <plugin>          <groupId>org.apache.maven.plugins</groupId>          <artifactId>maven-source-plugin</artifactId>          <version>2.2.1</version>          <executions>            <execution>              <phase>package</phase>              <goals>                <goal>jar-no-fork</goal>              </goals>            </execution>          </executions>        </plugin>        <!-- Javadoc -->        <plugin>          <groupId>org.apache.maven.plugins</groupId>          <artifactId>maven-javadoc-plugin</artifactId>          <version>2.9.1</version>          <configuration>            <show>private</show>            <nohelp>true</nohelp>            <charset>UTF-8</charset>            <encoding>UTF-8</encoding>            <docencoding>UTF-8</docencoding>            <additionalparam>-Xdoclint:none</additionalparam>            <!-- TODO 长期解决不标准的javadoc生成报错,前面要规范化后把这行去掉 -->          </configuration>          <executions>            <execution>              <phase>package</phase>              <goals>                <goal>jar</goal>              </goals>            </execution>          </executions>        </plugin>        <!-- GPG -->        <plugin>          <groupId>org.apache.maven.plugins</groupId>          <artifactId>maven-gpg-plugin</artifactId>          <version>1.6</version>          <executions>            <execution>              <phase>verify</phase>              <goals>                <goal>sign</goal>              </goals>            </execution>          </executions>        </plugin>        <!--Compiler -->        <plugin>          <groupId>org.apache.maven.plugins</groupId>          <artifactId>maven-compiler-plugin</artifactId>          <version>3.0</version>          <configuration>            <source>1.8</source>            <target>1.8</target>            <fork>true</fork>            <verbose>true</verbose>            <encoding>UTF-8</encoding>          </configuration>        </plugin>        <!--Release -->        <plugin>          <groupId>org.apache.maven.plugins</groupId>          <artifactId>maven-release-plugin</artifactId>          <version>2.5.1</version>        </plugin>      </plugins>    </build>  </profile></profiles>

在我的项目根目录下，运行上面的命令进行maven打包操作（同时将我的项目jar deploy到近程maven仓库），在打包运行过程中，会弹出一个对话框提醒你输出密钥(Passphrase)，输出上文《装置GnuPG软件，并生成签名》章节中你填写的Passphrase即可。

mvn clean install deploy -P release

这里须要留神的是：

  • 不要应用IDEA的maven UI打包，IDEA的maven UI打包会报错，无奈执行gpg命令。至于具体起因我也没搞清楚，应用上文中的CMD命令行打包即可。
  • 应用mvn命令行打包的时候，须要留神你的JAVA_HOME环境变量的指向，是不是你冀望的版本。我的电脑上装置了多个版本的JDK，JAVA_HOME指向的是JDK11，而我心愿打包的版本是JDK8。有可能造成凌乱！
  • 如果maven depoly发布命令报401 authentication谬误，是因为你的maven的setting.xml的server配置的用户名明码谬误，或者setting.xml的server配置id与pom外面配置的repository id不统一导致的。也有可能你的电脑上maven 多个版本，我的项目应用的不是同一个setting.xml。
  • 如果报400谬误，很有可能是你曾经上传过的jar，同一个版本再次反复上传了。

五、CLOSE&RELEASE

我的项目jar正确的上传到nexus repository仓库之后，咱们还须要进行进一步的操作。这是因为咱们上传的jar放入了staging暂存库外面，咱们须要把它转到release库，这其中sonatype平台会针对你的我的项目信息、jar文档、源码等内容进行完整性校验，完整性校验不通过的我的项目是无奈转到release的，也就无奈同步到maven地方仓库。

这些操作须要咱们通过界面进行，应用sonatype注册用户进行登录：https://s01.oss.sonatype.org/ 。如图所示，如果咱们我的项目打包上传胜利，会在Staging Repository外面看到一个Repository，将其勾选。点击“CLOSE”按钮之后，会主动进行完整性校验，校验后果能够双击勾选仓库所在行进行查看。（只有依照我上文中的内容，将pom中的我的项目信息以及打包配置填写残缺，这里根本都会校验通过)

CLOSE校验通过之后，刷新几次页面，Release按钮就变成可点击的状态。此时点击Release按钮，就将我的项目jar从Staging暂存库，转移到了Release正式库。实际上须要咱们操作的内容就全都实现了。

sonatype maven库的我的项目会主动同步到maven地方仓库，通过maven坐标引入应用即可，不要焦急，这个过程可能会有一些延时。上传之后可能一段时间内无奈在maven地方仓库搜寻到，然而应用maven坐标下载jar包也没有问题。

所有都ok之后，最好回到sonatype JIRA治理平台将“问题”敞开，这样sonatype JIRA治理流程就全副实现了。

欢送关注我的布告号：字母哥杂谈，回复003赠送作者专栏《docker修炼之道》的PDF版本，30余篇精品docker文章。字母哥博客：zimug.com