一. 分析需求

1. 需求说明

在项目开发过程中,我们有时会频繁的更新代码, 流程大概为:

(1) 本地 git push 提交代码至git托管平台

(2) 登陆到部署有网站源码的线上服务器

(3) cd到项目根目录, 执行 git pull 指令拉取最新代码

整个流程纯手动更新,每次耗时在1分钟左右, 这样一天下来,浪费了很多时间在这些琐碎的事情上.

现在的需求是,在每次本地提交代码后,线上服务器自动拉取最新代码,完成部署更新.即所谓的自动化部署.

2. 方案

现在一些主流代码托管平台如 github、 gitlab、git@osc 等均已提供webhook功能,在用户push了代码后，会自动回调一个您设定的http地址。用户可以自己根据不同的需求，来编写自己的脚本程序（比如发邮件，自动部署等）；目前，webhook支持多种触发方式，如Push、 Tag Push、 Issue、评论、合并请求 等

附webhook的简介:
Webhook就是用户通过自定义回调函数(callback)的方式来改变Web应用的一种行为，这些回调函数可以由不是该Web应用官方的第三方用户或者开发人员来维护，修改。通过Webhook，你可以自定义一些行为通知到指定的URL去。Webhook的“自定义回调函数”通常是由一些事件触发的，比如推送代码到代码库或者博客下新增一个评论，源站点会为Webhook进行HTTP请求的URI配置。用户通过配置，就可以使一个网站上的事件调用在另一个网站上表现出来，这些事件调用可以是任何事件，但通常应用的是系统集成和消息通知。

3. 分析如何实现

(1) 编写一个web接口，以便于接收由webhook发出的数据请求

(2) 在该web接口, 接收到的post消息中含有多个参数,包括分支信息,commit信息

(3) 根据分支信息和commit信息判断是否需要更新，如果无需更新，结束

(4) 需要更新，开始切换用户，获取更新权限，写入参数到文本文件中，避免因切换参数导致参数丢失

(5) 从文本文件中读取参数，传递分支参数，调用含有git pull等指令的自动部署脚本，开始执行部署操作

(6) 将包含这个接口的web服务放在你网站源码所在的服务器上,开启后台运行(使用nohup指令或supervisor守护进程)

(7) 将这个接口的url路由地址配置在代码托管平台的webhook功能中

(8) 测试更新代码,接收到webhook推送的消息数据, 执行自动化更新,完毕

二. 代码实现

特殊说明
(1) 本篇文章使用python脚本 + tornado框架搭建web服务器,用于接收git代码托管平台的webhook消息推送.
(2) git代码托管平台以Git@OSC为例,其他托管平台与之类似.
(3) 本篇文章中执行自动化部署指令的前提是已经配置了ssh
(4) 以下代码仅测试的是更新主分支,其他操作与之类似.

下图是这个脚本的整体目录