前面的话
发布一个版本时,我们通常先在版本库中打一个标签(tag)。这样,就唯一确定了打标签时刻的版本。将来无论什么时候,取某个标签的版本,就是把那个打标签的时刻的历史版本取出来。所以,标签也是版本库的一个快照,实质上它就是指向某个commit的指针。所以,创建和删除标签都是瞬间完成的。简而言之,标签tag就是一个让人容易记住的有意义的名字,它跟某个commit绑在一起。本文将详细介绍Git标签管理
创建标签
在Git中打标签非常简单,首先,切换到需要打标签的分支上
然后,敲命令git tag
可以用命令git tag查看所有标签
默认标签是打在最新提交的commit上的。有时候,如果忘了打标签怎么办呢?方法是找到历史提交的commit id,然后打上就可以了
比方说要对create b.txt这次提交打标签,它对应的commit id是7ec9296,敲入命令:
再用命令git tag查看标签,注意,标签不是按时间顺序列出,而是按字母排序的
可以用git show
附注标签
实际上,Git使用的标签有两种类型:轻量级的(lightweight)和含附注的(annotated)。上面介绍的就是轻量级标签,轻量级标签就像是个不会变化的分支,实际上它就是个指向特定提交对象的引用。而含附注标签,实际上是存储在仓库中的一个独立对象,它有自身的校验和信息,包含着标签的名字,电子邮件地址和日期,以及标签说明,标签本身也允许使用GNU Privacy Guard(GPG)来签署或验证。一般我们都建议使用含附注型的标签,以便保留相关信息;当然,如果只是临时性加注标签,或者不需要旁注额外信息,用轻量级标签也没问题
创建一个含附注类型的标签非常简单,用-a(取annotated的首字母,中文意思为注释)指定标签名字即可,而-m选项则指定了对应的标签说明,Git会将此说明一同保存在标签对象中。如果没有给出该选项,Git会启动文本编辑软件供你输入标签说明
$ git tag -a v1.4 -m 'my version 1.4'
我们可以看到在提交对象信息上面,列出了此标签的提交者和提交时间,以及相应的标签说明
签署标签
如果有自己的私钥,还可以用GPG来签署标签,只需要把之前的-a改为-s(取signed的首字母,中文意思为有符号的)即可
$ git tag -s v0.2 -m 'signed version 0.2 released'
签名采用PGP签名,因此,必须首先安装gpg(GnuPG),如果没有找到gpg,或者没有gpg密钥对,就会报错
现在再运行 git show 会看到对应的 GPG 签名也附在其内
$ git show v0.2
tag v0.2
Tagger: Michael Liao
Date: Mon Aug 26 07:28:33 2013 +0800
signed version 0.2 released
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (Darwin)
iQEcBAABAgAGBQJSGpMhAAoJEPUxHyDAhBpT4QQIAKeHfR3bo...
-----END PGP SIGNATURE-----
commit fec145accd63cdc9ed95a2f557ea0658a2a6537f
Author: Michael Liao
Date: Thu Aug 22 10:37:30 2013 +0800
branchtest
用PGP签名的标签是不可伪造的,因为可以验证PGP签名
可以使用git tag -v [tagname] (取verify的首字母,中文意思为核实)的方式验证已经签署的标签。此命令会调用GPG来验证签名,所以你需要有签署者的公钥,存放在keyring中,才能验证
$ git tag -vv1.4.2.1
object 883653babd8ee7ea23e6a5c392bb739348b1eb61
typecommit
tag v1.4.2.1
tagger Junio C Hamano
GIT 1.4.2.1
Minor fixes since 1.4.2, including git-mvand git-http with alternates.
gpg: Signature made Wed Sep 13 02:08:25 2006 PDT using DSA key ID F3119B9A
gpg: Good signature from"Junio C Hamano
gpg: aka"[jpeg image of size 1513]"
Primary key fingerprint: 3565 2A26 2040 E066 C9A7 4A7D C0C6 D9A4 F311 9B9A
若是没有签署者的公钥,会报告类似下面这样的错误:
gpg: Signature made Wed Sep 13 02:08:25 2006 PDT using DSA key ID F3119B9A
gpg: Can't check signature: public key not found
error: could not verify the tag'v1.4.2.1'
操作标签
如果标签打错了,也可以删除
$ git tag -d
因为创建的标签都只存储在本地,不会自动推送到远程。所以,打错的标签可以在本地安全删除。
默认情况下,git push并不会把标签传送到远端服务器上,只有通过显式命令才能推送标签到远端仓库
$ git push origin
或者,一次性推送全部尚未推送到远程的本地标签
$ git push origin --tags
如果标签已经推送到远程,要删除远程标签就麻烦一点,先从本地删除
然后,从远程删除。删除命令也是push,但是格式如下
最后一个问题,如何查看发送到远程的标签呢?
点击Github项目中的release
即可看到远程标签的信息