优雅的将hexo部署到github和coding
文章目录
1. 前言
上次写了篇文章 使用github action同时部署hexo到github和coding最优雅的方式(支持多github账号),从实现原理的角度做了介绍,由于实现的目标比较多,所以看起来比较复杂,这次我们不讲原理,仅仅按实现目标来介绍如何配置。
1.1 目标
先说我们要实现的目标,然后再按目标来介绍方法
- hexo的source存放在独立私有库jiuhao
- 生成的静态文件存放在github和coding独立的库
- 本地可以通过
hexo d -g
一个命令一次性部署到github和coding - 可以通过
git push
推送到github的surce仓库后,由action触发部署到github和coding的静态仓库 - 同时实现3和4,只需要配置一次
_config.yml
。而不需要在action里面写死目标静态仓库的地址,方便维护 - 支持多个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就好。那么配置很简单
- 配置hexo的deploy
找到hexo根目录的_config.yml,然后配置deploy字段的内容如下
1 | deploy: |
- 配置github CI Actions
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
,一般来说,这样作无非是这几种目的
- 区分私人的id和工作用的key
- 不要直接使用id_rsa,减少安全隐患
- 同时维护多个隔离的hexo站点
为了达到这个目的,我们需要告诉ssh,在碰到这个hexo的仓库的时候,请使用独立的 key。下面我们来实现这个目标
- 生成独立的key用于部署(这里的key命名是nooshpere-coder)
1 | ssh-keygen noosphere-coder |
- 告诉ssh进行路由, 在终端执行下面命令,生成一份config配置到
/home/$USER/.ssh
目录
1 | cat << EOF > /home/$USER/.ssh/config |
ssh key 配置,和上面的
ssh key 配置
配置步骤一样,只需要把id_rsa改成noosphere-coder的内容就行了。把私有仓库的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封了百度的爬虫)
这个配置,实在没什么好讲的,直接上图吧
- DSN服务商的控制面板配置
- github的域名配置
- coding的的域名配置
如需要自己搭建hexo服务器,而不是用github和coding,请参考:
个人拥有云服务器能用来干啥好玩的?
阿里云、腾讯云、华为云多角度对比