banner

使用 Travis CI 自动部署 Hexo

由于Hexo系统本身的特性,每次都需要手动更新部署网站,于是拟利用软件开发中的持续集成工具Travis CI来帮助完成这一繁杂过程。

Travis CI


CI是Continuous Integration的缩写,持续集成之意。

持续集成是一种软件开发实践,每次集成都通过自动化的构建(包括编译,发布,自动化测试)来验证,从而尽早地发现集成错误。

Continuous IntegrationContinuous Integration

Travis CI 是目前新兴的开源持续集成构建项目,用来构建托管在GitHub上的代码。它提供了多种编程语言的支持,包括Ruby,JavaScript,Java,Scala,PHP,Haskell和Erlang在内的多种语言。许多知名的开源项目使用它来在每次提交的时候进行构建测试,比如Ruby on Rails,Ruby和Node.js。

Travis CI是在软件开发领域中的一个在线的,分布式的持续集成服务,用来构建及测试在GitHub托管的代码。这个软件的代码同时也是开源的,可以在GitHub上下载到,尽管开发者当前并不推荐在闭源项目中单独使用它。

工作原理


当我们每次进行push等动作时,Travis CI 会自动检测我们的提交,然后根据配置文件,搭建虚拟主机来运行测试,构建等指令。在这里,就是运行hexo g d等命令来自动生成、部署静态网页。

Travis CITravis CI

Travis CI 官方文档:https://docs.travis-ci.com/

具体配置


Hexo 搭建

这里使用Hexo+Next+GitHub Pages组合示范过程,具体过程不再赘述。网站源码放到Hexo分支,博客的静态文件部署到master分支。

hexo源代码hexo源代码

设置 Travis CI

登陆 Travis CI,使用 GitHub 账户登录,它会自动关联 GitHub 上的仓库。点击右上角用户查看 GitHub 仓库,并选择要启动的项目,这里选择yourname/yourname.github.io

点击设置按钮,进入设置选项,开启相关服务,Build only if .travis.yml is present:指只在有.travis.yml时改变了才构建;Build pushes:push 完分支后开始构建。

设置设置

访问仓库是需要权限的,下面配置权限信息。

配置 Acess Token

登陆GitHub,进入设置界面,在Personal access tokens页面下点击右上角的Generate new token按钮会生成新的token,随后输入密码,取个名字,勾选一些权限

Personal access tokensPersonal access tokens

为了保护 token 的私密性,将其配置到 Travis CI 的Environment Variables

Environment VariablesEnvironment Variables

Travis CI 已获得仓库权限,现在可以给它相关操作指令了。

配置 .travis.yml

.travis.yml 内容如下:

language: node_js  #设置语言

node_js: stable  #设置相应的版本

install:
  - npm install  #安装hexo及插件

script:
  - hexo cl  #清除
  - hexo g  #生成

after_script:
  - cd ./public
  - git init
  - git config user.name "yourname"  #修改name
  - git config user.email "youremail"  #修改email
  - git add .
  - git commit -m "update"
  - git push --force --quiet "https://${GH_TOKEN}@${GH_REF}" master:master  #GH_TOKEN是在Travis中配置token的名称

branches:
  only:
    - hexo  #只监测hexo分支,hexo是我的分支的名称,可根据自己情况设置
env:
  global:
    - GH_REF: github.com/yourname/yourname.github.io.git  #设置GH_REF,注意更改yourname

当然,为了个人隐私方面的考虑,.travis.yml 文件中的用户名、邮箱之类的变量也可以像 GH_TOKEN 一样定义在 Environment Variables 中。

需要注意一个问题是,创建虚拟机后,Travis 会使用npm install命令读取 package.json 文件来安装 Hexo 及其依赖文件,因此需要保证 package.json 文件不可少且相关的依赖文件都在其中有记录。

package.jsonpackage.json

配置Hexo时会生成node_modules文件夹,这是 Hexo 及其依赖包的位置,它和 package.json 文件列表是对应的。因此 node_modules 文件夹不需要 push 远程仓库,CI平台的虚拟机会自己创建的。

另外注意这些文件的格式,尤其是.yml的格式,稍有偏差就有可能出问题。

Push 到 GitHub

在本地_posts目录下新建文章并 push 分支,登陆 Travis CI 即可看到已经检测到分支变化并开始构建,其中job log记录了构建的过程。

hexo deployerhexo deployer

自动部署完成,打开网页查看效果

postpost

参考资料

归档 分类 标签 关于