eugenmayer/concourse-git-semver-tag-resource

Git Semver Tag资源

这是Concourse CI的专用资源，用于通过Git标签管理仓库版本号。它基于Concourse semver资源概念，但仅依赖Git且聚焦于标签而非仓库文件，还支持根据Git提交信息自动调整版本。

核心功能

• 版本检查：扫描Git仓库标签获取当前版本，无标签时使用初始版本。
• 版本获取：将版本号作为number文件提供给构建，支持本地临时bump版本。
• 版本更新：通过文件设置版本，或基于bump策略原子更新版本标签。
• 自动版本调整：根据提交信息中的[breaking]、[patch]标记自动更新主版本、次版本或补丁版本。

使用场景

• CI/CD流水线中自动生成和维护软件版本标签。
• 发布阶段基于提交记录自动生成语义化版本。
• 初始化仓库版本并持续跟踪版本迭代。

配置说明

资源类型配置

在流水线的resource_types部分添加：

yaml
resource_types:
- name: concourse-git-semver-tag
  type: docker-image
  source:
    repository: eugenmayer/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}}

流水线计划示例（先获取并bump，再提交）：

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

原子bump示例：

yaml
plan:
- put: version
  params: {bump: minor}
- task: deploy-with-version

行为说明

check：获取当前版本

扫描仓库标签返回最新版本，无标签时返回initial_version。

in：提供版本文件

将版本号写入number文件供构建使用，支持通过bump参数临时调整版本（不修改仓库标签）。

out：更新版本标签

通过文件设置版本，或使用bump参数原子更新仓库标签。若仓库无标签，基于initial_version进行bump。

版本Bump规则

in和out支持以下参数：

• bump：可选（默认patch），取值包括major（主版本）、minor（次版本）、patch（补丁）、auto（根据提交信息自动判断）。
• pre：可选，生成预发布版本（如rc、alpha），或更新现有预发布版本序号。

例如，提交信息含[breaking]时，bump: auto会升级主版本；含[patch]则升级补丁版本，否则升级次版本。