jpmorin/concourse-git-semver-tag-resource

Git Semver Tag Resource

通过git标签管理仓库版本号的资源。概念上基于https://github.com/concourse/semver-resource%EF%BC%8C%E4%BD%86%E4%BB%85%E4%BE%9D%E8%B5%96git%E4%B8%94%E4%B8%93%E6%B3%A8%E4%BA%8E%E6%A0%87%E7%AD%BE%E8%80%8C%E9%9D%9E%E4%BB%93%E5%BA%93%E4%B8%AD%E7%9A%84%E6%96%87%E4%BB%B6%E3%80%82%E6%94%AF%E6%8C%81%E5%9F%BA%E4%BA%8Egit%E6%8F%90%E4%BA%A4%E6%B6%88%E6%81%AF%E8%87%AA%E5%8A%A8%E6%9B%B4%E6%96%B0%E7%89%88%E6%9C%AC%E3%80%82

安装

在管道配置的resource_types部分添加以下内容以使用此资源：

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

源配置

• initial_version: 可选（默认：0.0.0）。 引导时使用的版本号，即当源中不存在版本号（尚无标签）时使用。

• uri: 必填。 仓库URL。

• branch: 必填。 所有标签所在的分支。

• private_key: 可选。 拉取/推送仓库时使用的SSH私钥。

• username: 可选。 HTTP(S)认证的用户名，用于拉取/推送。当仅支持HTTP/HTTPS协议且需要认证时使用（不支持私钥认证）。

• 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: a-thing-that-needs-a-version
- put: version
  params: {file: version/number}

或通过原子put更新版本：

yaml
plan:
- put: version
  params: {bump: minor}
- task: a-thing-that-needs-a-version

行为

check: 报告当前版本号

通过扫描git仓库的标签检测新版本。如果尚无标签，返回initial_version。

in: 提供版本文件，可选择更新版本

将版本号以number文件形式提供给构建。可配置本地更新版本，便于在构建制品前获取最终版本。

参数

• bump和pre: 可选。 参见版本更新语义。

注意：bump和pre不会更新版本资源，仅修改提供给构建的版本。需显式指定输出来实际更新版本。

out: 设置版本或更新当前版本

根据文件内容更新版本，或根据更新策略更新当前版本。如果无当前版本，基于initial_version更新。

若需强制设置特定版本，使用file参数。可与in结合使用，但建议使用bump和pre参数以实现原子更新。

参数

必须指定以下之一：

• file: 可选。 包含要设置的版本号的文件路径。

• bump和pre: 可选。 参见版本更新语义。

使用bump和/或pre时，版本更新将以原子方式应用。

版本更新语义

in和out均支持通过bump和pre参数进行语义化版本更新。

• bump: 可选（默认：patch）。 语义化更新版本号。取值必须为：

  • major: 更新主版本号，例如1.0.0 -> 2.0.0。
  • minor: 更新次版本号，例如0.1.0 -> 0.2.0。
  • patch: 更新修订版本号，例如0.0.1 -> 0.0.2。
  • auto: 分析HEAD与当前版本间的提交消息。默认更新次版本号，除非提交包含以下标记（两者不可同时存在）：
    • [breaking]: 更新主版本号
    • [patch]: 更新修订版本号

  注意：如果当前版本是预发布版本且未定义pre，上述任何操作都将生成正式版本，例如1.0.0-rc.1 -> 1.0.0

• pre: 可选。 更新时生成预发布版本（如rc或alpha），或更新现有预发布版本。

若存在此参数且版本已是匹配的预发布版本，则更新预发布号；若版本是其他类型的预发布版本（如alpha vs beta），则切换类型并重置预发布号为0；若版本不是预发布版本，则添加预发布标记并从0开始。