山月行
阿里云双十一优惠活动，点击链接进行购买: 一年仅需89元即可以购买服务器~。我个人服务器为2核4G配置，也更加推荐购买 2核4G三年799元 配置的服务器。
你可以跟着我的笔记 当我有一台服务器时，我做了什么 来开始维护服务器并搭建应用，将引导你使用 docker 和 k8s 搭建一个自己的服务器开发集群。

# github actions 入门指南及实践

自从 github 提供了 github actions 后，个人或者依赖于 github 的公司可以考虑把持续集成方案迁到 github actions。

github 会提供一个以下配置的服务器做为 runner，可以说相当良心了。

  • 2-core CPU
  • 7 GB of RAM memory
  • 14 GB of SSD disk space

另外如果你有网络时延的需求，（比如推送及拉取镜像时产生的网络时延），你也可以自建 runner。

本文将介绍 github actions 的用法，以及如何使用它自动部署个人博客或者前端应用

# 快速开始

在 github 上进入个人仓库，找到 Actions 的标签页

Actions

如果你是一个前端项目，可以使用 Node.js 的模板，点击 Set up this workflow

Actions Setup

此时生成了一个文件 .github/workflows/nodejs.yaml，修改内容如下

name: Git Action Test

on: [push]

jobs:
  build:

    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v1
    - name: Use Node.js 10.x
      uses: actions/setup-node@v1
      with:
        node-version: 10.x
    - name: npm install, build
      run: |
        npm install
        npm run build --if-present
      env:
        CI: true

执行 git push 操作，此时可以在 github 的 Actions 标签页看到执行结果

Actions Start

# 术语

  • runner: github 分配的用来执行 CI/CD 的构建服务器 (也可以自建 runner)
  • workflow: CI/CD 的工作流
  • job: 任务，比如构建，测试和部署。每个 workflow 由多个 job 组成
  • step: 每个 job 由多个 step 组成

# 配置

参考官方文档: Workflow syntax for GitHub Actions (opens new window)

以下是常用到的配置

# on

该 CI/CD 触发时的事件。如果需要上传代码自动部署的功能时，应该选择 on: push

on: push

更多事件可以参考官方文档 Events that trigger workflows (opens new window)

另外，我们可以利用 issues 事件做很多事情，如邮件通知之类

如果是 Issue 类博客，则可以通过监听 issues.opened 事件，调用 github api，自动生成网址博客

on:
  issues:
    types: [opened, edited, milestoned]

# jobs

一个 CI/CD 的工作流有许多 jobs 组成，比如最典型的 job 是 lint，test，build 或者 deploy。

jobs:
  test:
  build: 
  deploy:

所有的 job 都是并行的，但往往会有依赖关系：你总得通过测试了，才能再去部署吧

# jobs.<job_id>.needs

needs 确定 job 的依赖关系

jobs:
  test:
  deploy:
    needs: test

# jobs.<job_id>.runs-on

当你使用 github actions 时，github 会十分大方的给你分配一个配置还不错的服务器作为构建服务器，用来跑你的 workflow

  • 2-core CPU
  • 7 GB of RAM memory
  • 14 GB of SSD disk space

恩，比我自己的服务器要强

使用 runs-on 指定服务器系统，用的最多的应该就是 ubuntu-latest 了

runs-on: ubuntu-latest

runs-on: windows-latest

# jobs.<job_id>.steps

即某个任务的一系列动作，如部署一个前端需要安装依赖，编译代码等等

# jobs.<job_id>.steps.name

为 step 指定一个名称，将会在 github action 的控制台中显示

# jobs.<job_id>.steps.run

该 step 需要在 shell 中执行的命令

# 单行
- name: Install Dependencies
  run: npm install

# 多行
- name: Install and Build
  run: |
    npm install
    npm run build

# jobs.<job_id>.steps.uses

选择一个 action，可以理解为若干 steps.run，有利于代码复用。这也是 github action 最主要的功能。

如果你想找一个好用的 github action，可以在 github marketplace 浏览并检索

这是一个在当前操作系统中安装 node:10 的 action 示例

- name: use Node.js 10.x
  uses: actions/setup-node@v1
  with:
    node-version: 10.x

当然，这里怎么能少得了 docker 的身影呢，在 actions 中也可以使用 docker。如果对 docker 不太了解，可以看我的文章: docker 简易入门 (opens new window)

以下是 npm install 的一个示例

jobs:
  build:
    steps:
      - name: Install
        uses: docker://node:alpine
        with:
          args: npm install

# secret and context

如何在 github action 上访问敏感数据？如使用 ssh 登录时如何维护密码。

我们可以在 github repo 上依次点击 Settings -> Secrets 设置 secret

Actions Secrect

- name: setup aliyun oss
  uses: manyuanrong/setup-ossutil@master
  with:
    endpoint: oss-cn-beijing.aliyuncs.com
    access-key-id: ${{ secrets.OSS_KEY_ID }}
    access-key-secret: ${{ secrets.OSS_KEY_SECRET }}

这里的 secret 就是一种 context，描述 CI/CD 一个 workflow 中的上下文信息，使用 $ 语法表示。除了 secret，还有

  • github: workflow 的信息，如 github.sha 可以获取当前的 commit SHA，我们可以利用它为 sentry 或者 docker image 打入版本号
  • env: 环境变量
  • job: 当前执行 job 的信息，如 job.status 表示当前 job 的执行状态
  • matrix: 描述一些构建信息，如 node 以及 os 版本号

更多 context 信息可以参考官方文档 Contexts and expression syntax for GitHub Actions (opens new window)

# 实践一：博客自动部署

我的博客目前托管在阿里云OSS上，以下 action.yaml 描述了自动部署的流程。可以参考我的配置 shfshanyue/blog (opens new window)

关于托管在阿里云OSS的细节，可以参考 在阿里云OSS托管你的前端应用

name: deploy to aliyun oss

on: [push]

jobs:
  build:

    runs-on: ubuntu-latest

    steps:
    # 切代码到 runner
    - uses: actions/checkout@v1
      with:
        submodules: true
    # 下载 git submodule
    - uses: srt32/git-actions@v0.0.3
      with:
        args: git submodule update --init --recursive
    # 使用 node:10
    - name: use Node.js 10.x
      uses: actions/setup-node@v1
      with:
        node-version: 10.x
    # npm install
    - name: npm install and build
      run: |
        npm install
        npm run build
      env:
        CI: true
    # 设置阿里云OSS的 id/secret，存储到 github 的 secrets 中
    - name: setup aliyun oss
      uses: manyuanrong/setup-ossutil@master
      with:
        endpoint: oss-cn-beijing.aliyuncs.com
        access-key-id: ${{ secrets.OSS_KEY_ID }}
        access-key-secret: ${{ secrets.OSS_KEY_SECRET }}
    - name: cp files to aliyun
      run: ossutil cp -rf .vuepress/dist oss://shanyue-blog/

部署成功

部署成功

# 实践二：Github Readme 自动生成

2020年8月份，就是我裸辞的那个月，Github 上线了个人主页功能，即创建 Github 用户名的同名 Repo，其中的 Readme.md 就是自己的个人主页。例如我，创建一个 shfshanyue/shfshanyue 的仓库，既可以通过 Readme.md 来创建个人主页

此时涌现了各种各样的 Github Actions 来自定义个人主页，大致思路如下：

  1. Github API 获取自身 Github 动态，写入指定格式的 Readme
  2. Github Actions 自动提交代码

其中一个 waka-readme-stats (opens new window)，可制作以下漂亮的个人主页

📅 I'm Most Productive on Sundays

Monday       50 commits     ███░░░░░░░░░░░░░░░░░░░░░░   13.19% 
Tuesday      85 commits     █████░░░░░░░░░░░░░░░░░░░░   22.43% 
Wednesday    56 commits     ███░░░░░░░░░░░░░░░░░░░░░░   14.78% 
Thursday     44 commits     ███░░░░░░░░░░░░░░░░░░░░░░   11.61% 
Friday       28 commits     █░░░░░░░░░░░░░░░░░░░░░░░░   7.39% 
Saturday     30 commits     ██░░░░░░░░░░░░░░░░░░░░░░░   7.92% 
Sunday       86 commits     █████░░░░░░░░░░░░░░░░░░░░   22.69%

# 实践三：定时任务的脚本服务器

这简直是在薅羊毛啊！

先献上一个使用了 Github Actions 的工具：B站自动签到工具 (opens new window)。

通过GitHub Actions实现每日线上自动运行任务：每日自动登录、观看、分享、投币视频，获取每日任务的满额经验，轻松升级Level 6，实现自动领取大会员权益、月底自动为自己充电等功能。

关于其它有趣的可薅羊毛的定时任务，就需要充分发挥你的想象力了！以下是可以做的几个有意思的事情

  1. 微信公众号定时上传素材
  2. 各种社交平台自动签到
Last Updated: 12/7/2020, 11:01:00 PM

← 3. Netlify: 前端托管 →