原文发于我的博客和公众号:
CSDN博客
Noosphere博客”
智圈云公众号,了解相关信息可以关注“ 智圈云”
目标
我们知道使用github action 可以很简单的部署hexo的静态文件到github pages,但是如果在国内我们希望部署到github pages同时也部署到coding,然后通过dns双线路由,另外,我们可能有多个账号,比如公司的和个人的博客或者网站,也是同时部署到coding和github,那就这个github action解决不了,下面我们改造一下,使其达到这个目标:
- hexo的source存放在独立库
- 生成的静态文件存在独立的库
- 提交markdown文件后,自动生成静态文件
- 自动部署到github pages
- 自动部署到coding
- 同一份hexo source库,只需要配置一次hexo的
_config.yml
,就可以直接通过hexo deploy -g
或者git push
来触发部署 - 支持多个github账号,同时也支持多个coding账号
配置hexo的deploy
找到hexo根目录的_config.yml,然后配置deploy字段的内容如下
deploy:
type: 'git'
repo:
github: '[email protected]:noosphere-coder/noosphere-coder.github.io.git'
coding: '[email protected]:noosphere/noosphere.git'
branch: 'master'
这个配置目标是让我们直接hexo deploy
可以同时推送到 github 和 coding 的 pages 仓库
配置 hexo deploy命令支持多个github和coding账号
一般来说,如果我只有一个github的账号,在这个配置下直接执行hexo g -d
,一个命令就可以直接完成两个仓库的部署了。
那么如果我们的github账号有多个,比如有一个办公用的,一个私人的,那怎么办?
我们知道 git 的 ssh 推送方式是需要使用特定的 key 的, 所以,我们只需要配置 ssh 去路由特定的域名到key即可.
根据需求,在配置这个ssh key的路由之前,我们要先生成一个key用于做pages部署
ssh-keygen noosphere-coder
然后一路回车就行(不需要太强的安全性的话),生成后key在/home/$USER/.ssh/
目录下
为了这个key可以推送到github或者coding的独立账号,我们需要把这个key加入到github和coding的账号,比如我新建了一个noosphere-coder的github账号,那么我把这个noosphere-coder的ssh key作为这个账户的ssh key即可,打开[https://github.com/settings/keys](https://github.com/settings/keys)
,点击 New SSH key
增加即可,加入后,我们就可以用这个key来操作这个github账号了(coding也类似)。
接下来,我们用这个key来配置ssh key的路由,达到执行git push
命令的时候自动使用不同的key:
cat << EOF > /home/$USER/.ssh/config
Host github.com
HostName github.com
PreferredAuthentications publickey
IdentityFile /home/$USER/.ssh/id_rsa
Host noosphere-coder.github.com
HostName github.com
PreferredAuthentications publickey
IdentityFile /home/$USER/.ssh/noosphere-coder
Host e.coding.net
HostName e.coding.net
PreferredAuthentications publickey
IdentityFile /home/$USER/.ssh/id_rsa
Host noosphere-coder.coding.net
HostName e.coding.net
PreferredAuthentications publickey
IdentityFile /home/$USER/.ssh/noosphere-coder
EOF
这个配置告诉ssh,如果碰到Host为noosphere-coder.github.com
或者noosphere-coder.coding.net
的时候就去使用/home/$USER/.ssh/noosphere-coder
这个key
但是,由于我们新建的github的仓库,默认的remote url的是 [email protected]:noosphere-coder/hexo-noosphere.git
(coding亦如是)
所以我们需要修改这个仓库的remote url为[email protected]:noosphere-coder/hexo-action.git
git remote set-url origin [email protected]:noosphere-coder/hexo-action.git
coding项目也如法炮制即可。
截止目前,你用hexo g -d
就可以用不同的账号推送到github和coding了。
配置github CI Actions
上面章节,我们配置了git和hexo,完成了通过一个 hexo g -d
的命令直接推送到github和coding,并支持多个账号。
hexo g
是在本地生成静态文件,我们的source文件的仓库一般是放在github,然后配置为私有仓库,保证安全性,所以,我们接下来配置github CI actions,来达到直接直接用git push
来触发hexo g -d
,也就是,当我们git push
的时候,CI自动生成静态文件,然后自动推送到github和coding的静态pages仓库。
下面我们来看看最终的CI action的配置,然后再来解释
github hexo ci action
# This is a basic workflow to help you get started with Actions
name: CI
# Controls when the action will run. Triggers the workflow on push or pull request
# events but only for the master branch
on:
push:
branches: [ master ]
pull_request:
branches: [ master ]
# A workflow run is made up of one or more jobs that can run sequentially or in parallel
jobs:
# This workflow contains a single job called "build"
build-and-deploy:
# The type of runner that the job will run on
runs-on: ubuntu-latest
container:
image: node:13-alpine
steps:
# Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
- uses: actions/checkout@v1
with:
submodules: true # Checkout private submodules(themes or something else).
# Caching dependencies to speed up workflows. (GitHub will remove any cache entries that have not been accessed in over 7 days.)
# - name: Cache node modules
# uses: actions/cache@v1
# id: cache
# with:
# path: node_modules
# key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
# restore-keys: |
# ${{ runner.os }}-node-
- name: Install Dependencies
# if: steps.cache.outputs.cache-hit != 'true'
# run: npm ci
run: |
npm install
# Deploy hexo blog website.
- name: Deploy
id: deploy
# uses: noosphere-coder/hexo-action@master
uses: noosphere-coder/hexo-action@master
with:
deploy_key: ${{ secrets.DEPLOY_KEY }}
# user_name: your github username # (or delete this input setting to use bot account)
# user_email: your github useremail # (or delete this input setting to use bot account)
commit_msg: ${{ github.event.head_commit.message }} # (or delete this input setting to use hexo default settings)
# Use the output from the `deploy` step(use for test action)
- name: Get the output
run: |
echo "${{ steps.deploy.outputs.notify }}"
配置说明:
- 在这个配置里面,我们use了一个action,
[noosphere-coder/hexo-action@master](https://github.com/noosphere-coder/hexo-action)
,这个是我根据目标定制的一个action,来自于[sma11black/hexo-action](https://github.com/sma11black/hexo-action)
- 这里没有使用dependency cache,因为
node-sass
这本地构建的包在cache的情况下存在版本不一致的问题,暂时没找到解决办法
那么,这里我们为什么要定制一个自己的action,原因是smallblack/hexo-action
不支持同时推送到github和coding
因此,我们fork这个action的仓库来改造一下
改造 smallblack/hexo-action
的entrypoint.sh
#!/bin/sh
set -e
# setup ssh-private-key
mkdir -p /root/.ssh/
echo "$INPUT_DEPLOY_KEY" > /root/.ssh/id_rsa
chmod 600 /root/.ssh/id_rsa
ssh-keyscan -t rsa github.com >> /root/.ssh/known_hosts
ssh-keyscan -t rsa e.coding.net >> /root/.ssh/known_hosts
# you can change here to router domain with defferent key with you need
cat << EOF > /root/.ssh/config
Host github.com
HostName github.com
PreferredAuthentications publickey
IdentityFile /root/.ssh/id_rsa
Host $GITHUB_ACTOR.github.com
HostName github.com
PreferredAuthentications publickey
IdentityFile /root/.ssh/id_rsa
Host e.coding.net
HostName e.coding.net
PreferredAuthentications publickey
IdentityFile /root/.ssh/id_rsa
Host $GITHUB_ACTOR.coding.net
HostName e.coding.net
PreferredAuthentications publickey
IdentityFile /root/.ssh/id_rsa
EOF
chmod 600 /root/.ssh/config
# setup deploy git account
git config --global user.name "$INPUT_USER_NAME"
git config --global user.email "$INPUT_USER_EMAIL"
# install hexo env
npm install hexo-cli -g
npm install hexo-deployer-git --save
git clone https://github.com/$GITHUB_ACTOR/$GITHUB_ACTOR.github.io.git .deploy_git
echo 'have clone .deploy_git'
# npm remove node-sass hexo-renderer-scss
# npm install hexo-renderer-scss
# deployment
if [ "$INPUT_COMMIT_MSG" == "" ]
then
hexo g -d
else
hexo g -d -m "$INPUT_COMMIT_MSG"
fi
echo ::set-output name=notify::"Deploy complate."
这个改造也很简单
- 把我们上面生成的
noosphere-coder
的这个ssh key 配置成 变量,然后把它生成为跑action的容器的ssh key/root/.ssh/key
- 把coding的证书加入的known_hosts
- 配置ssh key 路由
看到第一点,我们就知道,我们需要把noosphere-coder的ssh key的秘钥加入到source仓库的secret key,并且命名为 DEPLOY_KEY
:
- 打开你github的source 仓库
- 点击
settings
- 点击
Secrets
- 点击
New secret
然后把本地的/home/$USER/.ssh/noosphere-coder
的内容复制进去即可。
总结
- 通过以上
折腾
,我们完成了一个比较优雅的hexo部署方式,既可以直接用在本地一条命令hexo g -d
直接部署到github和coding,也可以通过git push
来触发这个同时部署,而且github和coding的静态pages的仓库配置只需要在hexo的_config.yml配置一次就可以了。 - 同时,我们这个方法支持在机器上使用多个github或者coding账号,可以区分同时拥有如办公和私人账号的这类情况