概述

Git可给仓库历史中的某一个提交打上标签，常用于标记发布结点。

本文使用的Git版本为：

$ git --version
git version 2.23.0.windows.1
1
2

实战

列出标签

列出全部标签的命令为：git tag或git tag -l或git tag -list，即-l或-list选项是可选的，git tag，即默认列出全部标签，以字母顺序排序。

查找某些特定标签的命令：git tag -l "release*"，查找特定标签时，-l或-list选项必须要带上。

查看标签

使用git show命令可输出标签信息和与之对应的提交信息。根据标签的不同类型，其打印输出的信息不一致，参考下面章节。

创建标签

Git支持两种标签：

• 轻量标签：lightweight，像一个不会改变的分支——它只是某个特定提交的引用。
• 附注标签：annotated，是存储在Git数据库中的一个完整对象，可以被校验，其中包含打标签者的名字、电子邮件地址、日期时间、标签信息，并且可使用 GNU Privacy Guard （GPG）签名并验证。

通常会建议创建附注标签，这样你可以拥有以上所有信息。但是如果你只是想用一个临时标签，或因某些原因不想要保存这些信息，则使用轻量标签。

轻量标签

轻量标签，本质上是将提交校验和存储到一个文件中——没有保存任何其他信息。命令：git tag <tag_name>，即基于当前分支的最后一次提交记录打一个标签轻量。

对轻量标签执行git show命令，输出如下：

$ git tag my-tag
$ git show my-tag
commit f937f5d2d1ad11b0f6c8655f7d4380bbabc4799d (HEAD -> release_20221208_V1.4, tag: my-tag, origin/release_20221208_V1.4)
Author: johnny <johnny@aaaa.com>
Date:   Tue Dec 13 11:05:49 2022 +0800

    WTF???

diff --git a/cloud-autojob/src/test/java/com/xy/cloud/autojob/business/xxljob/AutoJobWarnHandlerTest.java b/cloud-autojob/src/test/java/com/xy/cloud/autojob/business/xxljob/AutoJobWarnHandlerTest.java
1
2
3
4
5
6
7
8
9

不打印额外的标签信息，打印出提交信息，和git diff信息。

附注标签

命令git tag -a <tag_name> -m "test annotated tag"创建附注标签，-a选项指定是附注标签，-m选项指定一条将会存储在标签中的信息。类似于git commit时必填的commit信息。如果没有指定-m选项，Git会启动vi编辑器要求你输入信息。

对附注标签执行git show命令，输出如下：

$ git show tag_master_release_20221011_fix_qiwei
tag tag_master_release_20221011_fix_qiwei
Tagger: scm <scm@ai.com>
Date:   Mon Oct 17 15:14:45 2022 +0800

qiwei
commit 23e88c880860f98767d80571f9b49b8c53a9cc0d (tag: tag_master_release_20221011_fix_qiwei)
Merge: b2fe24a8 1e33e55e
Author: scm <scm@ai.com>
Date:   Mon Oct 17 15:14:42 2022 +0800

    Merge branch 'release_20221011_fix_qiwei' into 'master'

    qiwei

    See merge request !72
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

输出打标签者的信息、打标签的日期时间、附注信息、具体的提交信息。

后期打标签

还可以对过去的提交打标签，即基于某个commit打标签：
$ git tag -a test-commit-tag f367a00 -m "test commit tag"

推送标签

git push命令默认并不会push标签到远程仓库服务器上。在创建完标签后必须显式地推送标签到服务器上。和git push origin <branch>类似。使用命令git push origin <tagname>推送，如果想把本地的多个标签推送到服务器，则可使用--tags选项指定哪些标签。

删除标签

删除本地仓库上的标签，使用命令git tag -d <tagname>，不会删除远程服务器上面的相应标签。删除远程标签有2种方式：

1. git push <remote> :refs/tags/<tagname>，<remote>一般就是origin，当然支持重命名。即使用命令：git push origin :refs/tags/test-commit-tag，将冒号前面的空值推送到远程标签名，从而高效地删除它；
2. git push origin --delete <tagname>，直观易懂。

检出标签

使用git checkout命令，查看某个标签所指向的文件版本，这个命令会使本地仓库处于detached HEAD状态。在此状态下，如果你做了某些更改然后提交它们，标签不会发生变化，但你的新提交将不属于任何分支，并且将无法访问，除非通过确切的提交哈希才能访问。 因此，如果你需要进行更改，比如你要修复旧版本中的错误，那么通常需要创建一个新分支：

git checkout -b fix_qiwei_again tag_master_release_20221011_fix_qiwei
Switched to a new branch 'fix_qiwei_again'
1
2

如果在这之后又进行一次提交，fix_qiwei_again分支就会因为这个改动向前移动，此时它就会和tag_master_release_20221011_fix_qiwei标签产生差别。

CI Tags

基于GitLab的CI机制，每次发布都需要打一个Tag。日积月累，会发现一个Git Repository动辄几百个Tag。

Tag数量巨多，并不影响git clone/push/pull命令的执行；绝大多数公司都使用私有部署的GitLab，命令执行速度都挺快。实际上，影响这几个操作的速度在于git repo里面是否有大文件。

不过：

1. 一年，甚至两三年前的Tag用处不大
2. 打开GitLab，页面显得不清爽
3. Rancher/Jenkins发布时，备选项太多，不易过滤

如何删除历史Tag？

查询所有Tag：git tag -l

过滤指定字母开头的Tag：git tag -l | grep stg或git tag -l "stg2020*"

删除远程Tag：git push -d origin $(git tag -l "stg2020*")

Tag和Commit关系

接触过Rancher的朋友们，应该知道Rancher基于Git Hook + Jenkins可以实现自动构建。

借助于KubernetesFileBrowser，可在线浏览kubernetes pod里的文件，并且可以下载Jar包。使用JD-GUI反编译Jar包，即可知道某个Tag对应的镜像image版本里的Jar包内容。

经过验证：

• 本地修改过的文件，没有执行命令git commit，此时执行命令git tag -a stg1 -m "test"，本地修改不会进入Git Tag。
• 本地修改，执行过git commit，但没执行git push到remote Server，会进入到Git Tag。

参考

• git-book
• delete-multiple-git-remote-tags-and-push-once
• 如何看待CI产生的大量Tag？
• https://stackoverflow.com/questions/10612742/will-too-many-tags-cause-any-issues-in-git
• https://softwareengineering.stackexchange.com/questions/357199/is-it-bad-practice-to-create-a-git-tag-for-every-successful-continous-deployed-b