via：https://4qo.cn/WEd0Wk

开启 GitHub Actions 只需一个配置文件，这个文件就是 workflow（工作流），它需要存在仓库目录下 .github/workflows/*.yml，文件名任意，但需要是一个 YAML 配置文件。

这个文件用来规定自动化操作在什么时候触发启动，然后需要做哪些事情，比如这样：

name: Deploy
on:
  push:
    branches:
      - master
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout master
        uses: actions/checkout@v2
        with:
          ref: master
      - name: Setup node
        uses: actions/setup-node@v1
        with:
          node-version: "10.x"
      - name: Build project
        run: yarn && yarn build
      - name: Upload COS
        uses: zkqiang/tencent-cos-action@master
        with:
          args: delete -r -f / && upload -r ./dist/ /
          secret_id: ${{ secrets.SECRET_ID }}
          secret_key: ${{ secrets.SECRET_KEY }}
          bucket: ${{ secrets.BUCKET }}
          region: ap-shanghai

首先配置里所有 name 都是可以自定义的，只是用于可视化中进行识别。

on: 用来指定启动触发的事件，push 则表示在监听到 git push 到指定分支时触发。如此之外还可以是 pull_request。

jobs: 是工作任务，可以包含多个 job，并且每个 job 是独立的虚拟环境。不同 job 之间默认是并行的，如果想顺序执行，可以这样 build-job: needs: test-job。

runs-on: 用来指定执行系统环境，不仅有常用的 Linux 发行版，还可以是 macOS 或 Windows。

steps: 表示每个 job 需要执行的步骤，比如这里我分成了四步：拉取分支 → 安装 Node 环境 → 构建项目 → 上传 COS。

uses: 指的是这一步骤需要先调用哪个 Action。

Action 是组成工作流最核心最基础的元素。每个 Action 可以看作封装的独立脚本，有自己的操作逻辑，我们只需要 uses 并通过 with 传入参数即可。

比如 actions/checkout@v2 就是官方社区贡献的用来拉取仓库分支的 Action，你不需要考虑安装 git 命令工具，只需要把分支参数传入即可。

更多 Action 你可以通过 GitHub 顶部的 Marketplace 里找到，不过问题来了，我在其中搜索腾讯 COS 并没有找到相关 Action。

腾讯官方提供了 coscmd 命令行工具，是基于 Python 开发，很可惜没有二进制版本。因此如果使用在 Actions 中，就必须有 Python 环境，有两种思路：

在 Steps 里加入 actions/setup-python 这一步骤安装 Python 环境，然后再使用 pip install coscmd；

将上面的步骤封装成独立的 Action，之后直接 uses 即可。

第一种很简单，可以在 steps 里加入：

steps:
- uses: actions/setup-python@v1
  with:
    python-version: '3.x'
    architecture: 'x64'
- name: Install coscmd
  run: pip install -U coscmd
- name: Upload COS
  run: |
    coscmd config ....
    coscmd upload -r ./dist/ /

但是我选择了第二种，顺便了解如何创建自己的 Action。