今天研究并实现一个响应 GitHub Webhooks 实现自动部署的 Web 服务。简单收拾了下代码和文档，开源至此

前提条件

这并不是一个 Hello Word 教学示例，而是我自己在用的实际项目。假设你已经知道下列技术或满足其条件：

• 有一台自己的服务器
• 会配置域名
• 会配置 nginx 或者其他 Web 服务器，实现 Web 服务至 node 服务的转发
• 了解 node、koa
• 了解 Webhooks
• 了解 SMTP
• 会编辑 shell 脚本

主要功能

• node lib/index.js 运行后，在 3030 端口提供可响应 GitHub Webhook 的服务
• 内部通过 exec 来调用实际工作的 shell 脚本（需要自己编写）
• 发邮件告知运行结果

主要配置

均位于 config 目录，参照 *_demo.json，添加没有 _demo 的版本

config.json

可为每个仓库、分支创建对应的配置：

1
2
3
4
5
6
7
8
9
10

{
  "webhook-test_master": { // RepositoryName_BranchName
    "secret": "GitHub_Webhook_secret",
    "cwd": "/home/jason/testapi/", // 脚本执行目录
    "command": "/bin/bash ./deploy.sh", // 真正工作的 shell 脚本
    "env": { // 一些环境变量
      "DEBUG": "s:*"
    }
  }
}

security.json

目前主要存储了 SMTP 配置信息，用于发告知邮件：

1
2
3
4
5
6
7
8
9
10

{
  "mailConfig": {
    "host": "email-smtp.us-west-2.amazonaws.com",
    "port": "465",
    "user": "user123",
    "password": "password123",
    "from": "from@gmail.com",
    "to": "to@gmail.com"
  }  
}

琐碎的

关于 GitHub Webhook，记得生成密码、选择 json 格式。

关于 shell 脚本，可以通过 2>&1 将其中不重要的 warn/error，从 stderr 转到 stdout 中。

关于邮件服务，我开始时用的是阿里云，但出现了提示发送成功、但实际不破功的情况，垃圾箱也没有。后来试了 Amazon SES，目前一切顺利；每天 200 封免费邮件额度。

使用 VSCode 编写调试，.vscode 配置本身也包含在项目中了。

如果你遇到了问题，多问问 Google 和自己；我这边是顺畅运行的。

本来要做微信登录，一直被微信审核给卡着，烦；就折腾了 Docker.

目前来看，我对 Docker 的使用还在 Container 级别。比如，需要使用 mongodb；本来是全局安装，测试和生产环境使用相同的 mongo、不同的 db. 有了 Docker 之后，可以运行不同的 mongodb Container，分隔的更彻底些，理论上扩展性也更好些。再加上结果 Docker Volume，可以更好地备份恢复数据。

顺带着还有个好处：临时学习某技术时，不用全局安装其运行环境，而是安装一个 Docker 镜像，在这个沙盒里随意折腾，而不用担心污染电脑主环境。试用后发现不需要，直接删除 images 即可；需要时，才考虑在电脑主环境安装。

进阶的，还没有用于 Images/Stack/Swarm 级别；不过还是跟着官方介绍跑了一遍，大致知道是怎么回事。等将来用的时候，再细细口味。

比如，明天准备搭个 webhook 的响应服务，就可以用上 Docker 来开发和部署。虽然我还是觉得有点不适应，平白多了一些步骤，不过还是硬着头皮上吧，逼自己适应 Docker 的套路。

一、野蛮学习阶段

学新东西时，先不要太过在意能否应用到生产中、怎么用。先把自己完全沉浸到新东西中，用新东西的视角和思维模式来理解一切。
打个比方，自己之前擅长用螺丝刀解决一切问题。现在开始学锤子，先不着急和螺丝刀比较，而是认真学习锤子的使用方式，把全世界看成钉子。

二、为我所用阶段

等到了一定程度，再跳出来，和已有的东西交融。

比如，和螺丝刀相比，锤子在哪些方面更好使；又有哪些局限，还是有螺丝刀更顺手；
比如，我目前正在使用的技术和方式，有哪些不足；和新东西相比，互相有哪些优缺点。

既不盲目崇拜新东西、把已有的拍死，也不要过早因为新东西的局限而下结论。

更关键的，是已经会的、和新学的东西之间，如何交融，如何发挥双方的特长，如何更新自己的技术树。该用锤子用锤子，该用螺丝刀则继续使用螺丝刀。

吸星大法，你怕不怕？

这周本来有几项关键词改进的功能，这些功能都或多或少依赖微信登录。可，在微信开放平台创建应用需要审核。审核也就罢了，等了 2 天，竟然审核没通过，说是提供的材料缺少盖章。

哎，能不能专业点，我用的是个体户资质，本来就没公章，去淘宝买个萝卜章给你盖上啊？被拒后，连个申诉的入口都没有，发邮件也没任何反应，真是相当糟糕的体验。

既影响进度、又影响心情，干脆不搞了，去学 Docker，换个心情。

最好的，是做自己的需求，可以 100% 知道要做什么、做成什么样子。

其实，是做朋友的需求，可以随时拉过来问，要做什么、做成什么样子。注意，即使如此，也要保持主动性、有自己的理解判断，不能被带着走。终究，还是要当成自己的需求去做。

关键词排名监控，便是后者。