ecometrica/concourse-resource-bitbucket

concourse-resource-bitbucket镜像说明

镜像概述

本镜像为Concourse CI/CD平台的Bitbucket资源，用于向bitbucket.org更新代码提交的构建状态。它是https://github.com/Karunamon/concourse-resource-bitbucket%E7%9A%84%E5%88%86%E6%94%AF%E7%89%88%E6%9C%AC%EF%BC%8C%E4%B8%BB%E8%A6%81%E4%BF%AE%E6%94%B9%E5%8C%85%E6%8B%AC%EF%BC%9A%E7%9B%AE%E6%A0%87Bitbucket API v2、采用OAuth 2.0客户端凭证认证、支持Git和Hg仓库、自动化Docker构建等。

核心功能

1. 向bitbucket.org提交构建状态（SUCCESSFUL/FAILED/INPROGRESS）
2. 支持Git和Mercurial（Hg）两种版本控制仓库
3. 基于OAuth 2.0客户端凭证的安全认证机制
4. 可选调试模式，输出JSON交互信息用于故障排查

使用场景

适用于Concourse流水线中，在代码构建、测试等任务执行前后更新Bitbucket上对应提交的状态，帮助团队实时掌握流水线进度和结果。例如：任务开始时标记为INPROGRESS，成功后标记为SUCCESSFUL，失败则标记为FAILED。

配置说明

资源类型定义

需在流水线中声明资源类型：

yaml
resource_types:
  - name: bitbucket-notify
    type: docker-image
    source:
      repository: ecometrica/concourse-resource-bitbucket

资源配置（source字段）

必填项：

• client_id：OAuth消费者的Key（Bitbucket界面中显示）
• secret：OAuth消费者的密钥
• repo：Bitbucket仓库全称（格式：<用户名>/<仓库名>）

可选项：

• debug：是否开启调试模式（默认false，开启后输出JSON交互日志）

行为参数（out操作）

提交构建状态时需指定：

• repo：Git/Hg资源的目录名（来自流水线中之前的get操作）
• build_status：构建状态，必须为SUCCESSFUL、FAILED或INPROGRESS（大小写敏感）

部署示例

以下是流水线中使用该资源的完整示例：

yaml
resources:
  - name: testing-repo
    type: git
    source:
      uri: https://bitbucket.org/someuser/somerepo.git
      branch: master

  - name: bitbucket-notify
    type: bitbucket-notify
    source:
      client_id: 你的OAuth Key
      secret: 你的OAuth密钥
      repo: someuser/somerepo

jobs:
  - name: integration-tests
    plan:
    - get: testing-repo
      trigger: true

    - put: bitbucket-notify
      params:
        build_status: INPROGRESS
        repo: testing-repo

    - task: run-tests
      file: testing-repo/task.yml
      on_success:
        put: bitbucket-notify
        params:
          build_status: SUCCESSFUL
          repo: testing-repo
      on_failure:
        put: bitbucket-notify
        params:
          build_status: FAILED
          repo: testing-repo

许可证

本镜像基于Apache License v2.0授权，详情见https://github.com/ecometrica/concourse-resource-bitbucket/blob/master/LICENSE%E3%80%82