thebeefcake/concourse-bitbucket-resource

Concourse BitBucket资源镜像

镜像概述

这是一个Concourse资源镜像，用于与Atlassian BitBucket的构建状态API交互，支持拉取请求的状态跟踪与更新，帮助CI/CD流程同步构建结果到BitBucket平台。

核心功能

• 检查未测试状态的拉取请求
• 获取跟踪分支副本用于代码检出与测试
• 更新提交的构建状态（成功/失败）

使用场景

典型场景为监控BitBucket仓库的拉取请求，自动运行测试并将构建结果状态更新到BitBucket，提升CI/CD流程的自动化效率。

配置说明

资源类型的source字段需包含以下配置项（加粗为必填）：

• repo：需跟踪的仓库名称
• key：消费者的OAuth密钥
• secret：消费者的OAuth密钥secret
• team：仓库所属的团队名称
• url：BitBucket云API路径（例如：https://api.bitbucket.org，当前仅支持此值）
• version：BitBucket API版本（例如：2.0，当前仅支持此值）
• concourse_url：Concourse的URL，用于在BitBucket中设置构建链接（例如：http://ci.example.com）

行为说明

check

检查是否存在头部提交处于未测试状态的拉取请求。

in

获取跟踪分支的副本，用于代码检出与测试。

out

更新提交的状态，需提供以下参数：

• commit：包含提交SHA的文件路径
• state：状态值，必须为success或failed

示例配置

以下是典型的流水线配置示例：

yaml
resource_types:
  - name: pull-request
    type: docker-image
    source:
      repository: thebeefcake/concourse-resource-bitbucket

resources:
  - name: repo-pullrequest
    type: pull-request
    source:
      repo: {{repo-name}}
      secret: {{bitbucket-secret}}
      key: {{bitbucket-key}}
      team: {{team-name}}
      url: https://api.bitbucket.org
      version: "2.0"
      concourse_url: http://ci.example.com

jobs:
  - name: run-tests
    plan:
    - get: repo-pullrequest
      trigger: true
    - task: test
      config:
        platform: linux
        image_resource:
          type: docker-image
          source: {repository: alpine}
        inputs:
          - name: repo-pullrequest
        outputs:
          - name: pr
        run:
          path: sh
          args:
          - -exc
          - |
            apk add --update --no-cache git
            version=$(cat repo-pullrequest/version)
            commit=$(cat repo-pullrequest/commit)
            branch=$(cat repo-pullrequest/branch)
            cd repo-pullrequest && git checkout $branch
            # 运行测试（替换为实际测试命令）
            echo $version | tee pr/version
            echo $commit | tee pr/commit
      on_failure:
        put: repo-pullrequest
        params:
          state: failed
          commit: pr/commit
      on_success:
        put: repo-pullrequest
        params:
          state: success
          commit: pr/commit

安装方法

全局部署

在所有Concourse worker上安装，更新部署清单：

yaml
properties:
  groundcrew:
    additional_resource_types:
      - image: "docker:///thebeefcake/concourse-resource-bitbucket#master"
        type: "pull-request"

流水线专用

单个流水线中使用，添加资源类型配置：

yaml
resource_types:
  - name: "pull-request"
    type: "docker-image"
    source:
      repository: "thebeefcake/concourse-resource-bitbucket"
      tag: "master"

参考链接

• Concourse资源文档
• BitBucket构建状态API

许可证

Apache License v2.0