victoru/git-multibranch-resource

Git多分支资源镜像概述

该镜像为Concourse CI/CD工具提供git多分支资源类型，用于跟踪git仓库的分支变更，触发流水线执行并获取指定分支代码，支持多分支模式、私有仓库访问、路径过滤等功能，适用于多分支开发场景下的自动化构建与部署。

核心功能

• 跟踪git仓库分支变更，支持正则表达式匹配分支
• 支持私有仓库访问（通过RSA私钥配置）
• 可通过路径过滤仅跟踪指定文件/目录的变更
• 支持Redis存储多分支历史引用，避免污染ref lines
• 支持浅克隆（指定depth）和子模块管理
• 支持推送代码到仓库，包括标签管理

使用场景

1. 多分支开发场景：自动检测符合规则的分支变更，触发对应CI/CD流水线
2. 私有仓库集成：通过私钥访问私有git仓库，实现代码同步与构建
3. 指定路径变更触发：仅当特定文件/目录变更时触发流水线
4. 历史引用管理：使用Redis存储多分支历史，保持资源配置简洁

配置说明

源配置（Source Configuration）

• uri：必填，git仓库地址
• branch：必填，默认跟踪的分支（多分支模式下可忽略）
• private_key：可选，访问私有仓库的RSA私钥
• paths：可选，仅跟踪指定路径的变更（glob模式列表）
• ignore_paths：可选，忽略指定路径的变更
• skip_ssl_verification：可选，跳过git SSL验证（设置GIT_SSL_NO_VERIFY=true）
• branches：可选，多分支模式开关，接受正则表达式匹配分支
• ignore_branches：可选，与branches配合使用，排除匹配的分支
• redis：可选，Redis配置（存储多分支历史引用），包含子键：
  • host：必填，Redis主机名/IP
  • password：可选，Redis密码
  • prefix：可选，键前缀（区分不同流水线）
  • db_number：可选，Redis数据库编号（默认0）

参数（Parameters）

in操作参数

• depth：可选，浅克隆深度（正整数）
• submodules：可选，子模块管理方式（none/all/路径列表）

out操作参数

• repository：必填，要推送的仓库路径
• rebase：可选，非快进推送时尝试重新基址并推送
• tag：可选，标签文件路径（给HEAD打标签）
• only_tag：可选，仅推送标签（设置为true）
• tag_prefix：可选，标签前缀（如v）

部署示例

私有仓库资源配置

yaml
resource_types:
- name: git-multibranch
  type: docker-image
  source:
    repository: victoru/git-multibranch-resource

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

获取仅含100次提交历史的仓库

yaml
- get: source-code
  params: {depth: 100}

推送本地提交到仓库

yaml
- get: some-other-repo
- put: source-code
  params: {repository: some-other-repo}

检测除master和deploy外的所有分支变更

yaml
resources:
- name: my-repo
  type: git-multibranch
  source:
    uri: ***:my-org/my-repo.git
    branches: '.*'
    ignore_branches: '(master|deploy)'