Go (Golang) 工具之gsemver

什么是gsemver

https://github.com/arnaud-deprez/gsemver

gsemver 是在Go(golang)中开发的命令行工具,它使用Git commit 自动化生成兼容Semver 2.0.0规范的下一 个版本。

Semantic Version是当下被大多数软件/库使用的一套版本命名规范。

semver 是 语义化版本(Semantic Versioning)规范 的一个实现,目前是由 npm 的团队维护,实现了版本和版本范围的解析、计算、比较。

而gsemver 是go版本的语义化版本(Semantic Versioning)规范 的一个实现。

动机

为什么另一个git版本工具?

当您尝试从不同的语言(Java,Go,JavaScript等)来实现Devops管道以获取应用程序和库(Java,Go,JavaScript等)时,您始终需要从要将应用程序/库释放到生产中的部署的那一刻起,您始终需要处理版本。

随着Devops全部自动化,您需要一种自动化您的下一个版本的方法。

那么,你有2个选择:

  1. 您可以使用没有人类有意义的信息:
    • forever increment a number
    • use git commit hash
    • use build number injected by your CI server
    • etc.
  2. 您可以使用诸如 semver 规范,一个有意义的公约。

第一个选项很容易,不需要任何工具。

然而,一些工具/技术要求您使用Semver兼容格式版本(例如,go modules, helm等)。您仍然可以使用major, minor or patch ,但是您的版本在您的版本中并不有意义,只是做一个符合规范格式的黑客,而不是使用Spec语义。

因此,对于第二种选项,为了通过遵循规范语义来提供人类有意义的信息,您需要依靠一些约定。

您可以找到一些Git惯例,如:

  • conventional commits: generalization of angular commit convention to other projects
  • angular commit convention
  • gitflow

然后我寻找现有工具,到目前为止,这里是我发现的详尽清单:

  • GitVersion: tool written in .NET.
  • semantic-release: tool for npm
  • standard-version: tool for npm
  • jgitver: CLI running on java, maven and gradle plugins.
  • hartym/git-semver: git plugin written in python.
  • markchalloner/git-semver: another git plugin written in bash
  • semver-maven-plugin

所有这些工具至少有其中一个问题:

  • 他们依靠运行时环境(NodeJs,Python,Java)。但是,如果我想在另一个运行时建立一个应用程序怎么办?在VM上,这可能不是一个大的事情,而是在我们尝试保持它们尽可能小的容器中,这可能很烦人。
  • 它们不是根据惯例自动生成新版本的。相反,您必须指定要击中的数字(主要,次要,修补程序)和/或您要生成的版本类型(Alpha,Beta,Build等)
  • 它们管理完整的发布生命周期,因此它们紧紧地耦合到某些构建工具,如NPM,Maven或Gradle等。

我发现了一些go 写的库,但他们不处理Git commits/tags约定:

  • hashicorp/go-version
  • coreos/go-semver
  • Masterminds/semver
  • blang/semver

我需要一个工具来基于以前的 git tag 生成下一个版本Semver兼容版本,我可以在每种类型的应用程序/库上使用,因此不依赖于特定的运行时环境。

这就是为什么我决定使用go,我们发现的工具的灵感基础上来构建此工具。

感谢

gsemver
  • conventional commits a commit convention I’ve decided to adopt in all my commits.
  • git-chglog is a customizable CHANGELOG generator implemented in go based on commits log.
  • GoGeleaser is a release automation tool for Go projects.
gsemver

gsemver 安装

安装

go get -u github.com/arnaud-deprez/gsemver

对于手动安装,您可以从发布页面下载二进制文件并将其放在$ Path目录中。

$ gsemver version
# output the gsemver version

gsemver 使用

准备

大多数CI系统- 默认 - shallow git clone 仓库。

gsemvergit describe gsemvergit fetch --tags
[root@dev iam]# git fetch --tags
remote: Enumerating objects: 5698, done.
remote: Counting objects: 100% (5696/5696), done.
remote: Compressing objects: 100% (1470/1470), done.
remote: Total 5125 (delta 3712), reused 4778 (delta 3422), pack-reused 0
Receiving objects: 100% (5125/5125), 1.51 MiB | 3.29 MiB/s, done.
Resolving deltas: 100% (3712/3712), completed with 349 local objects.
From https://github.com/marmotedu/iam
 * [new tag]         v1.0.0     -> v1.0.0
 * [new tag]         v1.0.1     -> v1.0.1
 * [new tag]         v1.0.10    -> v1.0.10
 * [new tag]         v1.0.2     -> v1.0.2
 * [new tag]         v1.0.3     -> v1.0.3
 * [new tag]         v1.0.4     -> v1.0.4
 * [new tag]         v1.0.5     -> v1.0.5
 * [new tag]         v1.0.6     -> v1.0.6
 * [new tag]         v1.0.8     -> v1.0.8
 * [new tag]         v1.1.0     -> v1.1.0
 * [new tag]         v1.2.0     -> v1.2.0
 * [new tag]         v1.4.0     -> v1.4.0
 * [new tag]         v1.6.0     -> v1.6.0
[root@dev iam]#
gsemvergit symbolic-ref HEADgsemverGIT_BRANCH

git HEAD 基础

HEAD是一个符号引用,他指向你正在工作的分支,他总是指向你最近的一次提交记录,如果想看 HEAD 指向,可以通过 cat .git/HEAD 查看, 如果 HEAD 指向的是一个引用,还可以用 git symbolic-ref HEAD 查看它的指向。 可以使用git checkout 提交记录对应的hash值,来切换到对应的提交上,可以使用git log来查看对应的提交和hash值。

git checkout 分支名^ HEAD指向该分支的本次提交记录的上一次提交。
git checkout 分支名~3 HEAD指向该分支的本次提交记录的上上上次提交。

CLI

自动化生成版本

gsemver bump

这将使用git commits convention 来生成下一个版本。

masterrelease/*
depth
*   34385d9 (HEAD -> master, tag: v1.2.2) Merge from feature/merge2-release-1.1.x
|\  
| *   b884197 Merge from release/1.1.x
| |\  
|/ /  
| *   869c83f (tag: v1.1.3, release/1.1.x) Merge from fix/fix-3
| |\  
| | * 22eabaf fix: my bug fix 3 on release/1.1.x
| |/  
* |   704fde4 (tag: v1.2.1) Merge from feature/merge-release-1.1.x
|\ \  
| * \   61b6a7c Merge from release/1.1.x
| |\ \  
|/ / /  
| | _   
| *   f2d9b5e (tag: v1.1.2) Merge from fix/fix-2
| |\  
| | * f95ccbe fix: my bug fix 2 on release/1.1.x
| |/  
* |   99a3662 (tag: v1.2.0) Merge from feature/awesome-3
|\ \  
| |/  
|/|   
| * cc6c1ed feat: my awesome 3rd change
|/  
*   145cbff (tag: v1.1.1) Merge from bug/fix-1
|\  
| * 681a11b fix: my bug fix on master
|/  
*   e9e7644 (tag: v1.1.0) Merge from feature/awesome-2
|\  
| * f30042e feat: my awesome 2nd change
|/  
*   fba50a2 (tag: v1.0.0, tag: v0.2.0) Merge from feature/awesome-1
|\  
| * bf05218 feat: my awesome change
|/  
* c619bff (tag: v0.1.1) fix(doc): fix documentation
* 128a5d9 (tag: v0.1.0) feat: add README.md

手动版本包

gsemver bump major
gsemver bump minor
gsemver bump patch

配置文件

您还可以使用配置文件来定义自己的规则。默认情况下,它将查找.gsemver.yaml或then in $ home / .gsemver.yaml中的文件,但您可以通过–config(或-c)选项来指定自己的配置文件:

gsemver --config my-config.yaml
# or
gsemver -c my-config.yaml

配置文件格式如下所示:

majorPattern: "(?m)^BREAKING CHANGE:.*$"
minorPattern: "^feat(?:\(.+\))?:.*"
bumpStrategies:
- branchesPattern: "^(master|release/.*)$"
  strategy: "AUTO"
  preRelease: false
  preReleaseTemplate:
  preReleaseOverwrite: false
  buildMetadataTemplate:
- branchesPattern: ".*"
  strategy: "AUTO"
  preRelease: false
  preReleaseTemplate:
  preReleaseOverwrite: false
  buildMetadataTemplate: "{{.Commits | len}}.{{(.Commits | first).Hash.Short}}"

这是用于传统提交的默认配置。您可以根据需要调整配置。

bumpStrategies 是按顺序应用的,直到一个与当前分支的branchesPattern 正则表达式匹配。这允许您根据自己的 git flow定义您的策略。

语义化版本 2.0.0

官方原文:https://semver.org/lang/zh-CN/

版本格式:主版本号.次版本号.修订号,版本号递增规则如下:

  • 主版本号:当你做了不兼容的 API 修改,
  • 次版本号:当你做了向下兼容的功能性新增,
  • 修订号:当你做了向下兼容的问题修正。
    先行版本号及版本编译信息可以加到“主版本号.次版本号.修订号”的后面,作为延伸。

考虑使用这样的版本号格式:X.Y.Z(主版本号.次版本号.修订号)修复问题但不影响 API 时,递增修订号;API 保持向下兼容的新增及修改时,递增次版本号;进行不向下兼容的修改时,递增主版本号。

主版本号为零(0.y.z)的软件处于开发初始阶段,一切都可能随时被改变。这样的公共 API 不应该被视为稳定版。

1.0.0 的版本号用于界定公共 API 的形成。这一版本之后所有的版本号更新都基于公共 API 及其修改内容。

语义化版本控制规范(SemVer)
语义化版本控制的规范是由 Gravatars 创办者兼 GitHub 共同创办者 Tom Preston-Werner 所建立。

该章节直接查看,官方 https://semver.org/lang/zh-CN/ 即可。