如何使用 GitHub Actions 实现 Hexo 博客的 CICD

博主搭建的博客网站是基于hexo生成静态页面托管在github pages，一直以来都需要手动去编译发布，一直希望有一个能自动编译部署的工具，找了挺久的，尝试过hook到Jenkins执行发布脚本，但是这种是需要资源的，github的actions能完美的解决这个问题。

仓库准备

项目仓库	说明
https://github.com/WinterChenS/blog-back	用于存放 hexo 生成的项目，可以理解成源码
https://github.com/WinterChenS/WinterChenS.github.io	存放 hexo 编译后的静态文件，也是博客页面

秘钥生成

Hexo编译之后需要把生成的静态页面代码push到github pages的仓库，也就是 WinterChenS/WinterChenS.github.io ，没有秘钥就没有权限push。

随便找一台电脑或者服务器，生成秘钥：

ssh-keygen -f github-deploy-key # 三次回车即可

以上步骤会生成github-deploy-key 和 github-deploy-key.pub 两个文件。

配置github仓库

配置blog-back仓库

打开 https://github.com/WinterChenS/blog-back/settings/secrets 点击 Add new secrets，分别在:

• Name 输入 HEXO_DEPLOY_KEY
• Value 输入前面生成的私有KEY github-deploy-key 的内容

配置WinterChenS.github.io仓库

打开 https://github.com/WinterChenS/WinterChenS.github.io/settings/Deploy keys，点击 Add deploy key，分别在:

• Title 输入 HEXO_DEPLOY_KEY
• Key 输入前面生成的公KEY github-deploy-key.pub 的内容名称随意，但要勾选 Allow write access

编写 Action 脚本

使用前先要申请，直接打开https://github.com/WinterChenS/WinterChenS.github.io/actions/new

main.yml

name: Deploy Blog

on: [push] # 当有新push时运行

env:
  TZ: Asia/Shanghai

jobs:
  build: # 一项叫做build的任务

    runs-on: ubuntu-latest # 在最新版的Ubuntu系统下运行
    
    steps:
    - name: Checkout # 将仓库内master分支的内容下载到工作目录
      uses: actions/checkout@v1 # 脚本来自 https://github.com/actions/checkout
      
    - name: Use Node.js 10.x # 配置Node环境
      uses: actions/setup-node@v1 # 配置脚本来自 https://github.com/actions/setup-node
      with:
        node-version: "10.x"
    
    - name: Setup Hexo env
      env:
        ACTION_DEPLOY_KEY: ${{ secrets.HEXO_DEPLOY_KEY }} # 这里是上面WinterChenS.github.io新增的公钥：HEXO_DEPLOY_KEY
      run: |
        # set up private key for deploy
        mkdir -p ~/.ssh/
        echo "$ACTION_DEPLOY_KEY" | tr -d '\r' > ~/.ssh/id_rsa # 配置秘钥
        chmod 600 ~/.ssh/id_rsa
        ssh-keyscan github.com >> ~/.ssh/known_hosts
        # set git infomation
        git config --global user.name 'winterchens' # 换成你自己的邮箱和名字
        git config --global user.email '[email protected]'
        # install dependencies
        npm i -g hexo-cli # 安装hexo
        npm i
        # 拉取主题代码
        rm -rf themes/*
        git clone https://github.com/WinterChenS/hexo-theme-diaspora.git themes/diaspora
        
  
    - name: Deploy
      run: |
        # publish
        hexo generate && hexo deploy # 执行部署程序
        

修改blog-back根目录的_config.yml

如果你使用的是http，那么需要修改为ssh，已经是ssh就无须修改

deploy:
  type: git
  repo: [email protected]:WinterChenS/WinterChenS.github.io.git
  branch: master

以后只需要把代码提交到blog-back就可以自动进行编译发布了，是不是很爽，当然这只是冰山一角，很多CICD的功能超级强大的，github后面退出codespaces（在线IDE），以后实现真正的远程办公也不是问题了，更多的功能大家可以查看官方示例，自行去探索。