一键发布到Maven Central的方法

最新推荐文章于 2024-07-05 13:49:23 发布

dnc8371

最新推荐文章于 2024-07-05 13:49:23 发布

阅读量280

点赞数

文章标签： java maven git github spring

当我向Maven Central发布Java开源库jcabi-aspects的新版本时，我花费了30秒钟的时间。甚至更少。最近，我发布了0.17.2版本。您可以在Github第80期中看到所有情况：

如您所见，我向Rultor发出了命令，它向Maven Central发布了一个新版本。我什么也没做

现在，让我们看看如何做到这一点。如何配置项目，以便将新版本发布到Maven Central只需花费几秒钟的时间。

顺便说一句，我假设您正在Github中托管项目。如果没有，整个教程将无法正常工作。如果您仍然不在Github中，我强烈建议您搬到那里。

准备您的POM

确保pom.xml包含Sonatype所需的所有元素，如Central Sync Requirements中所述。我们将部署到Sonatype，他们会将所有JAR（不仅是）工件同步到Maven Central。

使用Sonatype注册项目

在Sonatype JIRA中创建一个帐户并提出票证，要求批准您的groupId。《 OSSRH指南》更详细地说明了此步骤。

创建和分发GPG密钥

创建GPG密钥并分发它，如本使用PGP签名文章中所述。

完成此步骤后，您应该有两个文件： pubring.gpg和secring.gpg 。

创建settings.xml

在上一步中创建的两个.gpg文件旁边创建settings.xml ：

<settings>
  <profiles>
    <profile>
      <id>foo</id> <!-- give it the name of your project -->
      <properties>
        <gpg.homedir>/home/r</gpg.homedir>
        <gpg.keyname>9A105525</gpg.keyname>
        <gpg.passphrase>my-secret</gpg.passphrase>
      </properties>
    </profile>
  </profiles>
  <servers>
    <server>
      <id>sonatype</id>
      <username><!-- Sonatype JIRA user name --></username>
      <password><!-- Sonatype JIRA pwd --></password>
    </server>
  </servers>
</settings>

在此示例中， 9A105525是您的公共密钥的ID，而my-secret是您在生成密钥时使用的密码。

加密安全资产

现在，使用Rultor公钥（ 9AF0FA4C ）对这三个文件进行加密：

gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys 9AF0FA4C
gpg --trust-model always -a -e -r 9AF0FA4C pubring.gpg
gpg --trust-model always -a -e -r 9AF0FA4C secring.gpg
gpg --trust-model always -a -e -r 9AF0FA4C settings.xml

您将获得三个新文件： pubring.gpg.asc ， secring.gpg.asc和settings.xml.asc 。将它们添加到项目的根目录，然后提交并推送。这些文件包含您的机密信息，但是只有Rultor服务器可以解密它们。

添加Sonatype存储库

我建议使用jcabi-parent作为您项目的父pom。这将使许多其他步骤变得不必要。如果您使用的是jcabi-parent，请跳过此步骤。

但是，如果您不使用jcabi-parent，则应将这两个存储库添加到pom.xml ：

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

配置GPG插件

同样，我建议使用http://parent.jcabi.com，它会自动配置此插件。如果您正在使用它，请跳过此步骤。

否则，将此插件添加到您的pom.xml ：

<project>
  [..]
  <build>
    [..]
    <plugins>
      [..]
      <plugin>
        <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>
    </plugins>
  </build>
</project>

配置版本插件

再一次，我建议使用http://parent.jcabi.com。它可立即配置所有必需的插件。如果您正在使用它，请跳过此步骤。

否则，将此插件添加到您的pom.xml ：

<project>
  [..]
  <build>
    [..]
    <plugins>
      [..]
      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>versions-maven-plugin</artifactId>
        <version>2.1</version>
        <configuration>
          <generateBackupPoms>false</generateBackupPoms>
        </configuration>
      </plugin>
    </plugins>
  </build>
</project>

配置Sonatype插件

是的，您是对的，http：//parent.jcabi.com也会在这里为您提供帮助。如果您正在使用它，也请跳过此步骤。

否则，将这四个插件添加到您的pom.xml ：

<project>
  [..]
  <build>
    [..]
    <plugins>
      [..]
      <plugin>
        <artifactId>maven-deploy-plugin</artifactId>
        <configuration>
          <skip>true</skip>
        </configuration>
      </plugin>
      <plugin>
        <artifactId>maven-source-plugin</artifactId>
        <executions>
          <execution>
            <id>package-sources</id>
            <goals>
              <goal>jar</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
      <plugin>
        <artifactId>maven-javadoc-plugin</artifactId>
        <executions>
          <execution>
            <id>package-javadoc</id>
            <phase>package</phase>
            <goals>
              <goal>jar</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
      <plugin>
        <groupId>org.sonatype.plugins</groupId>
        <artifactId>nexus-staging-maven-plugin</artifactId>
        <version>1.6</version>
        <extensions>true</extensions>
        <configuration>
          <serverId>oss.sonatype.org</serverId>
          <nexusUrl>https://oss.sonatype.org/</nexusUrl>
          <description>${project.version}</description>
        </configuration>
        <executions>
          <execution>
            <id>deploy-to-sonatype</id>
            <phase>deploy</phase>
            <goals>
              <goal>deploy</goal>
              <goal>release</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
</project>

创建Rultor配置

在项目的根目录中创建一个.rultor.yml文件（参考页详细介绍了此格式）：

decrypt:
  settings.xml: "repo/settings.xml.asc"
  pubring.gpg: "repo/pubring.gpg.asc"
  secring.gpg: "repo/secring.gpg.asc"
release:
  script: |
    mvn versions:set "-DnewVersion=${tag}"
    git commit -am "${tag}"
    mvn clean deploy --settings /home/r/settings.xml

您可以将文件与jcabi-aspects的实时Rultor 配置进行比较。