不想阅读Github Action厚重的文档,用预配置好的NPM Action折腾了半天,终以失败告终。由于不熟悉NPM和Node.js,最后爆出的错误摸不到头脑,就此作罢。

寻找另一个方法,在 https://github.com/user/repo/actions/new 中选择了跳过,自己设置一个空白的Workflow。

  1. 为了避免Action重新推送仓库后循环触发Action(不知Github有没有对这种情况进行特殊处理)添加路径过滤器,仅当 /source 目录存在更新时才触发 Workflow

  2. 在仓库的 Settings->Deploy keys 里设置Github Action push时使用的SSH公钥,并赋予写权限,Settings->Secrets 里设置私钥的 Base64 编码。
    私钥会通过环境变量传入Action的shell,base64 -d 即可解码,base64编码是为了避免潜在的回车换行符问题(环境变量里出现的换行符似乎不能正确地写入文件)

  3. 【未解决的疑问】 克隆git仓库后的所有操作最好写在一个step里,否则Git的工作目录可能莫名其妙的变空,猜测有可能是因为Step并不是严格的按顺序执行的?(这点没有仔细看文档所以不知道)总之写在一个Step里肯定就没问题了。

  4. ~/.ssh/id_rsa 文件注意设定权限 0600 默认的权限过于宽松,SSH会不读取。

  5. ~/.ssh/config 里需写入

    1
    2
    Host *
    StrictHostKeyChecking no

    否则可能会弹出要求确认SSH fingerprint的交互消息。

  6. 记得设定 git config --global user.name/email 否则无法提交

  7. 如果使用了自定义的域名,注意 CNAME 文件是否在 hexo clean 后被删除,可能需要自己写回去。

  8. 注意部分Hexo主题可能以 git submodule 方式引入, Github Action 克隆仓库时不会自动克隆子模块,导致生成的所有页面空白,Hexo只会给出警告而不是错误。

附上自己写的workflow(糊成一坨,凑合能用)

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
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
name: Generate Hexo

on:
push:
paths:
- 'source/**'

jobs:
build:
name: Refresh
runs-on: ubuntu-latest
steps:
- name: Install Node.js and NPM
run: |
sudo apt-get install curl -y
curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
sudo apt-get install nodejs -y
echo '=====Show NPM version====='
npm -v
echo '=====Show Node.js version====='
node -v
- name: Install Hexo
run: |
sudo npm install -g hexo-cli
echo '=====Show HEXO version====='
hexo -v
- name: Prepare Key and SSH config
run: |
mkdir ~/.ssh
echo $DEPLOY_PRIVKEY | base64 -d > ~/.ssh/id_rsa
chmod 0600 ~/.ssh/id_rsa
echo 'Host *' >> ~/.ssh/config
echo ' StrictHostKeyChecking no' >> ~/.ssh/config
chmod 0600 ~/.ssh/config
env:
DEPLOY_PRIVKEY: ${{ secrets.DEPLOY_PRIVKEY }}
- name: Clone git repo
run: |
cd ~
echo '=====Show work path====='
pwd
git clone [email protected]:cpdyj/blog.git
cd blog
ls
echo '=====Show work path====='
pwd
cat ./package.json
npm install
npm audit fix
hexo clean
hexo g
echo "blog.iseki.space" > ./docs/CNAME
git config --global user.name "User name"
git config --global user.email "[email protected]"
git add docs
git commit -am "Auto generate on Github Action at `date`"
git push