使用Jenkins自动部署博客

这篇文章比较简单，适合初学持续集成的读者，本文能够帮助你对基于Jenkins的持续集成有一个比较全局的概念。

提出问题

为了使用HTTPS，我将博客从GitHub Pages迁移到了个人服务器上。因为博客基于Hexo，在迁移以前，个人工做流程是：

本地写Markdown格式文章->Hexo生成HTML并推送到GitHub->GitHub Pages自动使用最新内容
复制代码

如今因为Hexo渲染之后的HTML文件须要放到服务器上，那么工做流程变为：

本地写Markdown格式文章->Hexo生成HTML并推送到GitHub->手动登陆服务器
->进入放博客文章的文件夹->执行命令git pull
复制代码

增长的两步虽说操做量不大，可是总显得很麻烦。因而我但愿，在我把博客的HTML文件push到GitHub之后，服务器能自动从GitHub上把HTML内容拉下来。因为使用了Nginx，因此只要博客的HTML发生了更新，那么使用浏览器访问kingname.info时，新内容自动就会出现。这样一来，对我来讲，看起来就像是我刚刚push了网页内容到GitHub，博客就自动更新了。

让服务器从GitHub上面拉代码，这个操做自己很简单。人来操做就一行代码git pull。写个Python脚本也就两行代码。但问题是，服务器怎么知道GitHub发生了更新？

有人说，Kingname，你不是作爬虫吗？你写个爬虫，每一秒检查一下GitHub不就能够了吗？这种办法固然能够。但问题是，我一周就更新一次博客，但这个爬虫为了等这一次更新，一周要访问GitHub高达604800次？更况且我有时候一个月都不更新。

因此显然不能让服务器主动检查GitHub更新，这种“轮询”操做效率过低。那么若是反过来，一旦GitHub有更新，它就通知服务器，而后服务器再去拉代码，这不就简单高效了吗？

解决问题

为了实现这个目的，就须要使用一些持续集成的工具。本文使用的是Jenkins。

Jenkins在敏捷开发界能够说是大名鼎鼎了。使用Jenkins搭建一整套持续集成环境，能够实现开发者往代码仓库一提交代码，代码自动进行单元测试，覆盖率测试，代码风格检查自动生成报告，自动通知部门同事开始Code Review。当代码被合并入主干之后，服务器自动拉下最新代码，自动编译，自动在几千几万台服务器上部署。在整个过程当中，开发者只须要作一件事，那就是git push（固然在实际状况下，后面还会加一些参数）。

本文实现的是博客的自动部署，没有任何测试，也没有Code Review，也没有编译，服务器也只有一台，复杂程度固然远远低于持续集成。不过管中窥豹，来看看这个简单地流程是如何走通的，对初学者也会有帮助。

本文假设你已经在服务器上面搭建好了Jenkins环境。若是你尚未安装Jenkins或者不会安装，那么能够“参考”这篇文章：搭建持续集成环境(一)。因为这篇文章是18个月之前写的，系统也是小众的Arch Linux，因此建议你仍是在网上搜一下最新的Jenkins安装教程比较好。

设置GitHub

在GitHub中进入博客所在的Repo，并点击Settings，以下图所示。

在设置页面，单击左侧的Integrations & services，并选择Add service，以下图所示。

从下拉菜单中，选中Jenkins (GitHub plugin)。在新打开的界面，填写Jenkins的信息，以下图所示。

其中Jenkins hook url填写的是个人服务器的Jenkins地址加上/GitHub-webhook/，因此完整的地址为http://xx.xx.xx.xx:8080/GitHub-webhook/。把这里的xx换成实际的IP地址或者域名便可。须要注意的是，网址末尾的斜杠必定不能省略。

填写好信息之后保存，GitHub就配置好了。

配置Jenkins

Jenkins须要安装GitHub Plugin才能接收到GitHub发来的通知。进入Jenkins的系统管理-管理插件，在可选插件选项卡中，搜索GitHub plugin并安装，安装完成Jenkins会重启。重启之后能够在已安装选项卡下面发现GitHub plugin，以下图所示。

回到Jenkins首页，单击左上角新建按钮，新建一个项目，项目类型为构建一个自由风格的软件项目。任务的配置信息以下图所示。

其中的项目名称和描述能够随意填写。勾选GitHub project，并把博客对应的GitHub Repo的地址填入。往下拉，看到源码管理，点选Git，依然填写博客对应的Repo地址。以下图所示。

继续往下拉，在构建触发器单击增长构建步骤，在弹出的下拉菜单中选择Execute shell。勾选GitHub hook trigger for GITScm polling。在Execute shell对应的输入框中输入命令，将当前目录下的全部文件和文件夹所有复制到/home/bexercise/kingname.github.io/文件夹下。以下图所示。

其中，文件夹/home/bexercise/kingname.GitHub.io/里面的内容以下图所示。这是Hexo生成的HTML文件和资源文件。

这里须要解释一下这一条命令：

cp -r ./* /home/bexercise/kingname.GitHub.io/
复制代码

其中的cp -r表示复制文件和文件夹。./表示当前目录。./*表示当前目录下面的全部内容。所以整条命令的意思是把当前目录下的全部内容所有复制到/home/bexercise/kingname.GitHub.io/下，而且若是文件名相同，就会直接覆盖。须要注意的是，kingname.GitHub.io这仅仅是一个普通的文件夹而已，别看它的名字长得像个网址，但其实它只是一个名字比较怪的普通文件夹而已，没有什么特殊的意义。

这个项目在构建的时候，它会自动从GitHub上面对应Repo全部的文件拉取到当前的文件夹下，因此执行了这一条复制命令之后，博客HTML文件天然就被复制到了网站的根目录下。

修改权限

因为Jenkins在安装的时候，会自动建立一个名为jenkins的普通帐号，这个帐号没有管理员权限。jenkins执行命令的时候，它也会使用这个帐号。可是因为kingname.GitHub.io这个文件夹是用户bexercise建立的，因此jenkins帐号默认是没有权限读写这个文件夹的。如今须要给jenkins帐号授予权限。使用bexercise这个帐号登陆服务器，使用如下命令给jenkins赋予权限，让它能够读写kingname.GitHub.io文件夹：

sudo chown -R jenkins:jenkins /home/bexercise/kingname.GitHub.io
复制代码

执行完成这一行命令之后，jenkins才能够把其余地方的文件复制到这个文件夹里面。

使用方法

没有什么复杂的使用方法，在Hexo中，执行命令hexo d就能够把本地生成好的HTML文件提交到GitHub中。而后打开浏览器，打开博客，发现新的文章已经出如今首页了。

在Jenkins项目的执行历史里面，也能够看到它被自动触发而产生的历史记录。以下图所示。

触类旁通

因为Jenkins能够运行Shell命令，进行单元测试本质上也是运行一条命令，那这不就能够实现自动进行单元测试了吗？那么若是把Shell命令改为运行一个Python脚本，那不就能够作任何事情了吗？若是Python脚本里面写了发送邮件的代码，那不就实现了你一提交代码，其余人就收到邮件了吗？