临窗旋墨

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

文章来源：原创作者：临窗旋墨发布时间：2021-12-23 阅读：475 标签：maven

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

> 建议以[官网](https://central.sonatype.org/publish/publish-maven/)说明为准，网上教程存在一定的时效性。
>
> `临窗旋墨` `2021-12`
>
> 我的[pom文件](https://gitee.com/xuqiudong/vic-environment/blob/master/parent/pom.xml)

#### 1 注册

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

#### 2 新建 Issue

Issue Type 为New Project

过程略 按部就班填写即可

> 但是可能审核不通过，可能是group Id 填写问题，参见：[Choosing your Coordinates - The Central Repository Documentation (sonatype.org)](https://central.sonatype.org/publish/requirements/coordinates/)
>
> 可以使用托管平台的子域
>
> | **Service** | **Example groupId**  | **Link to the hosting service Documentation**           |
> | ----------- | -------------------- | ------------------------------------------------------- |
> | **GitHub**  | io.github.myusername | https://pages.github.com/                               |
> | **GitLab**  | io.gitlab.myusername | https://about.gitlab.com/stages-devops-lifecycle/pages/ |
> | **Gitee**   | io.gitee.myusername  | https://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)](https://central.sonatype.org/publish/publish-maven/)

```xml
<server>
  <id>sonatype-nexus-snapshots</id>
  <username>Sonatype账号</username>
  <password>Sonatype密码</password>
</server>
<server>
  <id>sonatype-nexus-staging</id>
  <username>Sonatype账号</username>
  <password>Sonatype密码</password>
</server>
```

#### 4  修改项目pom.xml文件

> 参考官网★：[Apache Maven - The Central Repository Documentation (sonatype.org)](https://central.sonatype.org/publish/publish-maven/)

```xml
<project xmlns="http://maven.apache.org/POM/4.0.0"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<groupId>io.gitee.xuqiudong</groupId>
	<artifactId>parent</artifactId>
	<version>1.0.1</version>
	<packaging>pom</packaging>
	
	
	<name>springboot项目的父项目</name>
	<description>springboot项目的父项目</description>
	<url>https://gitee.com/xuqiudong/vic-environment</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>

<scm>
		<connection>scm:git:ssh://git@gitee.com:xuqiudong/vic-environment.git</connection>
		<developerConnection>scm:git:https://gitee.com/xuqiudong/vic-environment.git</developerConnection>
		<url>https://gitee.com/xuqiudong/vic-environment</url>
		<tag>HEAD</tag>
	</scm>

<issueManagement>
		<system>git Issue</system>
		<url>https://gitee.com/xuqiudong/vic-environment/issues</url>
	</issueManagement>

<developers>
		<developer>
			<name>vic.xu</name>
			<email>xuduochoua@163.com</email>
			<roles>
				<role>Developer</role>
			</roles>
			<timezone>+8</timezone>
		</developer>
	</developers>

<properties>
		
		
		<vic.boot.version>1.0.0</vic.boot.version>
		<vic.group>io.gitee.xuqiudong</vic.group>
		
		<java.version>1.8</java.version>
		<project.encoding>UTF-8</project.encoding>
		<spring.boot.version>2.1.7.RELEASE</spring.boot.version>
		<javax.servlet>4.0.0</javax.servlet>
		<shiro-spring.version>1.6.0</shiro-spring.version>
		<jwt.auth0.version>3.8.1</jwt.auth0.version>
		<mybatis.starter.version>2.0.1</mybatis.starter.version>
		<pagehelper.starter.version>1.2.10</pagehelper.starter.version>
		<odbc.version>21.1.0.0</odbc.version>

<maven-compiler-plugin.version>3.8.1</maven-compiler-plugin.version>
		<maven-surefire-plugin.version>2.19</maven-surefire-plugin.version>
		<maven-release-plugin.version>2.5.3</maven-release-plugin.version>
		<maven-javadoc-plugin.version>2.9.1</maven-javadoc-plugin.version>
		<mybatis-generator-maven-plugin.version>1.3.2</mybatis-generator-maven-plugin.version>
		
		<maven-jar-plugin.version>3.1.1</maven-jar-plugin.version>
		
		<maven-source-plugin.version>3.2.1</maven-source-plugin.version>
		
		<maven-resources-plugin.version>3.1.0</maven-resources-plugin.version>
		
		<spring-boot-maven-plugin.version>2.4.0</spring-boot-maven-plugin.version>
		<elasticsearch.version>7.7.1</elasticsearch.version>
	</properties>

<dependencyManagement>
    </dependencyManagement>

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

<build>
		<pluginManagement>
			<plugins>
				<plugin>
					<groupId>org.springframework.boot</groupId>
					<artifactId>spring-boot-maven-plugin</artifactId>
					<version>${spring-boot-maven-plugin.version}</version>
					<executions>
						<execution>
							<goals>
								<goal>repackage</goal>
							</goals>
						</execution>
					</executions>
				</plugin>

<plugin>
					<groupId>org.apache.maven.plugins</groupId>
					<artifactId>maven-compiler-plugin</artifactId>
					<version>${maven-compiler-plugin.version}</version>
					<configuration>
						<source>${java.version}</source>
						<target>${java.version}</target>
						<encoding>${project.encoding}</encoding>
					</configuration>
				</plugin>

<plugin>
					<groupId>org.apache.maven.plugins</groupId>
					<artifactId>maven-surefire-plugin</artifactId>
					<version>${maven-surefire-plugin.version}</version>
					<configuration>
						<skipTests>true</skipTests>
					</configuration>
				</plugin>

<plugin>
					<groupId>org.apache.maven.plugins</groupId>
					<artifactId>maven-source-plugin</artifactId>
					<version>${maven-source-plugin.version}</version>
					<executions>
						<execution>
							<id>attach-sources</id>
							<phase>verify</phase>
							<goals>
								<goal>jar-no-fork</goal>
							</goals>
						</execution>
					</executions>
				</plugin>

<plugin>
					<groupId>org.apache.maven.plugins</groupId>
					<artifactId>maven-resources-plugin</artifactId>
					<version>${maven-resources-plugin.version}</version>
				</plugin>

<plugin>
					<groupId>org.apache.maven.plugins</groupId>
					<artifactId>maven-jar-plugin</artifactId>
					<version>${maven-jar-plugin.version}</version>
				</plugin>
				<plugin>
					<groupId>org.apache.maven.plugins</groupId>
					<artifactId>maven-javadoc-plugin</artifactId>
					<version>${maven-javadoc-plugin.version}</version>
					<inherited>true</inherited>
					<executions>
						<execution>
							<id>bundle-sources</id>
							<phase>package</phase>
							<goals>
								<goal>jar</goal>
							</goals>
						</execution>
					</executions>
					<configuration>
						<source>${java.version}</source>
						<target>${java.version}</target>
						<maxmemory>1024</maxmemory>
						<encoding>UTF-8</encoding>
						<show>protected</show>
						<notree>true</notree>

<failOnError>true</failOnError>
						
						<additionalparam>-Xdoclint:none</additionalparam>
					</configuration>
				</plugin>
			</plugins>
		</pluginManagement>

<plugins>
			<plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
            </plugin>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-source-plugin</artifactId>
			</plugin>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-javadoc-plugin</artifactId>
			</plugin>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-surefire-plugin</artifactId>
			</plugin>
		</plugins>
	</build>

<profiles>
		<profile>
			
			<id>release</id>
			<build>
				<plugins>
					<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>false</autoReleaseAfterClose>
						</configuration>
					</plugin>

<plugin>
						<groupId>org.apache.maven.plugins</groupId>
						<artifactId>maven-release-plugin</artifactId>
						<version>${maven-release-plugin.version}</version>
						<configuration>
							<autoVersionSubmodules>true</autoVersionSubmodules>
							<useReleaseProfile>false</useReleaseProfile>
							
							<goals>deploy nexus-staging:release</goals>
							<checkModificationExcludes>
								<checkModificationExclude>pom.xml</checkModificationExclude>
								<checkModificationExclude>**</checkModificationExclude>
							</checkModificationExcludes>
						</configuration>

</plugin>

<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>
								<configuration>
									<keyname>vic.xu</keyname>
									<passphraseServerId>vic.xu</passphraseServerId>
								</configuration>
							</execution>
						</executions>
					</plugin>
				</plugins>
			</build>
		</profile>
	</profiles>

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

>
>
>```
>gpg --keyserver hkp://pool.sks-keyservers.net:11371 --send-keys  2CEFDDED844F56AADB1B3B57222970C5E4026FA9
>gpg --keyserver hkp://pool.sks-keyservers.net:11371 --recv-keys  2CEFDDED844F56AADB1B3B57222970C5E4026FA9
>gpg --keyserver hkp://keyserver.ubuntu.com:11371 --send-keys  2CEFDDED844F56AADB1B3B57222970C5E4026FA9
>gpg --keyserver hkp://keyserver.ubuntu.com:11371 --recv-keys  2CEFDDED844F56AADB1B3B57222970C5E4026FA9
>gpg --keyserver hkp://keys.gnupg.net:11371 --send-keys  2CEFDDED844F56AADB1B3B57222970C5E4026FA9
>gpg --keyserver hkp://keys.gnupg.net:11371 --recv-keys  2CEFDDED844F56AADB1B3B57222970C5E4026FA9
>```

#### 6  打包到中央仓库

>  `mvn clean deploy  -P release -X`  使用`release`  的`proifile` 打包
>
>  我的[pom文件](https://gitee.com/xuqiudong/vic-environment/blob/master/parent/pom.xml)

登陆到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)](https://central.sonatype.org/publish/publish-maven/)
>
> [(记录一次将本地的Maven项目上传到中央仓库的步骤](https://blog.csdn.net/verygoodhmhm/article/details/119339533)
>
> [我把自己的java库发布到了maven中央仓库，从此可以像Jackson、Spring的jar一样使用它了_程序员欣宸的博客-CSDN博客_java库发布](https://blog.csdn.net/boling_cavalry/article/details/121240721)

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

发表评论