orangecloudfoundry/git-branch-heads-resource

Git Branch Heads Resource 镜像

镜像概述

Git Branch Heads Resource是Concourse CI的资源类型，用于跟踪Git仓库中所有分支或符合过滤条件的分支变更。它跳过单个分支的提交，但确保分支新增、删除或更新时生成版本事件，需配合Concourse的version: every配置使用。

核心功能

• 跟踪Git仓库所有分支或指定过滤规则的分支变化
• 分支新增、删除或更新时生成版本事件
• 兼容Concourse原生Git资源的大部分配置参数
• 支持分支包含（branches）和排除（exclude）过滤规则

使用场景

• 监控Git仓库多分支变更的Concourse CI流水线
• 跟踪特定前缀（如wip-*）的分支
• 排除特定模式（如feature/.*）的分支
• 每个分支变更都需触发流水线任务的场景

配置说明

安装

在Concourse流水线中添加以下resource_types配置：

yaml
---
resource_types:
- name: git-branch-heads
  type: docker-image
  source: {repository: orangecloudfoundry/git-branch-heads-resource}

源配置

基于Concourse原生Git资源，新增参数：

• branches：可选，分支过滤数组，未指定则跟踪所有分支
• exclude：可选，分支排除正则表达式，未指定则不排除

原生Git资源的branch配置在check操作中被忽略

配置示例

1. 跟踪wip-*前缀分支：

yaml
resources:
- name: my-repo-branches
  type: git-branch-heads
  source:
    uri: https://github.com/concourse/atc
    branches: [wip-*]

2. 排除version分支和feature/开头分支：

yaml
resources:
- name: my-repo-branches
  type: git-branch-heads
  source:
    uri: https://github.com/concourse/atc
    exclude: version|feature/.*

行为说明

check：检查分支变更

克隆/拉取仓库，枚举远程分支并对比现有分支，若有新增/删除则生成版本事件。

in：拉取变更提交

委托原生Git资源的in操作，指定变更分支和提交，遵守原生资源配置。

out：无操作

暂未实现该功能。