一个最简单的 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
workflow
工作流程是您添加到仓库的自动化过程。
工作流程由一项或多项 jobs 组成,可以计划或由事件触发。
工作流程可用于在 GitHub 上构建、测试、打包、发布或部署项目。
本文例子里,我们创建了一个名称叫做 learn-github-actions 的 工作流。
event
事件是触发工作流程的特定活动。 例如,当有推送提交到仓库或者创建议题或拉取请求时,GitHub 就可能产生活动。 您还可以使用仓库分发 web 挂钩在发生外部事件时触发工作流程。 有关可用于触发工作流程的事件的完整列表,请参阅触发工作流程的事件。
本文例子,on: [push], 意思是有代码 push 到 Github 仓库时,触发该工作流。
Jobs
作业是在同一运行服务器上执行的一组步骤的集合。 默认情况下,包含多个作业的工作流程将同时运行这些作业。 您也可以配置工作流程按顺序运行作业。 例如,工作流程可以有两个连续的任务来构建和测试代码,其中测试作业取决于构建作业的状态。 如果构建作业失败,测试作业将不会运行。
本文例子,定义了一个叫做 check-bats-version 的作业。
steps
步骤是可以在作业中运行命令的单个任务。 步骤可以是操作或 shell 命令。 作业中的每个步骤在同一运行器上执行,可让该作业中的操作互相共享数据。
一个作业可以包含多个步骤。
action 操作
操作是独立命令,它们组合到步骤以创建作业。 操作是工作流程最小的便携式构建块。 您可以创建自己的操作,也可以使用 GitHub 社区创建的操作。 要在工作流程中使用操作,必须将其作为一个步骤,即放到一个 step 中去。
本文例子内包含的 actin 见下图高亮:
runner
运行器是安装了 GitHub Actions 运行器应用程序的服务器。 您可以使用 GitHub 托管的运行器或托管您自己的运行器。 运行器将侦听可用的作业,每次运行一个作业,并将进度、日志和结果报告回 GitHub。 GitHub 托管的运行器基于 Ubuntu Linux、Microsoft Windows 和 macOS,并且工作流程中的每个作业都在新的虚拟环境中运行。
本文例子的工作流,通过 yml 文件里的定义:
runs-on: ubuntu-latest
工作于 Github 托管的 Ubuntu 服务器上。
代码第7行:
- uses: actions/checkout@v2
uses 关键字指示作业检索名为 actions/checkout@v2 的社区操作的 v2。
这是检出仓库并将其下载到运行器的操作,允许针对您的代码运行操作(例如测试工具)。 只要工作流程针对仓库的代码运行,或者您使用仓库中定义的操作,您都必须使用检出操作。
- uses: actions/setup-node@v2
with:
node-version: '14'
安装 Node.js 运行环境到托管服务器上,版本为 14
这个工作流逻辑的可视化版本如下:
- 点赞
- 收藏
- 关注作者
评论(0)