cathive/concourse-bitbucket-pullrequest-resource

BitBucket拉取请求资源

该资源用于Concourse CI管道，跟踪BitBucket Server或Cloud中Git仓库的拉取请求变化，并更新PR的构建状态。需配合version: every使用以确保覆盖所有PR更新。

核心功能

1. 检查PR变化：获取指定项目/仓库的所有开放PR，对比更新时间以识别新增、修改或移除的PR。
2. 拉取PR提交：基于Git资源的逻辑，拉取PR对应分支的最新提交。
3. 更新PR状态：将Concourse任务的执行结果（成功/失败）同步到BitBucket PR的状态中。

使用场景

• Concourse CI/CD管道中，针对BitBucket仓库的PR进行自动化验证（如单元测试、代码检查）。
• 实时跟踪PR的变更，触发流水线执行并反馈结果到PR页面。

配置说明

安装配置

在Concourse流水线中添加资源类型：

yaml
resource_types:
- name: bitbucket-pr
  type: docker-image
  source:
    repository: cathive/concourse-bitbucket-pullrequest-resource
    tag: latest # 建议使用固定版本号保证可重复性

资源配置参数

• base_url：必填，BitBucket服务器基础URL（无尾斜杠），如http://bitbucket.local。
• username：必填，有权限访问仓库的用户名。
• password：必填，对应用户的密码。
• project：必填，跟踪的项目名称。
• repository：必填，跟踪的仓库名称。
• limit：可选，跟踪的PR数量上限，默认100。
• git：必填，基于Git资源的配置（忽略原Git资源的branch参数），包含uri（仓库地址）、private_key（私有仓库密钥）等。
• bitbucket_type：可选，类型为cloud（BitBucket Cloud）或server（自托管Server），默认server。

示例配置

yaml
resources:
- name: my-repo-pr
  type: bitbucket-pr
  source:
    base_url: http://bitbucket.local
    username: test-user
    password: test-pass
    project: cathive
    repository: concourse-bitbucket-pullrequest-resource
    git:
      uri: https://github.com/cathive/concourse-bitbucket-pullrequest-resource
      private_key: ((git-repo-key))

jobs:
- name: pr-validation
  plan:
    - get: my-repo-pr
      trigger: true
      version: every
    - task: unit-test
      inputs:
        - name: my-repo-pr
      run:
        path: sh
        args: ["-c", "cd my-repo-pr && make test"]
    - put: my-repo-pr
      params:
        state: SUCCESSFUL
        name: "单元测试"
        dir: my-repo-pr
      on_success: true
    - put: my-repo-pr
      params:
        state: FAILED
        name: "单元测试"
        dir: my-repo-pr
      on_failure: true

行为说明

• check：获取指定仓库的开放PR，对比更新时间生成新版本。
• in：委托Git资源拉取PR对应分支的提交，保留原Git资源的配置和参数。
• out：更新PR的构建状态，需指定dir（资源名称与仓库名不同时填写）。