mkocus/concourse-git-bitbucket-pr-resource

concourse-git-bitbucket-pr-resource

跟踪所有git分支的拉取请求变更。

此资源应配合 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: 可选。跟踪的拉取请求数量限制，默认值：100。
• git: 必填。基于 https://github.com/concourse/git-resource 的配置。原始资源中的 branch 配置会被忽略。
• bitbucket_type: 可选。cloud 表示BitBucket Cloud，server 表示自托管的BitBucket Server，默认值：server。
• dir: 已弃用。若资源名称与仓库名称不同，设置为资源名称。已被 out 中的 params.repository 替代。
• branch: 可选。若指定，仅检查针对该分支的拉取请求。
• paths: 可选。若指定（作为glob模式列表），仅指定文件的变更会触发新版本检查。
• changes_limit: 可选。每个拉取请求加载的变更路径最大数量，默认值：100。仅在设置 paths 参数时生效。
• direction: 可选。相对于指定仓库的方向，incoming（目标，如到master）或 outgoing（源，如从feature）。

认证方式（二选一）：

• username: 必填。有权访问仓库的用户用户名。
• password: 必填。该用户的密码。 或：
• oauth_id: 必填。配置为私有的OAuth消费者的Oauth ID，需具有写入PR的权限。
• oauth_secret: 必填。同一消费者的Oauth密钥。

示例

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: 检查所有拉取请求的变更。

从Bitbucket服务器获取给定项目和仓库的当前开放拉取请求，比较更新时间与上次获取的PR。若有PR新增、更新或移除，会生成新版本。

in: 获取变更PR的提交。

此资源完全委托给原始Git资源的 in 操作，将 source.git 传递给原始 git-resource 的 source，并指定 source.branch 为变更的分支，version.ref 为分支上的提交。

参数

除以下列出的参数外，所有 params 都会传递给原始 git-resource 的 params。

• skip_download: 可选。跳过 git pull，基于git的工件将不存在。
• fetch_upstream: 可选。同时拉取PR的上游引用，这会覆盖 fetch 参数。

out: 更新PR。

行为取决于 action 参数的值：

• change-build-status: 变更提交的构建状态。
  • action: 必填。此行为需设为 change-build-status。
  • 除 name 外的参数遵循 Bitbucket文档。
  • name: 已弃用。仅为向后兼容保留。
  • repository: 可选。用于变更构建状态的源仓库路径。
• push: 将提交推送到PR分支。
  • action: 必填。此行为需设为 push。
  • repository: 可选。用于推送的源仓库路径。

故障排除

• https://github.com/zarplata/concourse-git-bitbucket-pr-resource/issues/15%E3%80%82

Concourse不支持跳过版本，但有解决方法：添加一个与 pull-request 设置相同的资源，仅用于变更构建状态。

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