进一步缩减成本——更换博客 CD 为 Github Actions

认知.xKnow

2021-11-11

CI/CD, Github Actions

先前使用自建 Gitea + Drone 作为本博客的，好久不更新博客，突然想到了 Github 私有仓库 + Github Actions，我直接可以省掉 Gitea + Drone 的服务器运行成本。那么说干就干。

了解 Github Actions

在此之前，我居然没有用过 Github Actions，属实 Out 了。于是第一步是先了解一下 Github Actions。

毕竟也用过一些 CI/CD，用起来还算轻车熟路。Github Actions 与 Drone 类似，通过 yaml 文件定义响应的事件与执行的动作。

Github Actions 会扫描 .github/workflows 目录中的 yaml 文件，并根据定义的 workflow 进行工作。

在 Github Actions 执行过程中，会初始化一套运行环境，通过 runs-on 定义运行的系统，然后再执行具体的 steps。

name: Publish Blog Actions
on: push
jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: actions/setup-node@v2
        with:
          node-version: "16"

上述的配置中，使用了最新的 Ubuntu 环境来运行我们的 workflow，并且做了如下两件事：

使用 actions/checkout@v2 来拉取代码
使用 actions/setup-node@v2 初始化 Node 环境。

由此我们可以看到 Github 打造 Actions 生态的方案——Marketplace

在市场中我们可以找我们所需要的 Action，这些 Action 本质上与我们写的 workflow 并无不同，Github Actions 本质上是提供了一个环境，并且可以自由执行 Shell，可以执行 Shell 自然也就可以通过命令行配置各种环境，进行各种任务。这种模式比 Drone 使用 SDK 编写插件更为灵活。甚至很多 Marketplace 中的 Actions 的实现只是一个 action.yml 文件。

action.yml 中定义了参数，以及执行方式的 shell 命令，除了直接使用 Shell 命令配置环境等，也可以执行其他语言的脚本来工作。

到这里我们也明晰了该如何实现一个发布博客的 Github Actions 了。

重构博客发布 CD

首先梳理一下正常发布博客的流程：

已经配置好的 Node 环境与 Hexo 依赖；
npm run build 生成博客；
把生成的 public 目录上传到 oss 中。

那么在 Github Actions 中也是做如此的操作即可，只是在最开始需要先配置下环境，并且安装 Hexo 依赖。具体的配置如下：

name: Publish Blog Actions
on: push
jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: actions/setup-node@v2
        with:
          node-version: "16"
      - name: Install dependencies
        run: npm i
      - name: Build the blog
        run: npm run build
      - name: Prepare ossutil
        run: |
          wget -q http://gosspublic.alicdn.com/ossutil/1.6.10/ossutil64 -O ossutil
          chmod +x ossutil
      - name: Sync assets
        env:
          OSS_ENDPOINT: ${{ secrets.OSS_ENDPOINT }}
          OSS_ACCESS_KEY_ID: ${{ secrets.OSS_ACCESS_KEY_ID }}
          OSS_ACCESS_KEY_SECRET: ${{ secrets.OSS_ACCESS_KEY_SECRET }}
          OSS_BUCKET: ${{ secrets.OSS_BUCKET }}
        run: |
          ./ossutil config -e $OSS_ENDPOINT -i $OSS_ACCESS_KEY_ID -k $OSS_ACCESS_KEY_SECRET
          ./ossutil cp -rf ./public oss://$OSS_BUCKET/