nikolovdragan/concourse-bitbucket-pullrequest-resource

Concourse Bitbucket拉取请求资源

本镜像为Concourse CI/CD工具的资源类型，用于跟踪Bitbucket Server仓库的拉取请求（Pull Request），并可设置PR的状态为pending、success或failure（需在流水线中显式定义）。

注意：此资源适用于Bitbucket Server，可能不适用于Bitbucket Cloud。

安装

在流水线配置的resource_types部分添加以下内容以使用该资源：

yaml
---
resource_types:
- name: concourse-bitbucket-pullrequest
  type: docker-image
  source:
    repository: nikolovdragan/concourse-bitbucket-pullrequest-resource

更多细节请参考Concourse文档。

源配置（Source Configuration）

• uri：必填。仓库的地址。
• private_key：可选。拉取/推送时使用的私钥。
• username：可选。HTTP(S)认证用户名（仅HTTP/HTTPS协议且需认证时使用）。
• password：可选。HTTP(S)认证密码。
• token：可选。HTTP(S)认证令牌（替代用户名密码，需配置个人访问令牌）。
• skip_ssl_verification：可选。是否跳过Git SSL验证。
• git_config：可选。Git全局配置（键值对列表）。
• only_for_branch：可选。仅考虑目标分支匹配正则表达式的PR。
• only_without_conflicts：可选（默认true）。仅构建无冲突的PR。
• only_when_mergeable：可选（默认false）。仅构建可合并的PR。
• rebuild_phrase：可选（默认"test this please"）。匹配PR评论的重建触发词。
• debug：可选（默认false）。是否启用bash跟踪。

行为（Behavior）

check：搜索待构建的PR

返回所有符合源配置条件的PR版本。

in：克隆仓库到PR合并引用

将仓库克隆到目标路径，锁定到指定引用。需在get步骤设置version: every以构建所有版本。

参数

• depth：可选。浅克隆深度（可能影响功能）。
• submodules：可选。子模块获取策略（none/all/指定路径）。
• disable_git_lfs：可选。是否禁用Git LFS。

out：更新PR状态

设置指定PR的状态（success/failure/pending）。

参数

• path：必填。仓库路径。
• status：必填。状态值。
• comment：可选。自定义评论（支持[[BRANCH]]变量）。
• commentFile：可选。评论文件路径（由前序任务生成）。

示例流水线

yaml
resource_types:
- name: concourse-bitbucket-pullrequest
  type: docker-image
  source:
    repository: emeraldsquad/concourse-bitbucket-pullrequest-resource

resources:
- name: pullrequest
  type: concourse-bitbucket-pullrequest
  source:
    username: {{bitbucket-username}}
    password: {{bitbucket-password}}
    uri: [***]
    debug: true

jobs:
- name: 测试拉取请求
  plan:
  - get: pullrequest
    trigger: true
    version: every
  - put: pullrequest
    params:
      path: pullrequest
      status: pending  
  - task: 测试
    config:
      platform: linux
      inputs:
      - name: pullrequest
      # ...任务配置
    on_success:
      put: pullrequest
      params:
        path: pullrequest
        status: success
    on_failure:
      put: pullrequest
      params:
        path: pullrequest
        status: failure