Jenkins2 学习系列8 -- 实战 使用 Generic Webhook Trigger 插件自动构建个人博客

需求：我的博客是用hexo搭建的，每次提交完代码都需要在托管的服务器上执行手动发布命令 deploy.sh

git pull
npm install
hexo g # 生成静态文件

现在我需要Jenkins的Generic Webhook Trigger插件来帮我自动完成这些工作。

Generic Webhook Trigger 是 Jenkins 提供的一款插件，装好这个插件后会暴露出一个URL地址，格式如 JENKINS_URL/generic-webhook-trigger/invoke。

我们往这个地址发请求，请求体或请求头带上要构建的job名称，分支名称等信息，这个插件可以正则提取出这些信息，当作变量进而触发构建。

大致流程如下图：

image.png

1. 在Jenkins插件管理页面搜索该插件

image.png

1. 安装之后新建一个item，类型选freestyle，pipeline都行，在 Build Trigger 选项卡中会看到多出了一项 "Generic Webhook Trigger"，勾选之后多出了很多信息。这里只填写Token

image.png

1. 这里我创建的是个Pipeline的job，pipeline script 就是调用deploy.sh。注意这里我的博客和Jenkins都部署在了同一台服务器上面。

pipeline {
    agent any
    // 避免 npm install 报权限问题
    environment {
        PATH="/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin"
    }
    stages {
        stage('Check Version') {
            steps {
                sh 'node -v'
                sh 'npm -v'
                sh '/home/ubuntu/jenkins-scripts/job-gitee-hexo-blog.sh'
            }
        }
    }
}

1. 来到Gitee/Github，添加一个webhook地址，如果你的Jenkins地址是http://110.110.110.110:8080，job名称为gitee-hexo-blog-pipeline，那么根据规则，Generic Webhook Trigger的地址是http://110.110.110.110:8080/generic-webhook-trigger/invoke?token=gitee-hexo-blog-pipeline 配置完成，点测试，看返回内容是否是成功的。

image.png

1. 测试，我们修改代码内容，并且push，发现Jenkins果然自动触发了build。

image.png

这里只用到了Generic Webhook Trigger最基本的内容，将来会有更深入的介绍。