AWS环境下无公网IP的Jenkins如何通过Bitbucket PR触发构建并反馈结果

核心思路 #

由于Jenkins部署在AWS无公网IP，Bitbucket无法主动推送事件触发构建，因此采用Jenkins主动轮询Bitbucket PR状态结合Bitbucket REST API的方案，实现PR触发构建和结果反馈。

具体步骤 #

1. 配置Bitbucket访问凭证 #

• 在Bitbucket创建个人访问令牌（PAT），需授予pullrequest:read、pullrequest:write（用于更新PR状态）、repository:read权限。
• 在Jenkins的「凭证管理」中添加该PAT，类型选「Secret text」，设置ID为bitbucket-pat（后续脚本会引用）。

2. 创建Jenkins轮询触发的流水线 #

新建流水线项目，配置如下：

• 构建触发器：勾选「轮询SCM」，设置轮询周期（例如H/5 * * * *，每5分钟检查一次PR状态）。
• 流水线脚本：用Declarative Pipeline实现PR检测、触发构建逻辑，示例如下：

pipeline {
    agent any
    environment {
        BITBUCKET_REPO_API = 'https://api.bitbucket.org/2.0/repositories/[你的工作区]/[仓库名]/pullrequests'
        BITBUCKET_PAT = credentials('bitbucket-pat')
    }
    triggers {
        pollSCM('H/5 * * * *')
    }
    stages {
        stage('检测未处理PR') {
            steps {
                script {
                    // 获取所有OPEN状态的PR及对应提交哈希
                    def prData = sh(
                        script: "curl -s -u ${BITBUCKET_PAT}: ${BITBUCKET_REPO_API}?state=OPEN | jq -r '.values[] | .id, .source.commit.hash'",
                        returnStdout: true
                    ).split('\n')
                    
                    // 遍历PR，检查是否已触发过构建
                    for (int i = 0; i < prData.size(); i += 2) {
                        def prId = prData[i]
                        def commitHash = prData[i+1]
                        
                        // 查询该提交是否已有Jenkins构建状态
                        def existingStatus = sh(
                            script: "curl -s -u ${BITBUCKET_PAT}: ${BITBUCKET_REPO_API}/${prId}/commit/${commitHash}/statuses | jq '.values[] | select(.key == \"jenkins-pr-build\")'",
                            returnStdout: true
                        )
                        
                        // 未触发过则启动PR构建任务
                        if (existingStatus.isEmpty()) {
                            build job: 'PR专属构建任务', 
                                  parameters: [
                                      string(name: 'PR_ID', value: prId),
                                      string(name: 'COMMIT_HASH', value: commitHash)
                                  ]
                        }
                    }
                }
            }
        }
    }
}

3. 在PR构建任务中反馈结果到Bitbucket #

在你的PR构建流水线末尾，添加更新Bitbucket PR状态的步骤：

stage('更新PR构建状态') {
    steps {
        script {
            def buildStatus = currentBuild.currentResult == 'SUCCESS' ? 'SUCCESSFUL' : 'FAILED'
            sh """
                curl -X POST -u ${BITBUCKET_PAT}: ${BITBUCKET_REPO_API}/${env.PR_ID}/commit/${env.COMMIT_HASH}/statuses/build \
                -H "Content-Type: application/json" \
                -d '{
                    "state": "${buildStatus}",
                    "key": "jenkins-pr-build",
                    "name": "Jenkins PR构建",
                    "description": "构建结果：${buildStatus}",
                    "url": "${BUILD_URL}"
                }'
            """
        }
    }
}

4. 优化建议（可选） #

• 避免重复触发：可在Jenkins中维护已处理PR的记录（比如用文件或全局变量），或在Bitbucket PR评论中标记已触发构建。
• 调整轮询频率：如果需要更高实时性，可将周期改为H/2 * * * *（每2分钟一次），注意不要超过Bitbucket API的请求限额。

替代方案：AWS API Gateway中转实现实时触发 #

如果轮询无法满足实时性需求，可通过AWS API Gateway搭建公网中转：

• 在AWS API Gateway创建REST API，配置VPC链接指向Jenkins所在的VPC subnet。
• 在Bitbucket仓库配置Webhook，触发事件选择「Pull request created/updated」，URL设为API Gateway的公网端点。
• Jenkins安装「Generic Webhook Trigger」插件，解析Bitbucket的Webhook payload，触发对应的PR构建任务。
• 构建完成后，同样通过Bitbucket API反馈结果。

此方案实现实时触发，但需要配置AWS API Gateway和VPC链接，适合对响应速度要求高的场景。

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