一个最简单的 Github workflow 例子

源代码:

name: learn-github-actions
on: [push]
jobs:
  check-bats-version:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: actions/setup-node@v2
        with:
          node-version: '14'
      - run: npm install -g bats
      - run: bats -v

一个最简单的 Github workflow 例子_第1张图片

workflow

工作流程是您添加到仓库的自动化过程。

工作流程由一项或多项 jobs 组成,可以计划或由事件触发。

工作流程可用于在 GitHub 上构建、测试、打包、发布或部署项目。

本文例子里,我们创建了一个名称叫做 learn-github-actions 的 工作流。

一个最简单的 Github workflow 例子_第2张图片

event

事件是触发工作流程的特定活动。 例如,当有推送提交到仓库或者创建议题或拉取请求时,GitHub 就可能产生活动。 您还可以使用仓库分发 web 挂钩在发生外部事件时触发工作流程。 有关可用于触发工作流程的事件的完整列表,请参阅触发工作流程的事件。

本文例子,on: [push], 意思是有代码 push 到 Github 仓库时,触发该工作流。

一个最简单的 Github workflow 例子_第3张图片

Jobs

作业是在同一运行服务器上执行的一组步骤的集合。 默认情况下,包含多个作业的工作流程将同时运行这些作业。 您也可以配置工作流程按顺序运行作业。 例如,工作流程可以有两个连续的任务来构建和测试代码,其中测试作业取决于构建作业的状态。 如果构建作业失败,测试作业将不会运行。

本文例子,定义了一个叫做 check-bats-version 的作业。
一个最简单的 Github workflow 例子_第4张图片

steps

步骤是可以在作业中运行命令的单个任务。 步骤可以是操作或 shell 命令。 作业中的每个步骤在同一运行器上执行,可让该作业中的操作互相共享数据。

一个作业可以包含多个步骤。

action 操作

操作是独立命令,它们组合到步骤以创建作业。 操作是工作流程最小的便携式构建块。 您可以创建自己的操作,也可以使用 GitHub 社区创建的操作。 要在工作流程中使用操作,必须将其作为一个步骤,即放到一个 step 中去。

本文例子内包含的 actin 见下图高亮:

一个最简单的 Github workflow 例子_第5张图片

runner

运行器是安装了 GitHub Actions 运行器应用程序的服务器。 您可以使用 GitHub 托管的运行器或托管您自己的运行器。 运行器将侦听可用的作业,每次运行一个作业,并将进度、日志和结果报告回 GitHub。 GitHub 托管的运行器基于 Ubuntu Linux、Microsoft Windows 和 macOS,并且工作流程中的每个作业都在新的虚拟环境中运行。

本文例子的工作流,通过 yml 文件里的定义:

runs-on: ubuntu-latest

工作于 Github 托管的 Ubuntu 服务器上。

一个最简单的 Github workflow 例子_第6张图片

代码第7行:

- uses: actions/checkout@v2

uses 关键字指示作业检索名为 actions/checkout@v2 的社区操作的 v2。

这是检出仓库并将其下载到运行器的操作,允许针对您的代码运行操作(例如测试工具)。 只要工作流程针对仓库的代码运行,或者您使用仓库中定义的操作,您都必须使用检出操作。

- uses: actions/setup-node@v2
        with:
          node-version: '14'

安装 Node.js 运行环境到托管服务器上,版本为 14

这个工作流逻辑的可视化版本如下:

一个最简单的 Github workflow 例子_第7张图片

更多Jerry的原创文章,尽在:"汪子熙":

你可能感兴趣的:(一个最简单的 Github workflow 例子)