1. 前言

上次写了篇文章 使用github action同时部署hexo到github和coding最优雅的方式(支持多github账号)，从实现原理的角度做了介绍，由于实现的目标比较多，所以看起来比较复杂，这次我们不讲原理，仅仅按实现目标来介绍如何配置。

1.1 目标

先说我们要实现的目标，然后再按目标来介绍方法

  1. hexo的source存放在独立私有库jiuhao
  2. 生成的静态文件存放在github和coding独立的库
  3. 本地可以通过 hexo d -g一个命令一次性部署到github和coding
  4. 可以通过git push推送到github的surce仓库后，由action触发部署到github和coding的静态仓库
  5. 同时实现3和4，只需要配置一次_config.yml。而不需要在action里面写死目标静态仓库的地址，方便维护
  6. 支持多个github账号，同时也支持多个coding账号

说明：

  • 目标 1 把 source 放在独立的私有库是安全性考虑
  • 目标 3 和 4 是方便可以使用两种方法都能达到部署的目标， 3 是手工部署， 4 是通过git push触发，比如 github 的 action 可能某些原因失败了，暂时又没时间去维护，那么我可以直接在本地hexo d -g部署就行
  • 目标5是实现3和4的时候，两种方法的目标仓库(publish repo)地址配置只需要一处维护，不需要分散在 _config.yml 和 github action
  • 目标 6 是可选目标。 如果不需要区分工作和私人用的github 账号，可以不需要理会这个目标。

    1.2 已有的解决方案分析

为了达到上面这些目标，我找了一轮市面上各种各样的解决方案，没看到完全符合要求的。主要问题包括

  • github action market上的hexo action没有支持同时部署到github和coding的action可以直接重用
  • github action market上已有的hexo action的deploy方式无非两种，一种是直接把目标(publish repo)仓库地址配置action，一种是直接使用source里面_config.yml的配置. 如果是前者，则意味着我们需要吧publish repo写在两个地方，一个是本地的_config.yml一个是action。维护起来比较麻烦。明显应该使用后者。
  • 其他的一些博客提到的方法里面，大多存在前面一点存在的问题，而且大多是直接在action里定制脚本，没有抽成action，不方便重用。

就这样，观摩了一轮，我决定fork一个github mark上的hexo action出来，按需求自己弄一个action，经过考察，[sma11black/hexo-action](https://github.com/sma11black/hexo-action)这个action比较接近需求，只需要简单改造就可以使用，怎么改造这里就不说了，见上一篇文章

经过简单改造的action的仓库是 [noosphere-coder/hexo-action@master](https://github.com/noosphere-coder/hexo-action),下面我们直接使用就好

2 正文

2.1 只实现目标1-5的配置

排除掉目标6，只需要是实现上面说的1-5的目标，也即是我们可以使用我们平时已经在github和coding里面使用的ssh key就好。那么配置很简单

  1. 配置hexo的deploy

找到hexo根目录的_config.yml,然后配置deploy字段的内容如下

1
2
3
4
5
6
deploy:
  type: 'git'
  repo: 
    github: 'git@noosphere-coder.github.com:noosphere-coder/noosphere-coder.github.io.git'
    coding: 'git@e.coding.net:noosphere/noosphere.git'
  branch: 'master'
  1. 配置github CI Actions
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

name: CI

on:
  push:
    branches: [ master ]
  pull_request:
    branches: [ master ]

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    container:
      image: node:13-alpine

    steps:
    - uses: actions/checkout@v1
      with:
        submodules: true 
    
    - name: Install Dependencies
      run: |
        npm install

    - name: Deploy
      id: deploy
      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 }}  
    - name: Get the output
      run: |
        echo "${{ steps.deploy.outputs.notify }}"
  1. ssh key 配置
    3.1 私钥配置: 把/home/$USER/ssh/id_rsa的内容复制出来，在入口： {私有库}->settings->Secrets->New secret，新建名为DEPLOY_KEY的key，加入id_rsa的内容
    3.2 公钥配置: 把/home/$USER/ssh/id_rsa.pub分别配置在github和coding的目标仓库
    • github的配置入口是 {目标仓库}->settings->Deploy keys->add deploy keys
    • coding的配置入口是 {目标仓库}->设置->部署公钥->新建部署公钥

至此，实现1-5目标的配置已经完成，也就是，我们可以分别用下面这两种方式都可以同时部署到github和coding

1
hexo g -d # 或者 hexo d -g

和

1
git push origin master

2.2 [可选,不需要可以跳过] 实现目标6：使用独立的ssh key来部署（也就是可以新建多个的github账号来部署你的hexo站点）

目标6是采用另外的ssh key，而不是直接使用/home/$USER/ssh/id_rsa,一般来说，这样作无非是这几种目的

  1. 区分私人的id和工作用的key
  2. 不要直接使用id_rsa,减少安全隐患
  3. 同时维护多个隔离的hexo站点

为了达到这个目的，我们需要告诉ssh，在碰到这个hexo的仓库的时候，请使用独立的 key。下面我们来实现这个目标

  1. 生成独立的key用于部署（这里的key命名是nooshpere-coder）
1
ssh-keygen noosphere-coder
  1. 告诉ssh进行路由, 在终端执行下面命令，生成一份config配置到/home/$USER/.ssh目录
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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

  1. ssh key 配置，和上面的ssh key 配置配置步骤一样，只需要把id_rsa改成noosphere-coder的内容就行了。

  2. 把私有仓库的remote改掉

1
git remote set-url origin git@noosphere-coder.github.com:noosphere-coder/hexo-action.git

以上 noosphere-coder请替换成你自己的仓库名称

至此，目标6已经完成，这个时候，你再去执行git push的时候，ssh会自动使用独立的key而不会使用默认的id_rsa.

3. DNS双线配置

同时部署到github和coding主要是为了国内访问和国外访问流量区分，一个为了速度，二者为了搜索引擎收录（github封了百度的爬虫）

这个配置，实在没什么好讲的，直接上图吧

  1. DSN服务商的控制面板配置

DSN服务商的控制面板配置

  1. github的域名配置
    github的域名配置
  2. coding的的域名配置
    coding的的域名配置

如需要自己搭建hexo服务器，而不是用github和coding，请参考：
个人拥有云服务器能用来干啥好玩的？
阿里云、腾讯云、华为云多角度对比