天天看點

Git -- 标簽管理

釋出一個版本時,我們通常先在版本庫中打一個标簽,這樣,就唯一确定了打标簽時刻的版本。将來無論什麼時候,取某個标簽的版本,就是把那個打标簽的時刻的曆史版本取出來。是以,标簽也是版本庫的一個快照。

Git的标簽雖然是版本庫的快照,但其實它就是指向某個commit的指針(跟分支很像對不對?但是分支可以移動,标簽不能移動),是以,建立和删除标簽都是瞬間完成的。

建立标簽

在Git中打标簽非常簡單,

首先,切換到需要打标簽的分支上:

$ git branch
* dev
  master
$ git checkout master
Switched to branch 'master'      

然後,敲指令

git tag <name>

就可以打一個新标簽:

$ git tag v1.0      

可以用指令

git tag

檢視所有标簽:

$ git tag
v1.0      

預設标簽是打在最新送出的commit上的。有時候,如果忘了打标簽,比如,現在已經是周五了,但應該在周一打的标簽沒有打,怎麼辦?

方法是找到曆史送出的commit id,然後打上就可以了:

$ git log --pretty=oneline --abbrev-commit
6a5819e merged bug fix 101
cc17032 fix bug 101
7825a50 merge with no-ff
6224937 add merge
59bc1cb conflict fixed
400b400 & simple
75a857c AND simple
fec145a branch test
d17efd8 remove test.txt
...      

比方說要對

add merge

這次送出打标簽,它對應的commit id是

6224937

,敲入指令:

$ git tag v0.9 6224937      

再用指令

git tag

檢視标簽:

$ git tag
v0.9
v1.0      

注意,标簽不是按時間順序列出,而是按字母排序的。可以用

git show <tagname>

檢視标簽資訊:

$ git show v0.9
commit 622493706ab447b6bb37e4e2a2f276a20fed2ab4
Author: Michael Liao <[email protected]>
Date:   Thu Aug 22 11:22:08 2013 +0800

    add merge
...      

可以看到,

v0.9

确實打在

add merge

這次送出上。

還可以建立帶有說明的标簽,用

-a

指定标簽名,

-m

指定說明文字:

$ git tag -a v0.1 -m "version 0.1 released" 3628164      

用指令

git show <tagname>

可以看到說明文字:

$ git show v0.1
tag v0.1
Tagger: Michael Liao <[email protected]>
Date:   Mon Aug 26 07:28:11 2013 +0800

version 0.1 released

commit 3628164fb26d48395383f8f31179f24e0882e1e0
Author: Michael Liao <[email protected]>
Date:   Tue Aug 20 15:11:49 2013 +0800

    append GPL      

還可以通過

-s

用私鑰簽名一個标簽:

$ git tag -s v0.2 -m "signed version 0.2 released" fec145a      

簽名采用PGP簽名,是以,必須首先安裝gpg(GnuPG),如果沒有找到gpg,或者沒有gpg密鑰對,就會報錯:

gpg: signing failed: secret key not available
error: gpg failed to sign the data
error: unable to sign the tag      

如果報錯,請參考GnuPG幫助文檔配置Key。

git show <tagname>

可以看到PGP簽名資訊:

$ git show v0.2
tag v0.2
Tagger: Michael Liao <[email protected]>
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 <[email protected]>
Date:   Thu Aug 22 10:37:30 2013 +0800

    branch test      

用PGP簽名的标簽是不可僞造的,因為可以驗證PGP簽名。驗證簽名的方法比較複雜,這裡就不介紹了。

小結

  • 指令

    git tag <name>

    用于建立一個标簽,預設為

    HEAD

    ,也可以指定一個commit id;
  • git tag -a <tagname> -m "blablabla..."

    可以指定标簽資訊;
  • git tag -s <tagname> -m "blablabla..."

    可以用PGP簽名标簽;
  • git tag

    可以檢視所有标簽。

操作标簽

如果标簽打錯了,也可以删除:

$ git tag -d v0.1
Deleted tag 'v0.1' (was e078af9)      

因為建立的标簽都隻存儲在本地,不會自動推送到遠端。是以,打錯的标簽可以在本地安全删除。

如果要推送某個标簽到遠端,使用指令

git push origin <tagname>

$ git push origin v1.0
Total 0 (delta 0), reused 0 (delta 0)
To [email protected]:michaelliao/learngit.git
 * [new tag]         v1.0 -> v1.0      

或者,一次性推送全部尚未推送到遠端的本地标簽:

$ git push origin --tags
Counting objects: 1, done.
Writing objects: 100% (1/1), 554 bytes, done.
Total 1 (delta 0), reused 0 (delta 0)
To [email protected]:michaelliao/learngit.git
 * [new tag]         v0.2 -> v0.2
 * [new tag]         v0.9 -> v0.9      

如果标簽已經推送到遠端,要删除遠端标簽就麻煩一點,先從本地删除:

$ git tag -d v0.9
Deleted tag 'v0.9' (was 6224937)      

然後,從遠端删除。删除指令也是push,但是格式如下:

$ git push origin :refs/tags/v0.9
To [email protected]:michaelliao/learngit.git
 - [deleted]         v0.9      

要看看是否真的從遠端庫删除了标簽,可以登陸GitHub檢視。

  • git push origin <tagname>

    可以推送一個本地标簽;
  • git push origin --tags

    可以推送全部未推送過的本地标簽;
  • git tag -d <tagname>

    可以删除一個本地标簽;
  • git push origin :refs/tags/<tagname>

    可以删除一個遠端标簽。

摘錄自:http://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000