Github Actions 自动部署 Hexo

背景

昨天尝试了Cloudflare的pages功能,它可以识别一个vue工程文件,然后自动build,最后自动部署给你一个域名来访问,智能地令人害怕。

于是我想,如果github也能实现类似的操作该有多好,毕竟我github上还存着不少的vue项目。

这让我想起了7att1ce给我推荐过很多次的github actions。在参考了 GitHub Actions 入门教程 - 阮一峰的网络日志 (ruanyifeng.com)后,我了解到github actions有一个商店 Marketplace,就在github菜单栏里。

GitHub Marketplace

于是我搜索关键词Vue,找到了一个十分不错的acion Vue to Github Pages · Actions · GitHub Marketplace,最终我把SeTu Index Project 直接部署到了github pages上。项目地址:wuuconix/setu: Setu Index Project (github.com)

在实现了vue项目的自动部署后,我便想着把博客也给自动部署了。

过程

首先我同样在 商店里搜索 关键词 hexo,选取了其中最高star的acion进行了尝试,但是失败了。action的过程没有报错,但是没有上传到github.io这个pages项目里。

然后我尝试了hexo官方的github actions部署教程,发现它是把build的产物放在了源仓库里的 另一个分支里面,而github pages的开通需要仓库为public,但是博客源文件我是不想让人看见的,因为我有两篇需要密码才能看的加密文章。所以这也失败了。

最后,我学习了github action的相关语法,在参考了几个文章后,自己写了一个action,代码如下。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
name: Deploy                      # Actions 显示的名字,随意设置
on: [push] # 监听到 push 事件后触发
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout # 拉取当前执行 Actions 仓库的指定分支
uses: actions/checkout@v2
with:
ref: main

- name: Setup Node # 使用node 14
uses: actions/setup-node@v2
with:
node-version: "14"

- name: NPM INSTALL #安装依赖
run: |
npm install hexo-cli -g
npm install

- name: Add KEY #这里需要提供一个ssh私钥,用你平时常用机器里的 ~/.ssh/id_rsa即可
env:
SSH_PRIVATE: ${{ secrets.SSH_PRIVATE }}
run: |
mkdir -p ~/.ssh/
echo "$SSH_PRIVATE" > ~/.ssh/id_rsa
chmod 700 -R ~/.ssh
ssh-keyscan github.com >> ~/.ssh/known_hosts
git config --global user.email "输入你的邮箱"
git config --global user.name "输入你的github名字"

- name: Hexo Deploy # hexo deploy 会自动build然后上传到github.io项目中
run: |
hexo clean
hexo deploy

它的主要工作步骤是

  1. 利用 actions/checkout@v2 拉取本项目的main分支到 action虚拟机。

  2. 利用 actions/setup-node@v2 在虚机里配置 node 14的环境。

  3. 利用npm全局安装hexo脚手架,然后 npm install安装博客的依赖。

  4. 把一个私钥给虚机(因为之后的hexo deploy)设计到对仓库的上传,我这里直接把 wsl里的 ~/.ssh/id_rsa 放到 博客源码仓库的 secrets.SSH_PRIVATE了。

    这样就能保证虚机能够正常更新pages仓库。

  5. 调用hexo deploy

结果截图

  1. 本地git push

    git push

  2. 博客源码仓库 发现push请求,开始build,只花了40秒就完成了。

    build

  3. pages仓库接收到变化,pages自动执行更新操作(所以github pages 自带了一个action)

    pages

战术总结

现在博客直接放 github,测试了一下访问速度,感觉和放阿里云上没有区别。

https://wuuconix.link

而且以后本地也不用hexo g了,直接hexo s预览,预览感觉ok了,直接git push,actions会自动帮你build 和 更新pages。

十分舒适!


Github Actions 自动部署 Hexo
https://wuuconix.link/2022/01/08/actions/
作者
wuuconix
发布于
2022年1月8日
许可协议