如何配置Jenkins Pipeline检测Git Release标签并控制部署流程？

我来帮你搞定两个核心困扰：GIT_COMMIT环境变量为空，以及检测Release标签并终止非标签构建。结合你的现有配置，我会给出具体的修改方案和细节解释。

一、修复GIT_COMMIT为空的问题 #

你当前用git指令拉取代码，这种方式不会自动填充Jenkins内置的Git相关环境变量（比如GIT_COMMIT）。换成checkout scm就能完美解决——这是Jenkins Pipeline推荐的代码拉取方式，会自动帮你设置GIT_COMMIT、GIT_BRANCH等一系列实用变量。

另外，你的Pipeline是agent none模式，每个Stage用独立的Agent，所以最好在Preparation阶段就完成标签检测（不符合条件直接终止，不用浪费资源启动Docker），同时确保Git变量能正常传递到后续Stage。

二、检测Release标签并终止构建 #

有两种可靠的检测方式，我优先推荐第一种（更高效）：

1. 利用GitLab WebHook传递的变量：当GitLab推送标签触发Jenkins构建时，Jenkins会自动生成GITLAB_TAG环境变量（前提是你正确配置了GitLab插件和WebHook）。普通分支推送时这个变量是空的。
2. 通过Git命令查询当前提交标签：如果WebHook变量不可用，可以用git tag --points-at HEAD获取当前提交关联的所有标签，再判断是否符合你的Release格式（比如以v开头，或包含release关键字）。

修改后的完整Pipeline配置 #

pipeline {
    agent none
    environment {
        // 自定义Release标签的匹配规则，比如v1.0.0或release-2.1.0格式
        RELEASE_TAG_PATTERN = '^v\\d+\\.\\d+\\.\\d+$|^release-\\d+\\.\\d+\\.\\d+$'
    }
    stages {
        // Stage 1: 拉取代码 + 检测Release标签
        stage('Preparation & Tag Check') {
            agent any
            steps {
                // 替换为checkout scm，自动填充Git相关环境变量
                checkout scm
                echo "当前Commit哈希: ${env.GIT_COMMIT}"
                
                // 方式1：用GitLab WebHook的GITLAB_TAG变量检测（推荐）
                script {
                    if (!env.GITLAB_TAG) {
                        error("本次构建无Release标签，终止执行！")
                    }
                    // 可选：验证标签格式是否符合规范
                    if (!(env.GITLAB_TAG =~ RELEASE_TAG_PATTERN)) {
                        error("标签 ${env.GITLAB_TAG} 不符合Release格式要求，终止构建！")
                    }
                    echo "检测到合法Release标签: ${env.GITLAB_TAG}"
                }

                // 方式2（备选）：通过Git命令查询当前提交的标签
                // script {
                //     def currentTags = sh(returnStdout: true, script: 'git tag --points-at HEAD').trim()
                //     if (!currentTags) {
                //         error("当前提交无关联标签，终止构建！")
                //     }
                //     // 筛选符合Release格式的标签
                //     def releaseTags = currentTags.split('\\n').findAll { it =~ RELEASE_TAG_PATTERN }
                //     if (releaseTags.isEmpty()) {
                //         error("当前提交的标签不符合Release格式，终止构建！")
                //     }
                //     echo "检测到合法Release标签: ${releaseTags.join(', ')}"
                // }
            }
        }

        // Stage 2: 启动Docker并运行测试
        stage("Start docker and run the tests") {
            agent {
                docker {
                    image 'teracy/angular-cli'
                    args '-u root --network=gitlab_inet'
                }
            }
            steps {
                echo "关联的Release标签: ${env.GITLAB_TAG}"
                echo "当前Commit哈希: ${env.GIT_COMMIT}"
                
                sh 'wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb &>/dev/null'
                sh 'dpkg -i google-chrome-stable_current_amd64.deb; apt-get -fy install'
                sh 'rm -f google-chrome-stable_current_amd64*'
                sh 'export CHROME_BIN=/usr/bin/google-chrome'
                sh 'ng -v'
                sh 'npm install && npm run test'
            }
        }

        // Stage 3: 部署到测试环境（仅通过标签检测后执行）
        stage('Deploy to Test Environment') {
            agent any
            steps {
                echo "开始部署Release ${env.GITLAB_TAG} 到测试环境..."
                // 在这里添加你的部署命令，比如拷贝文件、调用部署脚本等
                // sh 'your-deploy-script.sh'
            }
        }
    }
}

关键修改点说明 #

1. 替换git为checkout scm：自动填充GIT_COMMIT等环境变量，解决变量为空的问题。
2. 提前检测标签：在Preparation阶段完成标签校验，不符合条件直接用error()终止构建，避免启动Docker做无用功。
3. 统一标签规则：通过RELEASE_TAG_PATTERN管理Release标签格式，后续修改更方便。
4. 新增部署Stage：只有通过标签检测的构建才会进入部署环节，实现"有Release标签才部署"的需求。

额外注意事项 #

• 确保GitLab WebHook配置正确：在GitLab项目的WebHook设置中，勾选"Tag push events"选项，这样推送标签时才会触发Jenkins构建，并传递GITLAB_TAG变量。
• 如果用方式2（Git命令查询），要保证Jenkins Agent的Git环境正常，能执行git tag命令。

内容的提问来源于stack exchange，提问作者thedethfox