matbain/gerrit-resource

Gerrit资源镜像

镜像概述

本镜像作为Concourse CI/CD的Gerrit资源组件，用于跟踪Git仓库的提交记录，支持代码的克隆、推送操作，并可灵活配置Git相关参数，帮助用户快速构建自动化的CI/CD流水线。

核心功能

1. 检查Git仓库的新提交（含标签过滤、忽略[ci skip]提交等）
2. 克隆指定版本的代码到目标目录（支持浅克隆、子模块管理）
3. 将本地提交推送到远程仓库（支持重base、标签推送等）
4. 支持私有仓库认证（私钥、HTTP(S)用户名密码）
5. 配置Git全局选项（如大文件阈值、凭证助手等）

配置说明

源配置参数

• uri：必填，Git仓库地址（如***:xxx/xxx.git）
• branch：必填，跟踪的分支名称（如master）
• private_key：可选，拉取/推送用的RSA私钥（用于SSH认证）
• username：可选，HTTP(S)认证的用户名
• password：可选，HTTP(S)认证的密码
• paths：可选，仅跟踪指定文件变更（glob模式列表）
• ignore_paths：可选，忽略指定文件变更（glob模式列表）
• skip_ssl_verification：可选，跳过Git SSL验证（设为true）
• tag_filter：可选，仅检测匹配标签的提交（glob模式）
• git_config：可选，配置Git全局选项（如core.bigFileThreshold:10m）
• disable_ci_skip：可选，允许检测含[ci skip]的提交（设为true）

使用示例

私有仓库资源配置

yaml
resource_types:
- name: gerrit
  image:
    type: docker-image
    source:
      repository: matbain/gerrit-resource

resources:
- name: source-code
  type: gerrit
  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-----
    git_config:
    - name: core.bigFileThreshold
      value: 10m
    disable_ci_skip: true

获取指定深度的代码

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

推送本地提交到仓库

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

行为说明

check：检查新提交

克隆（或拉取）仓库，返回指定版本后的所有新提交；若未指定版本，则返回HEAD的引用；含[ci skip]的提交默认被忽略（可通过disable_ci_skip关闭）。

in：克隆指定版本代码

将仓库克隆到目标目录并锁定到指定版本，递归初始化并更新子模块。
参数：

• depth：可选，浅克隆深度（如100）
• submodules：可选，子模块策略（none/all/指定路径列表）

out：推送代码到仓库

将本地提交推送到源仓库的指定分支，同时推送所有标签；若无法快速合并且未设rebase则失败。
参数：

• repository：必填，待推送的本地仓库路径
• rebase：可选，非快速合并时自动重base并推送
• tag：可选，从文件读取标签名称并打标签
• only_tag：可选，仅推送标签（设为true）
• tag_prefix：可选，标签前缀（如v）
• annotate：可选，从文件读取注释内容生成带注释的标签