victoru/git-merge-resource

Git合并资源

用于跟踪Git仓库中的提交。

源配置

• uri：必填。仓库的位置。
• branch：要跟踪的分支。仅用于get步骤时可选（默认master），put步骤时必填。
• private_key：可选。拉取/推送时使用的私钥，可通过流水线模板隐藏。
• username：可选。HTTP(S)认证用户名，需认证且仅支持HTTP/HTTPS时必填。
• password：可选。HTTP(S)认证密码，可通过流水线模板隐藏。
• paths：可选。仅指定文件变更触发新版本（glob模式列表）。
• ignore_paths：可选。忽略指定文件的变更。
• skip_ssl_verification：可选。跳过Git SSL验证。
• git_config：可选。配置Git全局选项（键值对列表）。
• disable_ci_skip：可选。允许包含[ci skip]/[skip ci]的提交被发现。
• commit_verification_keys：可选。验证提交的GPG公钥数组。
• commit_verification_key_ids：可选。验证提交的GPG公钥ID数组，从指定密钥服务器获取。
• gpg_keyserver：可选。GPG密钥服务器，默认hkp:///keys.gnupg.net/。

示例

私有仓库配置：

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

浅克隆仓库：

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

推送代码：

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

行为

check：检查新提交

克隆/拉取仓库，返回指定版本后的提交；无版本时返回HEAD引用；忽略含[ci skip]的提交。

in：克隆仓库到指定版本

克隆仓库并锁定到指定引用，递归初始化子模块。参数包括depth（浅克隆深度）、submodules（子模块策略）、disable_git_lfs（是否禁用LFS）。支持GPG签名验证，生成.git/committer（提交者***）和.git/ref（版本引用）文件。

out：推送代码到仓库

推送引用和标签到源仓库；非快速前进时可选择rebase或merge；支持标签、强制推送等参数。

开发

前提条件

• golang 1.9+
• docker 17.06+

运行测试

sh
docker build -t git-resource .

贡献

提交PR到master分支并确保本地测试通过。