johnharvey/concourse-git-semver-tag-resource

Git Semver Tag Resource（Concourse CI资源）

镜像概述

本镜像为Concourse CI的资源类型，用于通过Git标签管理仓库的语义化版本号。基于https://github.com/concourse/semver-resource%EF%BC%8C%E4%BD%86%E4%B8%93%E6%B3%A8%E4%BA%8EGit%E6%A0%87%E7%AD%BE%E8%80%8C%E9%9D%9E%E4%BB%93%E5%BA%93%E5%86%85%E6%96%87%E4%BB%B6%EF%BC%8C%E5%B9%B6%E6%94%AF%E6%8C%81%E6%A0%B9%E6%8D%AEGit%E6%8F%90%E4%BA%A4%E4%BF%A1%E6%81%AF%E8%87%AA%E5%8A%A8%E6%9B%B4%E6%96%B0%E7%89%88%E6%9C%AC%E3%80%82

核心功能

1. 版本检查：扫描Git仓库标签获取当前版本，无标签时使用初始版本；
2. 版本获取：将版本号作为number文件提供给构建流程，支持本地版本bump；
3. 版本更新：通过文件指定版本或按策略bump当前版本（支持原子操作）；
4. 自动bump：根据提交信息中的[breaking]（major）、[patch]（patch）或默认（minor）自动调整版本。

使用场景

适用于Concourse CI流水线中管理项目的语义化版本号，自动生成Git版本标签，简化版本发布流程。

配置说明

资源类型安装

在流水线配置的resource_types部分添加：

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

资源配置项

• initial_version：可选（默认0.0.0），无标签时使用的初始版本；
• uri：必填，Git仓库URL；
• branch：必填，标签所在的分支；
• private_key：可选，拉取/推送仓库的SSH私钥；
• username：可选，HTTP(S)认证用户名；
• password：可选，HTTP(S)认证密码。

流水线示例

资源配置

yaml
resources:
- name: version
  type: concourse-git-semver-tag
  source:
    uri: git@github.com:concourse/concourse.git
    branch: version
    private_key: {{concourse-repo-private-key}}

get+put流程

yaml
plan:
- get: version
  params: {bump: minor}
- task: build-artifact
- put: version
  params: {file: version/number}

原子更新流程

yaml
plan:
- put: version
  params: {bump: minor}
- task: build-artifact

行为说明

check：获取当前版本

扫描Git仓库标签返回最新版本，无标签则返回初始版本。

in：提供版本文件

将版本号作为number文件输出，支持本地版本bump（仅修改输出文件，不更新资源）。

out：更新版本

通过文件指定版本或按策略bump当前版本，支持原子操作确保版本一致性。

版本Bump规则

• bump参数：支持major/minor/patch/auto，auto模式根据提交信息自动选择；
• pre参数：用于预发布版本（如rc、alpha），支持切换预发布类型或bump预发布号。