she110ck/concourse-git-bitbucket-pr-resource

concourse-git-bitbucket-pr-resource

镜像概述

concourse-git-bitbucket-pr-resource是一个Concourse CI资源镜像，从https://hub.docker.com/r/zarplata/concourse-git-bitbucket-pr-resource%E5%88%86%E5%8F%89%E8%80%8C%E6%9D%A5%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E4%BD%BF%E7%94%A8%E6%97%A7%E7%89%88%E6%9C%AC%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8Fhttps://hub.docker.com/layers/git-resource/concourse/git-resource/1.13.0/images/sha256-83d7f903f94f7f60673b4b70209cdfc27e4f38385df323f9d8c50666ec62b6d2?context=explore%EF%BC%8C%E5%B9%B6%E5%8C%85%E5%90%AB%E8%A1%A5%E4%B8%81%E4%BB%A5%E8%A7%A3%E5%86%B3%E7%89%B9%E5%AE%9Agit%E8%B7%AF%E5%BE%84%E5%8C%B9%E9%85%8D%E9%97%AE%E9%A2%98%EF%BC%8C%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8E%E5%9C%A8Concourse CI环境中跟踪Bitbucket拉取请求的git分支。

核心功能与特性

• Bitbucket PR跟踪：作为Concourse CI资源，支持监控和跟踪Bitbucket仓库的拉取请求（PR）分支
• bug修复补丁：集成补丁解决git资源的error: pathspec '****' did not match any file(s) known to git问题（对应https://github.com/concourse/git-resource/issues/246%EF%BC%89
• 基础镜像版本控制：使用指定旧版本基础镜像concourse/git-resource:1.3.0，确保兼容性
• Bitbucket API配置：针对bitbucket.org使用时，需显式配置base_url: https://api.bitbucket.org

使用场景与适用范围

适用于Concourse CI流水线环境中，需要与Bitbucket仓库集成，实现对拉取请求（PR）事件的监控、触发及分支跟踪的场景。特别适合在使用原版git资源时遇到路径匹配bug的用户，通过该补丁版本解决相关问题。

使用方法与配置说明

资源类型定义

在Concourse pipeline配置中，需先定义资源类型：

yaml
resource_types:
- name: bitbucket-pr
  type: docker-image
  source:
    repository: [镜像仓库地址，原文档未提供具体地址]
    tag: [镜像标签，原文档未提供具体标签]

资源配置示例

定义具体资源时，需配置Bitbucket相关参数：

yaml
resources:
- name: my-bitbucket-pr
  type: bitbucket-pr
  source:
    base_url: https://api.bitbucket.org  # 针对bitbucket.org的必填配置
    repo: my-org/my-repo  # Bitbucket仓库路径，格式为"组织/仓库名"
    access_token: ((bitbucket-access-token))  # Bitbucket访问令牌，用于API认证（需具备PR访问权限）
    # 可选配置：
    # branch: main  # 要监控的目标分支，默认为仓库默认分支
    # ignore_drafts: true  # 是否忽略草稿PR，默认为false

典型使用示例（在job中引用）

yaml
jobs:
- name: test-pr
  plan:
  - get: my-bitbucket-pr
    trigger: true  # 当有新PR或PR更新时触发job
  - task: run-tests
    config:
      platform: linux
      image_resource:
        type: docker-image
        source: {repository: alpine, tag: latest}
      inputs:
      - name: my-bitbucket-pr  # PR分支代码将被拉取到该目录
      run:
        path: sh
        args:
        - -c
        - |
          cd my-bitbucket-pr
          # 执行测试命令
          echo "Running tests for PR..."

环境变量与配置参数说明