sarquella/concourse-git-tag-resource

Git标签资源

这是一个Concourse资源类型，用于跟踪Git仓库中的标签。

!build

镜像概述

该资源类型帮助Concourse流水线检测Git仓库中的新标签，并拉取对应标签版本的代码，支持标签过滤、私有仓库认证等功能，是版本化流水线场景的常用工具。

核心功能

1. 检查新标签：克隆或拉取仓库，返回所有符合过滤条件的标签及对应提交记录。
2. 拉取标签代码：将仓库克隆到目标路径，并锁定到指定标签的提交版本。
3. 灵活配置：支持私钥、账号密码认证，跳过SSL验证，以及自定义Git全局配置。

使用场景

• 版本发布流水线：当Git仓库推送新标签时，自动触发构建或部署流程。
• 多版本管理：过滤特定格式的标签（如v*），仅处理正式版本标签。
• 私有仓库集成：通过私钥或账号密码访问需要认证的Git仓库。

配置说明

资源类型安装

在Concourse流水线配置的resource_types部分添加以下内容：

yaml
resource_types:
- name: git-tag
  type: docker-image
  source:
    repository: sarquella/concourse-git-tag-resource

资源配置参数

• uri：必填，Git仓库地址。
• tag_filter：可选（默认：），过滤标签的模式（支持glob语法，如v）。
• private_key：可选，拉取私有仓库时使用的私钥。
• username：可选，HTTP(S)认证的用户名（适用于不支持私钥的HTTP/HTTPS协议）。
• password：可选，HTTP(S)认证的密码。
• skip_ssl_verification：可选，是否跳过Git SSL验证（设置GIT_SSL_NO_VERIFY=true）。
• git_config：可选，Git全局配置列表（如credential.helper），格式为name和value的键值对。

配置示例

过滤以v开头的标签（如v1.0、v2.5.4）的资源配置：

yaml
resources:
- name: tagged-source-code
  type: git-tag
  source:
    uri: git@github.com:concourse/concourse.git
    tag_filter: v*
    private_key: {{concourse-repo-private-key}}

行为说明

• check：检查仓库中的新标签，返回标签及对应提交信息。
• in：克隆仓库并锁定到指定标签的提交版本。
• out：暂未实现。