如何使用 Github Action 管理 Issue

本文作者为 360 奇舞团前端开发工程师 Daryl

前言

很多小伙伴打开 github 上的仓库都只使用Code查看代码，或者只是把 github 当成一个代码仓库，但是 github 还提供了很多好用的功能。

其中，GitHub Action就是一个很好用的功能，本文将通过几个管理Issue的示例带大家了解GitHub Action:

什么是 Github Action

github 给所有用户都提供了临时可用的虚拟机， 我们通过创建 github action 工作流来使用这个虚拟机. 我们可以使用它来实现自动化部署、自动化测试、代码检查、管理 Issues...

使用步骤

在学习之前还需要准备一些资料:

1. Github Action文档

2. 官方仓库中有很多可以复用的 Action， 通过uses字段引用就可以直接使用了。

3. 阮一峰的YAML 教程；

也推荐大家使用Vscode GitHub Action插件，这个插件在登录后可以用来做语法校验，还能查看运行过的记录。

除了这些资料之外还有些基础概念需要了解:

1. 事件: 在工作流中可以监听 github 的一些事件， 在事件触发后执行我们定义的工作流;

2. 上下文: github 上下文包含有关工作流运行和触发运行的事件的信息，可以读取环境变量中的大多数 github 上下文数据，并允许我们通过变量访问这些数据。

3. 变量: 变量提供了一种存储和重用非敏感配置信息的方法。 可以将任何配置数据（如编译器标志、用户名或服务器名称）存储为变量。 变量在运行工作流的运行器计算机上插值。 在操作或工作流步骤中运行的命令可以创建、读取和修改变量。

4. 表达式: 可以使用表达式来运算工作流程文件中的变量。

5. 秘钥: 普通变量中存储的信息并不安全，很容易泄露，一些需要保密的信息就可以存储到秘钥中。

如果不想去从头学习yml语法， 可以先了解一些yml的基础用法:

• 大小写敏感

• 使用缩进表示层级关系

• 缩进时不允许使用 Tab 键，只允许使用空格。

• 缩进的空格数目不重要，只要相同层级的元素左侧对齐即可

---

下面开始介绍 GitHub Action 的用法

使用 github Action ，第一步需要在项目根目录下创建.github/workflows文件夹， 所有的工作流文件都要放到这个文件夹，当事件触发时会自动执行;

大家可以通过这个 workflow 文件示例来简单了解下各个字段的用处:

name: build # workflow的名称，缺省时会使用文件名
on: # workflow监听事件
  push # 具体的事件
    branches: # 在这些分支上才会触发
      - main
      - 'mona/octocat'
      - 'releases/**'
jobs: # 执行的工作的集合
  build: # ‘build’是一个自定义的工作的id<job_id>
    name: rele # 当前工作的名称
    runs-on: ubuntu-latest # 因为工作实际是运行在虚拟机上的，runs-on就是指定虚拟机的版本
    steps: # steps是步骤的集合
    - name: checkout # name是指定当前工作的名称 在workflow（工作流）文件的steps中，每个用‘-’代替缩进视为一个步骤的开始
      uses: actions/checkout@v2 # uses字段是选择一个可以直接复用的action，并且在github action store中的action可以直接使用，不需要下载
    - name: setting env
      id: setting # id 是步骤的唯一标识符，可以使用 id 在上下文中引用该步骤
      env: # 设置环境变量
        NODEV: 18
      run: echo "nodev=$NODEV" >> $GITHUB_OUTPUT # run字段会在命令行执行一条命令，这个命令是将"nodev=18"写入到$GITHUB_OUTPUT，这样可以为'output'添加test属性值为test1，详情参考
    - name: addnode
      uses: actions/setup-node@v3 # 使用node环境
      with: # 为‘uses’使用的action传递参数
        node-version: ${
   {steps.setting.output.nodev}} # 使用上面设置的变量

在编写工作流文件之前有两件事要做:

一. 可以在 github 或者 github action 的仓库里查找公用 action.这样可以减少很多工作量:

常用的 action 有:

• checkout: 帮我们自动把项目克隆到虚拟机上

• Setup Node: 自动安装 node

• issues-helper: 辅助处理 issues

二.