Gitlab自动触发Jenkins流水线配置指南

要实现 Git 代码提交后自动触发 Jenkins 流水线，最主流且高效的方式是配置 Git Webhook（网络钩子）。
它的核心原理是：当代码推送到 Git 仓库时，Git 平台会主动向 Jenkins 发送一个 HTTP 请求，通知 Jenkins 立即开始构建。

依赖

依赖插件 Gitlab

配置教程

1. jenkins流水线构建触发器

1. 进入你的 Jenkins 流水线任务，点击左侧的“配置 (Configure)”。 找到 “构建触发器 (Build Triggers)” 区域：
2. 如果是 GitLab：勾选 Build when a change is pushed to GitLab。页面会生成一个 GitLab webhook URL（类似 http://你的
   Jenkins地址/project/你的任务名），并可以生成一个 Secret token（jenkins -> admin -> Configure(设置) -> API Token
   生成然后应用保存）。
3. 如果是 GitLab：勾选 GitHub hook trigger for GITScm polling。
4. 如果是通用/其他平台（或使用了 Generic Webhook Trigger 插件）：勾选 Generic Webhook Trigger，并自定义一个 Token（例如
   webhook-token）。
5. 保存 Jenkins 的配置。

2. Git 仓库端的 Webhook 配置

1. 登录 Git 代码托管平台，进入对应的项目仓库，找到 “设置 (Settings)” -> “Webhooks (网络钩子)”，点击“添加 Webhook (Add
   Webhook)”。
2. URL：填写 Jenkins 提示的 GitLab webhook URL（例如 http://<Jenkins地址>:8080/project/你的任务名）。
3. Secret Token：填写在 Jenkins 中生成或自定义的令牌（用于安全验证，防止恶意触发）。
4. 触发事件 (Trigger)：勾选 Push events（推送事件），也可以按需勾选 Merge request events。

3. 测试与验证

1. 网络连通性（关键）：确保你的 Git 平台服务器能够访问到 Jenkins 的地址。如果 Jenkins 部署在公司内网或本地，Git 平台（如
   GitHub/GitLab 云端）是无法触达的。此时你需要使用内网穿透工具（如 ngrok）或配置Nginx 反向代理，将 Jenkins 暴露到公网。
2. 触发测试：在 Git 平台的 Webhook 配置页面，通常都有一个 “测试 (Test)” 按钮。点击 Push events 进行测试，如果返回 200
   状态码，说明配置成功。
3. 实际验证：在本地修改一行代码，执行 git push 推送到远程仓库。回到 Jenkins 界面，你应该能看到一个新的构建任务被自动触发并开始运行。

4. 避坑指南与常见问题排查

1. 403 权限错误：如果 Webhook 测试返回 403，通常是 Jenkins 的安全策略（CSRF 跨站请求伪造保护）拦截了请求。可以在 Jenkins 的
   系统管理 -> 安全 -> CSRF 保护 中，勾选“Allow requests from known referers”或暂时关闭 CSRF 保护进行测试。
2. 重复构建：如果发现一次代码推送触发了多次构建，请检查 Webhook 是否勾选了多余的事件，或者在 Jenkins
   的源码管理（SCM）中配置好分支过滤（Branch Specifier），只监听特定分支（如 */main）的变动。
3. SSL 证书报错：如果你的 Jenkins 使用的是自签名的 HTTPS 证书，Git 平台可能会拒绝发送请求。可以在配置 Webhook 时取消勾选“启用
   SSL 验证 (Enable SSL verification)”，或者为 Jenkins 配置正规的 HTTPS 证书。

Jenkinsfile 示例

pipeline {
    agent {
        // 需要安装插件：docker-workflow
        docker {
            image 'python310:v1'
        }
    }

    environment {
        version = '1.0.0' // 设置环境变量
    }

    stages {
         stage('Prefix') {
            failFast true
            steps {
               script {
                   echo "================ 开始打印 ================"
                   sh '''
                       # 只打印用户定义的或自定义的变量，过滤掉系统路径等杂项
                       printenv | sort
                   '''
                   echo "================ 打印结束 ================"
               }
            }
        }
        stage('静态扫描') {
            failFast true
            steps {
                sh 'sleep 3'
                echo '✅ 静态扫描 执行完毕！'
            }
        }
    }
    post {
        always {
            echo 'Cleaning up...'
        }
        success {
            echo 'Pipeline completed successfully!'
        }
        failure {
            echo 'Pipeline failed!'
        }
    }
}

---