liuyuewen/git-branches-resource

Git Branches Resource镜像

该镜像为Concourse CI/CD流水线提供Git分支资源支持，用于跟踪Git仓库中的分支集合，检测分支的新增与删除情况，助力流水线对分支变更的自动化响应。

安装方式

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

yaml
---
resource_types:
- name: git-branches
  type: docker-image
  source: {repository: vito/git-branches-resource}

资源配置说明

源配置（Source Configuration）

• uri：必填项，Git仓库的地址。
• private_key：可选项，拉取/推送仓库时使用的私钥（示例见下文）。
• username：可选项，HTTP(S)认证的用户名（适用于仅支持HTTP/HTTPS且需要认证的场景）。
• password：可选项，HTTP(S)认证的密码。
• skip_ssl_verification：可选项，跳过Git SSL验证（通过导出GIT_SSL_NO_VERIFY=true实现）。
• git_config：可选项，配置Git全局选项（以name和value键值对列表形式，如credential.helper）。

配置示例（私有仓库）

yaml
resources:
- name: source-code
  type: git-branches
  source:
    uri: git@github.com:concourse/git-resource.git
    private_key: |
      -----BEGIN RSA PRIVATE KEY-----
      MIIEowIBAAKCAQEAtCS10/f7W7lkQaSgD/mVeaSOvSF9ql4hf/zfMwfVGgHWjj+W
      <更多文本内容>
      DWiJL+OFeg9kawcUL6hQ8JeXPhlImG6RTUffma9+iGQyyBMCGd1l
      -----END RSA PRIVATE KEY-----

核心功能

check：检查分支集合变更

克隆（或拉取）仓库，枚举所有远程分支，与现有分支集合对比，若有新增或删除分支则输出包含变更的版本信息。

in：生成版本信息文件

根据获取的版本生成以下文件：

• branches：当前所有分支列表（每行一个分支）。
• added：新增分支列表（每行一个分支）。
• removed：删除分支列表（每行一个分支）。

out：无操作

暂未实现该功能。

使用场景

适用于Concourse CI/CD流水线中监控Git仓库分支变化，例如：

• 当新分支创建时自动触发构建任务；
• 当分支删除时清理相关资源或通知团队；
• 定期同步分支信息用于统计分析。