记录一次提交maven项目到中央仓库

文章来源：原创   作者：临窗旋墨   发布时间：2021-12-23   阅读：4500   标签：maven 分类：maven 专题：解决方案

记录一次提交maven项目到中央仓库

建议以官网说明为准，网上教程存在一定的时效性。

临窗旋墨 2021-12

我的pom文件

1 注册

地址:https://issues.sonatype.org/projects
过程略

2 新建 Issue

Issue Type 为New Project

过程略 按部就班填写即可

但是可能审核不通过，可能是group Id 填写问题，参见：Choosing your Coordinates - The Central Repository Documentation (sonatype.org)

可以使用托管平台的子域

ServiceExample groupIdLink to the hosting service Documentation
GitHubio.github.myusernamehttps://pages.github.com/
GitLabio.gitlab.myusernamehttps://about.gitlab.com/stages-devops-lifecycle/pages/
Giteeio.gitee.myusernamehttps://gitee.com/help/articles/4136

比如使用Gitee，的则把groupId设置为io.gitee.myusername， 然后新建一个public的仓库名字为jira号的(注意大小写保持一致)，用以验证此仓库属于本人。

待jira变成RESOLVED/已解决

3 配置settings.xml文件

参考官网★：Apache Maven - The Central Repository Documentation (sonatype.org)

  1. <server>
  2.   <id>sonatype-nexus-snapshots</id>
  3.   <username>Sonatype账号</username>
  4.   <password>Sonatype密码</password>
  5. </server>
  6. <server>
  7.   <id>sonatype-nexus-staging</id>
  8.   <username>Sonatype账号</username>
  9.   <password>Sonatype密码</password>
  10. </server>

4 修改项目pom.xml文件

参考官网★：Apache Maven - The Central Repository Documentation (sonatype.org)

  1. <project xmlns="http://maven.apache.org/POM/4.0.0"
  2.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3.     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  4.     <modelVersion>4.0.0</modelVersion>
  5.     <groupId>io.gitee.xuqiudong</groupId>
  6.     <artifactId>parent</artifactId>
  7.     <version>1.0.1</version>
  8.     <packaging>pom</packaging>
  10.     <!-- 下列三项是需要的 -->
  11.     <name>springboot项目的父项目</name>
  12.     <description>springboot项目的父项目</description>
  13.     <url>https://gitee.com/xuqiudong/vic-environment</url>
  17.     <!-- 开源许可证声明 有很多不同的开源许可证 Apache Version2.0 表示别人可以直接商用你的开源项目而无任何版权问题 -->
  18.     <licenses>
  19.         <license>
  20.             <name>The Apache Software License, Version 2.0</name>
  21.             <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
  22.         </license>
  23.     </licenses>
  26.     <!--开源地址 -->
  27.     <scm>
  28.         <connection>scm:git:ssh://git@gitee.com:xuqiudong/vic-environment.git</connection>
  29.         <developerConnection>scm:git:https://gitee.com/xuqiudong/vic-environment.git</developerConnection>
  30.         <url>https://gitee.com/xuqiudong/vic-environment</url>
  31.         <tag>HEAD</tag>
  32.     </scm>
  34.     <!-- Issue地址 -->
  35.     <issueManagement>
  36.         <system>git Issue</system>
  37.         <url>https://gitee.com/xuqiudong/vic-environment/issues</url>
  38.     </issueManagement>
  41.     <!-- 开发者信息 -->
  42.     <developers>
  43.         <developer>
  44.             <name>vic.xu</name>
  45.             <email>xuduochoua@163.com</email>
  46.             <roles>
  47.                 <role>Developer</role>
  48.             </roles>
  49.             <timezone>+8</timezone>
  50.         </developer>
  51.     </developers>
  53.     <properties>
  54.         <!-- gpg可执行命令路径 -->
  55.         <!-- 
  56.         <gpg.executable>D:\tools\dev\GnuPG\bin\gpg</gpg.executable>
  57.         <gpg.passphrase>12345678</gpg.passphrase> 
  58.         -->
  59.         <vic.boot.version>1.0.0</vic.boot.version>
  60.         <vic.group>io.gitee.xuqiudong</vic.group>
  62.         <java.version>1.8</java.version>
  63.         <project.encoding>UTF-8</project.encoding>
  64.         <spring.boot.version>2.1.7.RELEASE</spring.boot.version>
  65.         <javax.servlet>4.0.0</javax.servlet>
  66.         <shiro-spring.version>1.6.0</shiro-spring.version>
  67.         <jwt.auth0.version>3.8.1</jwt.auth0.version>
  68.         <mybatis.starter.version>2.0.1</mybatis.starter.version>
  69.         <pagehelper.starter.version>1.2.10</pagehelper.starter.version>
  70.         <odbc.version>21.1.0.0</odbc.version>
  72.         <!-- 插件版本 -->
  73.         <maven-compiler-plugin.version>3.8.1</maven-compiler-plugin.version>
  74.         <maven-surefire-plugin.version>2.19</maven-surefire-plugin.version>
  75.         <maven-release-plugin.version>2.5.3</maven-release-plugin.version>
  76.         <maven-javadoc-plugin.version>2.9.1</maven-javadoc-plugin.version>
  77.         <mybatis-generator-maven-plugin.version>1.3.2</mybatis-generator-maven-plugin.version>
  78.         <!-- 此版本被spring-boot使用 -->
  79.         <maven-jar-plugin.version>3.1.1</maven-jar-plugin.version>
  80.         <!-- 打包时把源码打到本地 -->
  81.         <maven-source-plugin.version>3.2.1</maven-source-plugin.version>
  82.         <!-- copy resources -->
  83.         <maven-resources-plugin.version>3.1.0</maven-resources-plugin.version>
  84.         <!-- spring boot -->
  85.         <spring-boot-maven-plugin.version>2.4.0</spring-boot-maven-plugin.version>
  86.         <elasticsearch.version>7.7.1</elasticsearch.version>
  87.     </properties>
  89.     <!-- Manage dependent versions of all sub-projects -->
  90.     <dependencyManagement>
  91.     </dependencyManagement>
  95.     <!-- 打包到中央仓库的地址 -->
  97.     <distributionManagement>
  98.         <snapshotRepository>
  99.             <id>ossrh</id>
  100.             <url>https://s01.oss.sonatype.org/content/repositories/snapshots</url>
  101.         </snapshotRepository>
  102.         <repository>
  103.             <id>ossrh</id>
  104.             <url>https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/</url>
  105.         </repository>
  106.     </distributionManagement>
  109.     <build>
  110.         <pluginManagement>
  111.             <plugins>
  112.                 <plugin>
  113.                     <groupId>org.springframework.boot</groupId>
  114.                     <artifactId>spring-boot-maven-plugin</artifactId>
  115.                     <version>${spring-boot-maven-plugin.version}</version>
  116.                     <executions>
  117.                         <execution>
  118.                             <goals>
  119.                                 <goal>repackage</goal>
  120.                             </goals>
  121.                         </execution>
  122.                     </executions>
  123.                 </plugin>
  126.                 <!-- 指定jdk和编码 -->
  127.                 <plugin>
  128.                     <groupId>org.apache.maven.plugins</groupId>
  129.                     <artifactId>maven-compiler-plugin</artifactId>
  130.                     <version>${maven-compiler-plugin.version}</version>
  131.                     <configuration>
  132.                         <source>${java.version}</source>
  133.                         <target>${java.version}</target>
  134.                         <encoding>${project.encoding}</encoding>
  135.                     </configuration>
  136.                 </plugin>
  138.                 <!-- 跳过测试 -->
  139.                 <plugin>
  140.                     <groupId>org.apache.maven.plugins</groupId>
  141.                     <artifactId>maven-surefire-plugin</artifactId>
  142.                     <version>${maven-surefire-plugin.version}</version>
  143.                     <configuration>
  144.                         <skipTests>true</skipTests>
  145.                     </configuration>
  146.                 </plugin>
  148.                 <!--打包时 把源码打包到本地 -->
  149.                 <plugin>
  150.                     <groupId>org.apache.maven.plugins</groupId>
  151.                     <artifactId>maven-source-plugin</artifactId>
  152.                     <version>${maven-source-plugin.version}</version>
  153.                     <executions>
  154.                         <execution>
  155.                             <id>attach-sources</id>
  156.                             <phase>verify</phase>
  157.                             <goals>
  158.                                 <goal>jar-no-fork</goal>
  159.                             </goals>
  160.                         </execution>
  161.                     </executions>
  162.                 </plugin>
  164.                 <!-- copy resources -->
  165.                 <plugin>
  166.                     <groupId>org.apache.maven.plugins</groupId>
  167.                     <artifactId>maven-resources-plugin</artifactId>
  168.                     <version>${maven-resources-plugin.version}</version>
  169.                 </plugin>
  172.                 <!--打jar插件 -->
  173.                 <plugin>
  174.                     <groupId>org.apache.maven.plugins</groupId>
  175.                     <artifactId>maven-jar-plugin</artifactId>
  176.                     <version>${maven-jar-plugin.version}</version>
  177.                 </plugin>
  178.                 <plugin>
  179.                     <groupId>org.apache.maven.plugins</groupId>
  180.                     <artifactId>maven-javadoc-plugin</artifactId>
  181.                     <version>${maven-javadoc-plugin.version}</version>
  182.                     <inherited>true</inherited>
  183.                     <executions>
  184.                         <execution>
  185.                             <id>bundle-sources</id>
  186.                             <phase>package</phase>
  187.                             <goals>
  188.                                 <goal>jar</goal>
  189.                             </goals>
  190.                         </execution>
  191.                     </executions>
  192.                     <configuration>
  193.                         <source>${java.version}</source>
  194.                         <target>${java.version}</target>
  195.                         <maxmemory>1024</maxmemory>
  196.                         <encoding>UTF-8</encoding>
  197.                         <show>protected</show>
  198.                         <notree>true</notree>
  200.                         <!-- Avoid running into Java 8's very restrictive doclint issues -->
  201.                         <failOnError>true</failOnError>
  202.                         <!-- 防止文档不规范报错 -->
  203.                         <additionalparam>-Xdoclint:none</additionalparam>
  204.                     </configuration>
  205.                 </plugin>
  206.             </plugins>
  207.         </pluginManagement>
  210.         <!-- 在此府项目中引入一些常用插件 -->
  211.         <plugins>
  212.             <plugin>
  213.                 <groupId>org.apache.maven.plugins</groupId>
  214.                 <artifactId>maven-compiler-plugin</artifactId>
  215.             </plugin>
  216.             <plugin>
  217.                 <groupId>org.apache.maven.plugins</groupId>
  218.                 <artifactId>maven-source-plugin</artifactId>
  219.             </plugin>
  220.             <plugin>
  221.                 <groupId>org.apache.maven.plugins</groupId>
  222.                 <artifactId>maven-javadoc-plugin</artifactId>
  223.             </plugin>
  224.             <plugin>
  225.                 <groupId>org.apache.maven.plugins</groupId>
  226.                 <artifactId>maven-surefire-plugin</artifactId>
  227.             </plugin>
  228.         </plugins>
  229.     </build>
  232.     <profiles>
  233.         <profile>
  234.             <!-- 上传的时候使用的配置和插件 -->
  235.             <id>release</id>
  236.             <build>
  237.                 <plugins>
  238.                     <plugin>
  239.                         <groupId>org.sonatype.plugins</groupId>
  240.                         <artifactId>nexus-staging-maven-plugin</artifactId>
  241.                         <version>1.6.7</version>
  242.                         <extensions>true</extensions>
  243.                         <configuration>
  244.                             <!-- 这里的id必须要和全局配置中的server一致 -->
  245.                             <serverId>ossrh</serverId>
  246.                             <!-- 这个地址，一定要和issue的评论中给出的地址一致！ -->
  247.                             <nexusUrl>https://s01.oss.sonatype.org/</nexusUrl>
  248.                             <!-- 如果希望发布后自动执行close和release操作，此处可以调整为true -->
  249.                             <autoReleaseAfterClose>false</autoReleaseAfterClose>
  250.                         </configuration>
  251.                     </plugin>
  253.                     <plugin>
  254.                         <groupId>org.apache.maven.plugins</groupId>
  255.                         <artifactId>maven-release-plugin</artifactId>
  256.                         <version>${maven-release-plugin.version}</version>
  257.                         <configuration>
  258.                             <autoVersionSubmodules>true</autoVersionSubmodules>
  259.                             <useReleaseProfile>false</useReleaseProfile>
  260.                             <!-- <releaseProfiles>release</releaseProfiles> -->
  261.                             <goals>deploy nexus-staging:release</goals>
  262.                             <checkModificationExcludes>
  263.                                 <checkModificationExclude>pom.xml</checkModificationExclude>
  264.                                 <checkModificationExclude>**</checkModificationExclude>
  265.                             </checkModificationExcludes>
  266.                         </configuration>
  268.                     </plugin>
  270.                     <!-- 11. 生成签名，确定使用那个gpg秘钥 -->
  271.                     <plugin>
  272.                         <groupId>org.apache.maven.plugins</groupId>
  273.                         <artifactId>maven-gpg-plugin</artifactId>
  274.                         <version>1.5</version>
  275.                         <executions>
  276.                             <execution>
  277.                                 <id>sign-artifacts</id>
  278.                                 <phase>verify</phase>
  279.                                 <goals>
  280.                                     <goal>sign</goal>
  281.                                 </goals>
  282.                                 <configuration>
  283.                                     <keyname>vic.xu</keyname>
  284.                                     <passphraseServerId>vic.xu</passphraseServerId>
  285.                                 </configuration>
  286.                             </execution>
  287.                         </executions>
  288.                     </plugin>
  289.                 </plugins>
  290.             </build>
  291.         </profile>
  292.     </profiles>
  294. </project>

5 配置pgp的公私钥信息

下载地址 ：https://www.gpg4win.org/get-gpg4win.html

  1. 生成秘钥： 手动新建即可，

    使用 gpg --list-keys 命令查询配置好的公私钥信息

  2. 使用 gpg --keyserver hkp://keyserver.ubuntu.com:11371 --send-keys <公钥key> 将公钥信息发送到ubuntu.com服务器，后续推送maven仓库会做校验。

    以下几个地址都可以试试

    gpg —keyserver hkp://keyserver.ubuntu.com:11371 —send-keys 2CEFDDED844F56AADB1B3B57222970C5E4026FA9

    gpg —keyserver keyserver.ubuntu.com —send-keys 2CEFDDED844F56AADB1B3B57222970C5E4026FA9

    gpg —keyserver keys.openpgp.org —send-keys 2CEFDDED844F56AADB1B3B57222970C5E4026FA9

    gpg —keyserver pgp.mit.edu —send-keys 2CEFDDED844F56AADB1B3B57222970C5E4026FA9

  3. 查看公钥是否发送成功：

    以下几个地址都可以试试

    gpg —keyserver hkp://pool.sks-keyservers.net —recv-keys 2CEFDDED844F56AADB1B3B57222970C5E4026FA9

    gpg —keyserver hkp://keyserver.ubuntu.com:80 —recv-keys 2CEFDDED844F56AADB1B3B57222970C5E4026FA9

    gpg —keyserver keyserver.ubuntu.com —recv-keys 2CEFDDED844F56AADB1B3B57222970C5E4026FA9

    gpg —keyserver keys.openpgp.org —recv-keys 2CEFDDED844F56AADB1B3B57222970C5E4026FA9

    gpg —keyserver pgp.mit.edu —recv-keys 2CEFDDED844F56AADB1B3B57222970C5E4026FA9

>
>

  1. gpg --keyserver hkp://pool.sks-keyservers.net:11371 --send-keys  2CEFDDED844F56AADB1B3B57222970C5E4026FA9
  2. gpg --keyserver hkp://pool.sks-keyservers.net:11371 --recv-keys  2CEFDDED844F56AADB1B3B57222970C5E4026FA9
  3. gpg --keyserver hkp://keyserver.ubuntu.com:11371 --send-keys  2CEFDDED844F56AADB1B3B57222970C5E4026FA9
  4. gpg --keyserver hkp://keyserver.ubuntu.com:11371 --recv-keys  2CEFDDED844F56AADB1B3B57222970C5E4026FA9
  5. gpg --keyserver hkp://keys.gnupg.net:11371 --send-keys  2CEFDDED844F56AADB1B3B57222970C5E4026FA9
  6. gpg --keyserver hkp://keys.gnupg.net:11371 --recv-keys  2CEFDDED844F56AADB1B3B57222970C5E4026FA9

6 打包到中央仓库

mvn clean deploy -P release -X 使用release 的proifile 打包

我的pom文件

登陆到https://s01.oss.sonatype.org/ （jira里提供的仓库地址，网上的部分教程和它不一致） 可查询到上传的包

如果 <autoReleaseAfterClose>false</autoReleaseAfterClose> 则可以去手动发布一下，

不然就不需要。

注意看如下日志： 当上面的参数为true时：

[DEBUG] Repository was removed; stop watching it
[DEBUG] iogiteexuqiudong-1035 REMOVED

仓库的工作台是是看不到的，但是可以在如下地址看到（ 30分钟后）

https://repo1.maven.org/maven2/{groupId}，比如我的：

https://repo1.maven.org/maven2/io/gitee/xuqiudong/

总结：遇到的坑

1 groupId： 需要证明是domain的拥有者，所有后面改成了gitee的子域io.gitee.xuqiudong， 然后在gitee上建立一个仓库，仓库名为jira号，注意大小写， 我复制jira号到gitee新建的时候，就自动变成了小写，结果无法通过。

2 . 一般的问题， 在deploy的时候加上-X 参数，如果出现错误，按部就班解决就可以了。比如javadoc、java-source没有生成。还有就是可能公钥没有上传成功。

参考：

Apache Maven - The Central Repository Documentation (sonatype.org)

(记录一次将本地的Maven项目上传到中央仓库的步骤

我把自己的java库发布到了maven中央仓库，从此可以像Jackson、Spring的jar一样使用它了_程序员欣宸的博客-CSDN博客_java库发布

发表评论

目录