用 GitHub Actions 自动化发布 Hexo 网站到 GitHub Pages

2019-10-10 约 717 字预计阅读 2 分钟次阅读

说实话不用每次都执行一大长串部署指令真的香啊！

准备Hexo网站

在本地建立一个Hexo站点，可以参考官方快速开始文档。
建立两个GitHub仓库，分别叫blog（私有的）和你的GitHub用户名.github.io（共有的）。前者用来存储博客源文件，后者用于挂载GitHub Pages。
将本地的博客源文件推送到blog仓库。

准备秘钥

为了方便运行GitHub Actions时登录GitHub账号，我们使用SSH方式登录。

使用ssh-keygen生成一组公私秘钥对

ssh-keygen -t rsa -b 4096 -f ~/.ssh/github-actions-deploy

在Settings->SSH and GPG keys添加刚刚生成的公钥，名称随意。

在blog仓库的Settings->Secrets里添加刚刚生成的私钥，名称为 ACTION_DEPLOY_KEY。

设置Hexo的部署配置

在_config.yml添加部署配置。

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
- type: git
  repo: git@github.com:bulabula.git # 使用仓库的ssh地址
  branch: master

配置 GitHub Actions

在blog仓库的Actions选项卡下点击新建workflow，编写如下配置。

name: Deploy Blog

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

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.ACTION_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 'bulabula' # 换成你自己的邮箱和名字
        git config --global user.email 'bulabula@athorx.com'
        # install dependencies
        npm i -g hexo-cli # 安装hexo
        npm i        
  
    - name: Deploy
      run: |
        # publish
        hexo generate && hexo deploy # 执行部署程序

参考

Github Actions 测试 - 自动部署 Hexo · xiaopc