mylesmcdonnell/concourse-git-bitbucket-pr-resource

concourse-git-bitbucket-pr-resource

跟踪所有git分支的拉取请求（PR）变化。

此资源需配合 version: every 使用。

灵感来源于 https://github.com/vito/git-branch-heads-resource

安装

在你的流水线中添加以下 resource_types 条目：

yaml
---
resource_types:
- name: git-bitbucket-pr
  type: docker-image
  source:
    repository: zarplata/concourse-git-bitbucket-pr-resource

源配置

• base_url: 必填。Bitbucket服务器的基础URL，不带末尾斜杠。例如：http://bitbucket.local
• project: 必填。要跟踪的项目。
• repository: 必填。要跟踪的仓库。
• limit: 可选。跟踪的PR数量限制，默认值：100。
• git: 必填。基于 https://github.com/concourse/git-resource 的配置，原资源中的 branch 配置会被忽略。
• bitbucket_type: 可选。cloud 表示BitBucket Cloud，server 表示自托管BitBucket Server，默认值：server。
• branch: 可选。仅检查针对该分支的PR。
• paths: 可选。指定glob模式列表，仅当这些文件变化时产生新版本。
• changes_limit: 可选。每个PR加载的最大变更路径数，默认值：100（仅与paths配合使用）。
• direction: 可选。PR方向（incoming/outgoing）。

认证方式二选一：

• 用户名密码：username（必填）+ password（必填）
• OAuth：oauth_id（必填）+ oauth_secret（必填）

示例

yaml
resources:
- name: my-repo-with-pull-requests
  type: git-bitbucket-pr
  source:
    base_url: http://bitbucket.local
    username: some-username
    password: some-password
    project: zarplata
    repository: concourse-git-bitbucket-pr-resource
    git:
      uri: https://github.com/zarplata/concourse-git-bitbucket-pr-resource
      private_key: {{git-repo-key}}

jobs:
  - name: my build
    plan:    
      - get: my-repo-with-pull-requests
        trigger: true
        version: every
      - task: unit test
          inputs:          
            - name: my-repo-with-pull-requests
          run: ...
        on_failure:
          put: my-repo-with-pull-requests
          params:
            action: change-build-status
            state: FAILED
            name: "unit test"
            url: "http://acme.com/teams/$BUILD_TEAM_NAME/pipelines/$BUILD_PIPELINE_NAME/jobs/$BUILD_JOB_NAME/builds/$BUILD_NAME"
        on_success:
          put: my-repo-with-pull-requests
          params:
            action: change-build-status
            state: SUCCESSFUL
            name: "unit test"
            url: "http://acme.com/teams/$BUILD_TEAM_NAME/pipelines/$BUILD_PIPELINE_NAME/jobs/$BUILD_JOB_NAME/builds/$BUILD_NAME"

核心功能

check：检测PR变化

获取Bitbucket的当前PR，对比更新时间，若PR新增/更新/删除则生成新版本。

in：拉取PR代码

委托原始Git资源拉取PR对应的分支代码。

out：更新PR状态

• change-build-status：更新PR的构建状态（成功/失败/进行中）
• push：将代码推送到PR分支

使用场景

适用于需要自动化处理Bitbucket PR的CI/CD流水线，例如：

• PR提交后自动触发构建测试
• 构建结果实时更新到PR状态
• 自动推送修复代码到PR分支

故障排除

若标记PR状态导致生成新版本，可添加独立资源仅用于状态更新：

- name: test-pull-requests
  plan:
  - get: pull-request
    trigger: true
    version: every
  - put: pull-request-status
    params:
      action: change-build-status
      state: INPROGRESS
      key: concourse-build
      description: Building on Concourse