利用Github Actions自动化部署 Hexo博客

Github Action自动化部署是什么

简单说，就是把hexo博客编译前的源代码上传到github代码仓库，Action在代码发生变动的时候，自动通过安装一系列nodejs环境和相关依赖，编译生成html页面到github pages仓库。

再简单点说，就是把本地生成博客的工作，全部交给Action执行。

好处就是随时随地都能修改或增加博文

预览

https://1422756921.github.io/

前言

之前搭建的hexo到现在都没怎么看过，今天准备清理电脑磁盘的时候就发现了hexo源码，现在有空打算弄个自动化，免得以后不小心删了。使用 GitHub Actions 实现将 Hexo 博客自动编译并发布到 GitHub Pages 上。顺便记录一下

正文

做自动化部署前，先搭建好hexo并部署到GitHub pages上（可以参考这篇https://blog.aerr.cn/825.html

先建一个私有仓库（myhexo），这个仓库存放的是编译前的文件，也就是你电脑本地的文件，这个仓库是拿来做自动化的

也就是一共两个仓库

• 一个公有仓库存编译好的hexo（pages仓库，用户名例如是1422756921.github.io）
• 一个私有仓库存本地电脑编译前的文件（自动化仓库，用户名是myhexo）

上传编译前的代码

创建完私有仓库后，在本地博客文件中复制几个文件到另外一个文件夹，其中包括.github，scaffolds，source，themes，_config.yml，package.json，package-lock.json

还有一个很重要的一步：打开模板文件，把.git文件删除

然后回到根目录右键打开git bash

在git bash里依次输入以下命令

git init  #把这个目录变成Git可以管理的仓库
git add .   #添加当前目录文件到缓存区（别漏命令后面的点）
git commit -m "first commit"  #提交缓存区内容到本地库，并备注first commit

#下面两条命令二选一，就行了
git remote add origin https://github.com/用户名/自动化仓库名.git   #利用https关联远程仓库
git remote add origin git@github.com:用户名/自动化仓库名.git   #利用ssh关联远程仓库

git push -u origin master  #把本地库的所有内容推送到远程库上

同样SSH和HTTPS均可。SSH在绑定过ssh key的设备上无需再输入密码，HTTPS则需要输入密码，但是SSH偶尔会遇到端口占用的情况。

获取 Github token

打开https://github.com/settings/tokens
点击 Generate new token 新建个 token

note随便填，Expiration选择No expiration，勾选repo和workflow，其他没什么了，然后点生成就好了

把token复制下来

打开自动化仓库的Settings -> Secrets and variables -> Actions -> New repository secret

一共有三个变量名GITHUBTOKEN，GITHUBUSERNAME，GITHUBEMAIL，逐一添加

变量声明

变量名	常量释义
GITHUBMAIL	Github 用户邮箱地址
GITHUBTOKEN	Github token
GITHUBUSERNAME	Github 用户名

添加workflows

接下来点击Actions ->  set up a workflow yourself

复制以下代码到里面

name: 自动部署

on:
  push:
    branches:
      - main

  release:
    types:
      - published

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
    - name: 检查分支
      uses: actions/checkout@v2
      with:
        ref: main

    - name: 安装 Node
      uses: actions/setup-node@v1
      with:
        node-version: "16.x"

    - name: 安装 Hexo
      run: |
        export TZ='Asia/Shanghai'
        npm install hexo-cli -g

    - name: 缓存 Hexo
      uses: actions/cache@v1
      id: cache
      with:
        path: node_modules
        key: ${{runner.OS}}-${{hashFiles('**/package-lock.json')}}

    - name: 安装依赖
      if: steps.cache.outputs.cache-hit != 'true'
      run: |
        npm install --save

    - name: 生成静态文件
      run: |
        hexo clean
        hexo generate

    - name: 部署 #此处master:master 指从本地的master分支提交到远程仓库的master分支(不是博客的分支写master即可)，若远程仓库没有对应分支则新建一个。如有其他需要，可以根据自己的需求更改。
      run: |
        cd ./public
        git init
        git config --global user.name '${{ secrets.GITHUBUSERNAME }}'
        git config --global user.email '${{ secrets.GITHUBEMAIL }}'
        git add .
        git commit -m "${{ github.event.head_commit.message }} $(date +"%Z %Y-%m-%d %A %H:%M:%S") Updated By Github Actions"
        git push --force --quiet "https://${{ secrets.GITHUBUSERNAME }}:${{ secrets.GITHUBTOKEN }}@github.com/${{ secrets.GITHUBUSERNAME }}/${{ secrets.GITHUBUSERNAME }}.github.io.git" master:master  # GitHub配置
        git push --force --quiet "https://${{ secrets.TOKENUSER }}:${{ secrets.CODINGTOKEN }}@e.coding.net/${{ secrets.CODINGUSERNAME }}/${{  secrets.CODINGBLOGREPO }}.git" master:master  # coding配置
        git push --force --quiet "https://${{ secrets.GITEEUSERNAME }}:${{ secrets.GITEETOKEN }}@gitee.com/${{ secrets.GITEEUSERNAME }}/${{ secrets.GITEEUSERNAME }}.git" master:master  # gitee配置

上方代码配置包含 gitee 和 coding，请自行删减

粘贴上去后点击Commit changes...

就大功告成了，可以点击Actions查看运行进程了

最后，需要到GitHub pages那个仓库里面把默认页改成master就好了