随时随地让Hexo持续部署

用Hexo搭建好博客,使用起来算是方便,但是每次还要在安装了Hexo环境的机器上才能$hexo new <post>$hexo d -g,让随时随地提交文章变的成本更高,毕竟由于网络等原因让安装个和使用hexo变的不那么方便,其实就一句话:你懂的。能不能在任何地方只要新增或修改了post就自动生成并部署hexo呢?

答案是肯定的,而且你-也-行!手动档加装定速巡航,准备好了吗?

自动化

最终实现后的效果是这样的:

流程图

以后可以在CODING.NET上直接提交post或自己git commit,其他过程均自动完成。较之前hexo d变为git commit [新增文章]

整体思路

  • 用CODING.NET对Hexo项目的源码进行管理(master分支,要配置好Hexo部署信息)
  • 在CODING.NET开启Coding Pages功能(coding-pages分支,静态博客站点托管的地方)
  • 在Daocloud上进行Hexo环境的构建
  • Daocloud通过持续集成功能实现ssh自动部署到coding-pages分支(webhook由Daocloud自动创建)

用到的东西

  • Hexo 一个号称生成速度很快的静态博客,台湾版jekyll。
  • NexT a theme for Hexo.
  • CODING.NET 中国版Github,主要因为可以免费建私有项目。
  • Daocloud 中国版Docker hub,而且还能持续集成。

实现过程

Hexo配置

使用和配置自己上官网查询,提供中文文档,这里必须配置的是:

# _config.yml
...
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: git@git.coding.net:juglans/juglans.git
  branch: coding-pages
...

注意:这里采用的是sshgit commit方式,对后面daocloud.yml内容影响很大。

Hexo项目源码管理及Coding Pages功能

在Github连接总是无故被断开后,找到了CODING.NET,速度很不错,但是不喜欢重量级的SPA页面,Coding Pages提供了免费建站的空间,还能绑定域名。

安利完了,说说怎么用的:

  1. 新建一个和你用户名一样的私有项目(必须是私有,下面介绍)
  2. 将Hexo主项目放在master分支管理,以后所有部署都通过对master分支的提交来触发
  3. 开启Coding Pages功能,因为上面_config.yml文件中配置的git地址的分支正是coding-pages,同是还可以绑定自己的域名,我这里绑定了http://ddr888.xyz/
    这里要提一下,Coding Pages功能有时会出现缓存时间过长的问题,部署完成3个小时了还没看见页面更新。

通过master构建Hexo基础运行环境镜像

国内貌似也没找到什么合适的CI(持续集成)平台,所以就用了Daocloud,同样用了讨厌的SPA页面,但是他有通过Github/CODING.NET自动构建Docker私有镜像(公有的收费,但是这里必须用私有)并同时进行持续集成的能力。

开始构建:

  1. 在Hexo主项目根目录下新建Dockerfile文件
 # Dockerfile
 FROM node:slim
 MAINTAINER Juglans <juglans@qq.com>

 # 安装git、ssh等基本工具
 RUN apt-get update && apt-get install -y git ssh-client ca-certificates --no-install-recommends && rm -r /var/lib/apt/lists/*

 # 设置时区,不知道为什么?
 RUN echo "Asia/Shanghai" > /etc/timezone && dpkg-reconfigure -f noninteractive tzdata

 # 只安装Hexo命令行工具,其他依赖项根据项目package.json在持续集成过程中安装
 RUN npm install hexo-cli -g

 EXPOSE 4000
  1. 在Daocloud代码构建功能下新增“通过CODING.NET下的juglnas库进行构建”的项目,并在流程定义下,设置通过代码的Daocloud.yml文件进行Hexo基础运行环境镜像的构建/持续集成,这样配置可以实现从代码库的DockerfileDaocloud.yml文件进行镜像的构建和持续集成
    流程定义

这一步会在CODING.NET下的juglnas库中新增一个webhook到Daocloud。配置完成后,手工构建一下镜像,并在镜像详细页面把最新的镜像设置为latest,方便在Daocloud.yml中调用。

配置持续部署脚本

本小节本来可以和上一节合在一起,但,为了突出持续部署的重要性和执行过程独立性,特此单列。

具体用法:

  1. 在Hexo主项目中新建.daocloud目录,然后生成密钥对,把私钥文件id_rsa放进目录,把公钥内容添加到CODING.NET你个人设置中的SSH公钥中(切记不是放在项目的部署公钥
  2. 在Hexo主项目根目录下新建Daocloud.yml文件(这才是核心)
 # Daocloud.yml
 image: daocloud.io/juglans/blog:latest  #使用已经在上一步创建好的Hexo基础环境镜像(并不包括博客项目源码)
 install:
    # 安装npm依赖
    - npm install
 before_script:  
    # 新建存放私钥目录
    - mkdir ~/.ssh

    # 将私钥放入目录
    - mv .daocloud/id_rsa ~/.ssh/id_rsa

    # 将ssh配置文件放入目录
    - mv .daocloud/ssh_config ~/.ssh/config

    # 修改私钥和配置文件为可读权限
    - chmod 600 ~/.ssh/id_rsa
    - chmod 600 ~/.ssh/config

    # 启动ssh-agent
    - eval $(ssh-agent)

    # 添加私钥
    - ssh-add ~/.ssh/id_rsa

    # 删除存放私钥和配置的目录及文件,不知道为什么要删掉,如果为了安全性,集成完成后不就自动销毁了吗?
    - rm -rf .daocloud

    # 配置git全局的用户名和邮件,没有配置不能clone
    - git config --global user.name "juglans"
    - git config --global user.email "juglans@qq.com"

 script:
    # 清除之前生成的文件
    - hexo clean

    # 生成要发布的静态博客文件
    - hexo g

    # 根据Hexo配置的发布方式和地址进行发布
    # 项目_config.yml发布为git方式,且使用了ssh连接,因此才有上面的安装私钥的过程
    - hexo d

    # 删除私钥文件夹
    - rm -rf ~/.ssh/

说明:在install过程中进行了npm install,并没有在镜像构建时进行依赖项安装,这是因为依赖项安装过程根据每个Hexo配置和安装的功能不同而不同,并没有通用性,而且本身它就属于build过程,尽管花费时间稍长(平均耗时90秒),但是这样更科学。

  1. 在Daocloud代码构建->触发规则中设置在提交代码到master分支后自动触发持续集成/部署
    触发规则

注意:别忘了在设置中把持续集成开关打开,见上一节中的镜像构建配置图,这样每次git commit到master分支,静态站点才会自动生成并部署到coding-pages分支。

小节

从与普通Hexo项目的区别和安全性做个小节。

区别:

  • 新增了Dockerfile配置文件
  • 新增了daocloud.yml配置文件
  • 新增了.daocloud目录及其中的id_rsa私钥文件

安全性方面,尽管涉及的代码库和Docker镜像库都是私有的,安全性仍然存在问题:

  • 私钥保存在了Hexo主项目源码中
  • 持续集成/部署过程中将私钥放入了运行中的容器(尽管进行了销毁)

ps:有个插曲,本来想用国内的flow.ci做持续集成/部署,但是目前还在测试阶段,只有邀请码才能注册,等注册到账号再考虑进行非Docker环境的持续部署,国外的Travis CI由于网络和对CODING.NET不支持等原因就不考虑了。

参考

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,425评论 4 361
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,058评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,186评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,848评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,249评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,554评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,830评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,536评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,239评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,505评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,004评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,346评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,999评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,060评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,821评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,574评论 2 271
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,480评论 2 267

推荐阅读更多精彩内容