如何在Jenkins Pipeline中通过Curl获取GitLab CI流水线状态

核心问题修正 #

• 之前用returnStatus: true会返回curl命令的执行状态码（0成功/非0失败），而非GitLab API的响应内容，必须改用returnStdout: true来获取API返回的JSON数据。
• trim()报错是因为误将整数类型的状态码当作字符串处理，确保拿到的是API响应文本后再做字符串操作即可。

完整Pipeline代码示例 #

pipeline {
    agent any
    environment {
        // 替换为你的实际配置
        GITLAB_PROJECT_ID = "123"
        GITLAB_PRIVATE_TOKEN = credentials('gitlab-api-token')
        GITLAB_API_URL = "https://your-gitlab-instance.com/api/v4"
    }
    stages {
        stage('Trigger GitLab CI') {
            steps {
                // 已实现的触发GitLab流水线逻辑
                sh '''
                    curl -X POST "${GITLAB_API_URL}/projects/${GITLAB_PROJECT_ID}/trigger/pipeline" \
                    -H "PRIVATE-TOKEN: ${GITLAB_PRIVATE_TOKEN}" \
                    -F "ref=main" \
                    -F "variables[ENV]=prod"
                '''
            }
        }
        stage('Check GitLab Pipeline Status') {
            steps {
                script {
                    def pipelineStatus = null
                    def maxRetries = 10
                    def retryInterval = 30
                    
                    for (int i = 0; i < maxRetries; i++) {
                        // 获取最新流水线的API响应文本
                        def apiResponse = sh(
                            script: '''
                                curl -s -H "PRIVATE-TOKEN: ${GITLAB_PRIVATE_TOKEN}" \
                                "${GITLAB_API_URL}/projects/${GITLAB_PROJECT_ID}/pipelines?per_page=1"
                            ''',
                            returnStdout: true
                        ).trim()
                        
                        // 用jq解析流水线状态
                        pipelineStatus = sh(
                            script: "echo '${apiResponse}' | jq -r '.[0].status'",
                            returnStdout: true
                        ).trim()
                        
                        echo "当前GitLab流水线状态：${pipelineStatus}"
                        
                        // 状态为success则进入后续阶段
                        if (pipelineStatus == "success") {
                            break
                        }
                        // 状态为失败/取消则终止流水线
                        if (pipelineStatus in ["failed", "canceled"]) {
                            error "GitLab流水线执行失败，状态：${pipelineStatus}"
                        }
                        // 未完成则等待重试
                        if (i < maxRetries - 1) {
                            echo "流水线未完成，${retryInterval}秒后重试..."
                            sleep(retryInterval)
                        }
                    }
                    
                    // 超时未成功则终止
                    if (pipelineStatus != "success") {
                        error "GitLab流水线超时未成功，最终状态：${pipelineStatus}"
                    }
                }
            }
        }
        stage('Next Stage') {
            when {
                expression { currentBuild.result == null || currentBuild.result == 'SUCCESS' }
            }
            steps {
                echo "进入后续阶段，GitLab流水线执行成功"
                // 后续业务逻辑
            }
        }
    }
}

关键细节说明 #

1. API调用逻辑：/projects/:id/pipelines?per_page=1会返回项目最新的1条流水线数据，通过jq '.[0].status'提取状态字段。
2. 循环重试机制：触发流水线后不会立即完成，加入循环查询避免因流水线未启动导致的误判。
3. 异常处理：明确处理失败、取消状态，超时未成功也终止流水线，避免无限等待。
4. 安全规范：用Jenkins凭据存储GitLab私有令牌，避免明文暴露敏感信息。

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