Listing the existing tags in Git is straightforward. Just type git tag (with optional -l or --list):
$ git tag
v1.0
v2.0
This command lists the tags in alphabetical order; the order in which they are displayed has no real importance.
2. Creating Annotated Tags
$ git tag -a v1.4 -m "my version 1.4"
$ git tag
v0.1
v1.3
v1.4
You can see the tag data along with the commit that was tagged by using the git show command:
$ git show v1.4
tag v1.4
Tagger: Ben Straub <ben@straub.cc>
Date: Sat May 3 20:19:12 2014 -0700
my version 1.4
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <schacon@gee-mail.com>
Date: Mon Mar 17 21:52:11 2008 -0700
Change version number
That shows the tagger information, the date the commit was tagged, and the annotation message before showing the commit information.
3. Sharing (Pushing) Tags
By default, the git push command doesn’t transfer tags to remote servers. You will have to explicitly push tags to a shared server after you have created them. This process is just like sharing remote branches — you can run git push origin <tagname>.
$ git push origin v1.5
Counting objects: 14, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (12/12), done.
Writing objects: 100% (14/14), 2.05 KiB | 0 bytes/s, done.
Total 14 (delta 3), reused 0 (delta 0)
To git@github.com:schacon/simplegit.git
* [new tag] v1.5 -> v1.5
If you have a lot of tags that you want to push up at once, you can also use the --tags option to the git push command. This will transfer all of your tags to the remote server that are not already there.
1. Listing Your Tags
Listing the existing tags in Git is straightforward. Just type git tag (with optional -l or --list):
This command lists the tags in alphabetical order; the order in which they are displayed has no real importance.
2. Creating Annotated Tags
You can see the tag data along with the commit that was tagged by using the git show command:
3. Sharing (Pushing) Tags
By default, the
git pushcommand doesn’t transfer tags to remote servers. You will have to explicitly push tags to a shared server after you have created them. This process is just like sharing remote branches — you can rungit push origin <tagname>.If you have a lot of tags that you want to push up at once, you can also use the
--tagsoption to the git push command. This will transfer all of your tags to the remote server that are not already there.Now, when someone else clones or pulls from your repository, they will get all your tags as well.
Note:
git push pushes both types of tags
will push both lightweight and annotated tags. There is currently no option to push only lightweight tags, but if you use
only annotated tags will be pushed to the remote.