GitHub Pages 配合 GitHub Actions 实现文档网站自动部署

最近在用 docusaurus 做一个文档网站，通过 GitHub Pages 进行部署，每次部署的时候，需要在本地执行构建命令，然后将构建产物提交到 GitHub 上面，比较麻烦。因此这边用了 GitHub Action 实现持续集成。

持续集成由很多操作组成，比如拉取代码、执行测试用例、登录远程服务器，发布到第三方服务等等。GitHub 把这些操作就称为 actions。

我们先来了解一下一些术语：

• workflow（工作流程）：持续集成一次运行的过程，就是一个 workflow。
• job（任务）：一个 workflow 由一个或多个 jobs 构成，含义是一次持续集成的运行，可以完成多个任务。
• step（步骤）：每个 job 由多个 step 构成，一步步完成。
• action（动作）：每个 step 可以依次执行一个或多个命令（action）。

workflow 文件

GitHub Actions 的配置文件叫做 workflow 文件，存放在代码仓库的 .github/workflows 目录。

workflow 文件采用 YAML 格式，文件名可以任意取，但是后缀名统一为 .yml，比如 deploy.yml。一个库可以有多个 workflow 文件。GitHub 只要发现 .github/workflows 目录里面有 .yml 文件，就会自动运行该文件。

workflow 文件的配置字段非常多，这里列举一些基本字段。

name

name 字段是 workflow 的名称。

如果省略该字段，默认为当前 workflow 的文件名。

name: deploy for feature_dev

on

on 字段指定触发 workflow 的条件，通常是 push、pull_request。

指定触发事件时，可以限定分支或标签。

on:
  push:
    branches:
      -