citilink/concourse-git-resource

Git资源镜像

镜像概述

本镜像为Concourse CI的Git资源组件，用于跟踪Git仓库的提交记录，支持代码拉取、变更推送、标签管理、GPG签名验证等核心功能，帮助CI/CD流水线实现自动化的版本控制流程。

核心功能

1. check：检查Git仓库的新提交，自动忽略含[ci skip]或[skip ci]标记的提交
2. in：拉取指定版本的代码，支持子模块递归更新、git-crypt解密、GPG签名验证
3. out：推送本地变更到仓库，支持rebase/merge冲突处理、标签创建与推送、强制推送等操作

使用场景

• CI流水线中拉取项目源码进行构建、测试
• 推送构建产物的版本标签到Git仓库
• 验证提交的GPG签名确保代码完整性
• 通过HTTPS代理访问受网络限制的Git仓库

配置说明

源配置（Source Configuration）

示例配置

标签过滤的资源配置

yaml
resources:
- name: source-code
  type: git
  source:
    uri: git@github.com:concourse/git-resource.git
    tag_filters:
    - "v*.*.[0-9]"
    - "v*.*.[0-9][0-9]"

私有仓库带HTTPS代理的配置

yaml
resources:
- name: source-code
  type: git
  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
    git_crypt_key: AEdJVEN...snip...AAA==
    https_tunnel:
      proxy_host: proxy-server.mycorp.com
      proxy_port: 3128
      proxy_user: myuser
      proxy_password: myverysecurepassword

拉取指定深度的代码

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

推送本地变更到仓库

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

使用说明

该镜像需在Concourse CI环境中作为资源类型使用，通过pipeline配置文件定义资源及相关操作步骤，实现Git仓库的自动化管理。