mm62/concourse-bitbucket-pullrequest-resource

Concourse Bitbucket拉取请求资源

这是Concourse CI的资源类型，用于跟踪Bitbucket Server仓库的拉取请求，并可设置拉取请求的状态（待处理、成功或失败）。该资源是对不再维护的laurentverbruggen/concourse-bitbucket-pullrequest-resource的分支，且持续开发中。

核心功能

• 跟踪Bitbucket Server仓库的拉取请求
• 为拉取请求设置状态（pending/success/failure）
• 支持基于分支、冲突状态、可合并性等条件筛选PR
• 支持通过评论触发PR重建
• 可向PR添加构建状态相关评论

使用场景

适用于Concourse CI流水线中，集成Bitbucket Server仓库的拉取请求自动化流程，例如：

• PR提交后自动触发构建测试
• 根据构建结果更新PR状态
• 仅构建符合特定条件（如无冲突、已获批准）的PR

配置说明

资源类型安装

在流水线配置的resource_types部分添加以下内容：

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

源配置（Source Configuration）

• uri: 必选，仓库地址
• private_key: 可选，拉取/推送时使用的私钥
• username: 可选，HTTP(S)认证用户名
• password: 可选，HTTP(S)认证密码
• token: 可选，HTTP(S)认证令牌（替代用户名密码）
• skip_ssl_verification: 可选，跳过Git SSL验证
• git_config: 可选，Git全局配置项（键值对列表）
• only_for_branch: 可选，仅处理目标分支匹配正则的PR
• sleep_between_fetches: 可选，检查PR间隔时间（默认0秒）
• only_without_conflicts: 可选，仅处理无冲突的PR（默认true）
• only_when_mergeable: 可选，仅处理可合并的PR（默认false）
• only_when_asked: 可选，仅当收到指定评论时构建PR（默认false）
• rebuild_when_target_changed: 可选，目标分支变更时重建PR（默认false）
• rebuild_phrase: 可选，触发重建的评论正则（默认"test this please"）
• create_comments: 可选，向PR添加构建状态评论（默认false）

行为说明

check：搜索待构建的PR

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

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

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

参数

• depth: 可选，浅克隆深度（正整数）
• submodules: 可选，子模块处理方式（none/all/路径列表）
• disable_git_lfs: 可选，禁用Git LFS（默认false）

out：更新PR状态

设置指定PR的状态。

参数

• path: 必选，仓库路径
• status: 必选，状态（success/failure/pending）
• comment: 可选，自定义状态评论（[[BRANCH]]会替换为PR分支名）
• commentFile: 可选，包含自定义评论的文件路径

示例流水线

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

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

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