使用GitHub Actions编译项目并将Jar发布到Maven Central仓库

知识改变命运,撸码使我快乐,2020继续游走在开源界

点赞再看,养成习惯

给我来个Star吧,点击了解下基于SpringBoot的组件化接口服务落地解决方案

在上一篇 GitHub Actions使用入门 文章中,我们了解到了该怎么去启用GitHub Actions功能,本篇文章来介绍下使用GitHub Actions怎么将我们的开源项目自动化构建后发布到Maven Central仓库中。

推荐阅读

新建workflow文件

本篇文章以我的开源框架 ApiBoot 为例,大家有兴趣的也可以去了解下这个开源框架,详情请访问:ApiBoot是什么?

在上一篇文章中我们提到过,GitHub Actions所需要的工作流文件要在.github/workflows文件夹内创建,那么接下来我们创建一个名为deploy.yml的工作流配置文件,配置name为该工作流的名称,如下所示:

# This is a basic workflow to help you get started with Actions

name: Publish package to the Maven Central Repository

配置触发的分支

我们还需要配置当前工作流在什么情况进行触发自动构建的事件,在deploy.yml配置文件内添加触发事件,如下所示:

# Controls when the action will run. Triggers the workflow on push or pull request
# events but only for the master branch
on:
  push:
    branches:
        - master
        - 2.3.x
  pull_request:
    branches:
        - master
        - 2.3.x

在上面我们配置了两种触发工作流程的事件,分别是:pushpull_request,也就是仓库收到推送更新以及pull_request时就会触发该工作流程,实现自动化构建。

GitHub Actions其实为我们提供了多种触发工作流程的事件,访问 触发工作流程的事件 了解详情。

配置工作任务

触发事件配置完成后我们就需要来配置当前工作流程所需要的系统环境以及每一个步骤所需要做的事情了。

构建系统

GitHub Actions支持针对工作流程中的每一个任务(Job)进行配置独立的构建系统版本,我们选择最新版本的Ubuntu来作为本次任务的运行系统环境,配置内容如下所示:

# A workflow run is made up of one or more jobs that can run sequentially or in parallel
jobs:
  # This workflow contains a single job called "build"
  build:
    # The type of runner that the job will run on
    runs-on: ubuntu-latest

我们今天文章的主题是Jar发布到Maven Central仓库,根据分析我们大约需要三个步骤来完成这一工作。

Step1:检出代码

首先我们需要将项目的源码检出到构建环境中,这时我们就可以借助GitHub Actions官方提供的actions/checkout来完成这一步骤,Action源码:https://github.com/actions/checkout

Step2:安装环境

ApiBoot 是一个Java项目(JDK1.8+),而且采用Maven进行构建项目,所以我们需要在构建的环境中安装相关的环境支持,GitHub Actions官方同样提供了相关的Action,名为:actions/setup-java,Action源码:https://github.com/actions/setup-java

Step3:执行发布

最后一步我们就需要通过mvn deploy命令来完成发布Jar,由于项目发布到Release仓库时需要GPG秘钥的支持,而我们期望的只是自动发布快照版本,所以可以通过-Dgpg.skip来排除GPG插件的介入。

全部步骤的配置内容如下所示:

# A workflow run is made up of one or more jobs that can run sequentially or in parallel
jobs:
    # Steps represent a sequence of tasks that will be executed as part of the job
    steps:
      # Checkout source code
      - uses: actions/checkout@v2
      # Install Java 1.8
      - uses: actions/setup-java@v1
        with:
          server-id: hengyu
          java-version: 1.8
          server-username: MAVEN_USERNAME
          server-password: MAVEN_PASSWORD
      # Publish to Apache Maven Central
      - run: mvn -B deploy -Dgpg.skip
        env:
          MAVEN_USERNAME: ${{ secrets.MAVEN_CENTER_USER_NAME }}
          MAVEN_PASSWORD: ${{ secrets.MAVEN_CENTER_PASSWORD }}

注意事项:使用Action时,需要指定版本号,通过@v?的这种方式,其实这个版本号是仓库源码的标签

配置GitHub Secrets

actions/setup-java@v1在执行时会创建Maven所需要的settings.xml文件,而在该文件内我们可以通过配置server-usernameserver-password来指定发布的目标仓库的用户名、密码。

由于该工作流配置文件是公开的,我们肯定不会明文进行配置GitHub针对这一点,提供了Secrets配置的方式,我们需要将存在安全性的变量进行配置,使用时注意变量名称的对应即可。

image

Secrets在使用时需要根据约定的格式配置:

${{ secrets.MAVEN_CENTER_USER_NAME }}

secrets为前缀,而后面的变量名必须与GitHub内的配置一致,如果你的相关Secrets配置需要用于多个项目,可以在组织下进行配置。

推送更新

到目前为止,我们的项目已经完成了GitHub Actions的配置,接下来需要将该工作流程配置文件推送()push)到目标仓库,推送后我们查看项目的Actions标签页的内容,如下所示:

image

每当我们推送代码时都会自动触发构建工作流程的事件,一个工作流程的任务都会有完整的日志记录,如下所示:

image

当一个任务的全部步骤都执行成功后,当前任务也算是真正的执行成功,如果一个工作流程文件内配置了多个任务,则是需要多个任务都构建成功后才算成功。

槽点

目前针对GPG的支持确实有点问题,GitHub官方所提供的Action也是会有一些问题,导致无法完成通过GPG的方式完成构建项目,如果这一点可以解决,就可以实现在GitHub仓库创建发布版本时触发工作事件,实现自动上传JarRelease仓库,省去了在本地发布的工作。

示例

本文的workflow配置文件内容可以访问:https://github.com/minbox-projects/api-boot/blob/2.3.x/.github/workflows/deploy.yml

作者个人 博客
使用开源框架 ApiBoot 助你成为Api接口服务架构师

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 157,298评论 4 360
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,701评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 107,078评论 0 237
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,687评论 0 202
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,018评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,410评论 1 211
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,729评论 2 310
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,412评论 0 194
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,124评论 1 239
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,379评论 2 242
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,903评论 1 257
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,268评论 2 251
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,894评论 3 233
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,014评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,770评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,435评论 2 269
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,312评论 2 260