使用Travis Ci使hexo自动生成并部署
2016-12-23
1151 字
6 分钟

前两天偶然看见v2ex上有人说使用travis ci做hexo的持续集成,想起对哦,何必需要每次写完博客再进行手动的hexo clean && hexo g && hexo d呢

为什么选择travis ci#

因为他和github配合的很好,如果是github的开源项目,travis ci 永久免费

言下之意,如果你是使用github pages来托管你的博客的话,那travis ci简直就是最好的搭档

travis ci 开源项目永久免费

注册travis ci#

什么鬼,没有注册,travis-ci.org也只支持使用github登录

开启travis ci对项目的trigger#

没什么难的,进右上角头像里的accounts,按照出现的提示打开repo的开关就可以了

撰写.travis.yml#

官方的nodejs的specific doc

Getting Started

如果你想再加hook,那么自己看官方文档去,这里对我自己的travis.yml稍作解释

Hosted on GitHub

language: node_js
node_js:
  - '6'
before_install:
  - export TZ='Asia/Shanghai'
  - npm install hexo-cli -g
install:
  - npm install
script:
  - hexo clean && hexo g
after_script:
  - git config --global user.name "xingoxu"
  - git config --global user.email "[email protected]"
  - git clone https://${GH_REF} .deploy_git
  - cd .deploy_git
  - git checkout master
  - cd ../
  - sed -i'' "s~${GH_REF}~${GH_TOKEN}:x-oauth-basic@${GH_REF}~" _config.yml
  - hexo d > log.txt 2>&1
  - cat log.txt | sed "s~${GH_TOKEN}~TOKEN~g"
branches:
  only:
  - source
env:
  global:
  - GH_REF: github.com/xingoxu/xingoxu.github.io.git

前面的不用多说,需要关注的是部署的问题

解决git push的证书问题#

普通的push肯定是需要ssh的key的,或者https的话需要输入用户名和密码

然鹅,这里是持续化环境中,也就是虚拟机环境中,那根本没法询问用户啊

所以我们要给我们的部署施加一些小魔法

那就是,github的开发者api。使用github的api,使用personal access token与push链接的拼接以达到不登陆的效果

进入Settings -> Personal access tokens

新建一个token,我给他命名为travis

然后勾上repo的相应权限

写在push链接里的token

然后,要注意的是,这样的密钥是不能写在.travis.yml中的,那坏人看到了,肯定能拿去干坏坏的事情

于是,可以放在travis ci的repo的settings的环境变量中

travis ci repo setting

可以在文件中以${变量名}来引用

文件中的env global,和在这里设置的效果相同

所以

sed -i'' "s~${GH_REF}~${GH_TOKEN}:x-oauth-basic@${GH_REF}~" _config.yml

就会变成

sed -i'' "s~github.com/xingoxu/xingoxu.github.io.git~这里是密钥:[email protected]/xingoxu/xingoxu.github.io.git~"

以将config.yml中的deploy的地址改成这样的一个拼接地址,就不需要密钥啦

解决master commit树被清空#

如果仅解决push问题,那么你会发现,你部署分支的commit树被清空了

其实也不是什么很大的问题,但感觉看起来很丑,每次更新都像是一个新站点,没有历史更新记录,虽然这样以后你可以用source的commit来记录和回溯,但,总觉得怪怪的

使用下面的git命令来解决问题

git clone https://${GH_REF} .deploy_git
cd .deploy_git
git checkout master
cd ../

其实是很简单的git操作,就是需要注意一下

最后注意下主题文件夹如果是git文件夹的问题,不过这个应该不算是持续集成的问题

解决hexo d显示出私钥的问题#

travis ci的build log是可以被大家看到的,但是,在添加变量那边关掉后 就不会显示出来了,然而,这也仅限于使用${}来引用他的地方,git push时,会把此地址再显示一遍,这样你的私人密钥又会被显示了

于是乎我把hexo d的命令改成了这两行

hexo d > log.txt 2>&1
cat log.txt | sed "s~${GH_TOKEN}~TOKEN~g"

将hexo d的输出,包括标准与非标准,全部输入到log.txt,再cat出来的时候,使用sed对里边含有GH_TOKEN统统替换成TOKEN字符串

我对linux命令不怎么样熟悉,只能写成这样,如果您有更好的,不输出到log.txt的方法,可以在评论里指点一下

当然这样也有“缺点”,其实这个缺点在这里不成立,缺点就是把错误吞了,但不成立的原因是,after script的错误不错误不会影响到ci的过程

好处#

写完文章后不再需要手动hexo clean && hexo g && hexo d了

坏处#

也算不上什么坏处吧,非script部分出错了不会有提示,当然放在script里也没啥关系

还有一个就是毕竟是云端操作,时间会比性能强劲的本地电脑长

References#

Travis CI 自动部署 Hexo 博客到 Github

使用Travis Ci使hexo自动生成并部署
https://blog.xingoxu.com/2016/12/use-travis-ci-your-blog/
作者
xingo
发布于
2016-12-23
许可协议
CC BY-NC-SA 4.0