千家信息网

怎么使用Github Action发布jar到Maven中央仓库

发表于:2025-02-01 作者:千家信息网编辑
千家信息网最后更新 2025年02月01日,本文小编为大家详细介绍"怎么使用Github Action发布jar到Maven中央仓库",内容详细,步骤清晰,细节处理妥当,希望这篇"怎么使用Github Action发布jar到Maven中央仓库
千家信息网最后更新 2025年02月01日怎么使用Github Action发布jar到Maven中央仓库

本文小编为大家详细介绍"怎么使用Github Action发布jar到Maven中央仓库",内容详细,步骤清晰,细节处理妥当,希望这篇"怎么使用Github Action发布jar到Maven中央仓库"文章能帮助大家解决疑惑,下面跟着小编的思路慢慢深入,一起来学习新知识吧。

Github Action

Github Action是由Github创建的CI/CD服务。 它的目的是使所有软件开发工作流程的自动化变得容易。 直接从GitHub构建,测试和部署代码。CI(持续集成)由很多操作组成,比如代码合并、运行测试、登录远程服务器,发布到第三方服务等等。

期望效果

当代码库发布Release(发行版)的时候触发一个将Release所包含的分支发布到Maven中央仓库的效果。

拓展阅读:

Release(发行版)是具有 Changelogs(变更日志)和二进制文件的一级对象,可以代表超出 Git 架构本身的一个特定时间点之前的所有项目历史。

前提条件

关于项目如何发布到Maven中央仓库及其一些必要的条件这里不再讨论,网上有很多教程,有兴趣的可以去搜索一下。也可以参考Payment Spring Boot的pom.xml。这里只说一些关键的点,您需要:

  • OSSRH账号。

  • GPG密钥信息。

注意:这两个都是敏感数据不要泄露给其他人,否则你的项目将可能被其他人掌控。

Github Action Secrets

为了从Github Action发布,我们需要让Github Action可以使用我们的GPG私钥和OSSRH用户信息。为了保证这些敏感信息的安全性,我们可以使用Github Action Secrets来存储它们。

GPG的细节补充

这里的 GPG_PASSWORD为GPG的 Passphrase,网上Maven中央仓库教程肯定会提这个,这里不再细说。需要注意的是公钥一定要上传公钥服务器。

GPG_SECRET 获取步骤如下:

  • 确定你有GPG环境,并按照其它教程配置好了GPG密钥对。

  • 执行 gpg --list-secret-keys 查看Key列表并复制你需要用的ID

[root@192 ~]# gpg --list-secret-keys/root/.gnupg/pubring.kbx------------------------sec   rsa2048 2020-07-27 [SC]      8AC0AB86C34ADC6ED110A5A9E6730F4374866065uid           felord (felord) dax@felord.cn

执行gpg -a --export-secret-keys KEY_ID(KEY_ID为上图中以8AC0AB开头的字符串)导出私钥,这里需要输入保护私钥的密码(GPG_PASSWORD)。然后会出现以下的密文:

-----BEGIN PGP PRIVATE KEY BLOCK----............密文区域.............-----END PGP PRIVATE KEY BLOCK-----

这就是``GPG_SECRET 。

修改项目的POM

然后修改项目的pom.xml文件,模板我已经提出来了,不能修改的地方我已经写了注释:

    cn.felord    payment-spring-boot    1.0.9.RELEASE    pom    4.0.0    payment-spring-boot    wechat-pay and alipay sdk    https://github.com/NotFound403/payment-spring-boot                        Apache License, Version 2.0            https://www.apache.org/licenses/LICENSE-2.0.txt            repo            A business-friendly OSS license                                    felord            felord@qq.com            felord.cn                        payment-spring-boot-1.0.9.RELEASE        https://github.com/NotFound403/payment-spring-boot        scm:git:https://github.com/NotFound403/payment-spring-boot.git        scm:git:https://github.com/NotFound403/payment-spring-boot.git                                             deploy                                                                        org.apache.maven.plugins                        maven-source-plugin                                                                org.apache.maven.plugins                        maven-javadoc-plugin                                                                                    org.apache.maven.plugins                        maven-gpg-plugin                                                                        payment-spring-boot-autoconfigure        payment-spring-boot-starter                1.8        1.8        UTF-8        UTF-8        1.8        2.4.2        4.10.167.ALL        1.0.0.RELEASE        1.18.12        2.9.10        1.66        2.11.4        4.5.13                                ossrh            Nexus Release Repository            https://oss.sonatype.org/service/local/staging/deploy/maven2                            sonatype-nexus-snapshots            Nexus Snapshot Repository            https://oss.sonatype.org/content/repositories/snapshots                                                                                                                     org.apache.maven.plugins                    maven-source-plugin                    3.1.0                                                                        package                                                            jar-no-fork                                                                                                                            org.apache.maven.plugins                    maven-javadoc-plugin                    3.2.0                                            private                        true                        UTF-8                        UTF-8                        UTF-8                                                                                            compile                                                            jar                                                                                                                            org.apache.maven.plugins                    maven-gpg-plugin                    1.6                                                                        sign-artifacts                            verify                                                            sign                                                                                                                                                            --pinentry-mode                                    loopback                                                                                                                                                            org.sonatype.plugins                    nexus-staging-maven-plugin                    1.6.8                    true                                            ossrh                        https://oss.sonatype.org/                        false                                                                                            org.sonatype.plugins                nexus-staging-maven-plugin                        

结合你自己的项目进行必要的填充。

编写Github Action 脚本

Github Action脚本保存在项目根目录下的.github/workflows路径中。我们只需要编写一个yaml来声明执行的步骤即可,具体的语法可以去看相关的中文文档,这里只列出发布到Maven中央仓库的action脚本:

# 相当于脚本用途的一个声明name: Maven Central Repo Deployment# 触发脚本的事件  这里为发布release之后触发on:  release:    types: [released]# 定义一个发行任务jobs:  publish:# 任务运行的环境    runs-on: ubuntu-latest# 任务的步骤    steps:# 1. 声明 checkout 仓库代码到工作区      - name: Checkout Git Repo        uses: actions/checkout@v2# 2. 安装Java 环境 这里会用到的参数就是 Git Action secrets中配置的,#    取值要在key前面加  secrets.      - name: Set up Maven Central Repo        uses: actions/setup-java@v1        with:          java-version: 1.8          server-id: sonatype-nexus-staging          server-username: ${{ secrets.OSSRH_USER }}          server-password: ${{ secrets.OSSRH_PASSWORD }}          gpg-passphrase:  ${{ secrets.GPG_PASSWORD }}# 3. 发布到Maven中央仓库      - name: Publish to Maven Central Repo# 这里用到了其他人写的action脚本,详细可以去看他的文档。        uses: samuelmeuli/action-maven-publish@v1        with:          gpg_private_key: ${{ secrets.GPG_SECRET }}          gpg_passphrase: ${{ secrets.GPG_PASSWORD }}          nexus_username: ${{ secrets.OSSRH_USER }}          nexus_password: ${{ secrets.OSSRH_PASSWORD }}

触发Action

都准备完毕后,action脚本要提交到Github,当你使用release功能后会自动在action一栏中执行整个发布流程:

读到这里,这篇"怎么使用Github Action发布jar到Maven中央仓库"文章已经介绍完毕,想要掌握这篇文章的知识点还需要大家自己动手实践使用过才能领会,如果想了解更多相关内容的文章,欢迎关注行业资讯频道。

0