Git tag

External

• https://git-scm.com/book/en/v2/Git-Basics-Tagging

Internal

• Git Commands - Local Repository Information
• Git Commands - Local Repository Manipulation

Overview

Create, list, delete or verify a tag object. To check out the commit associated with a specific tag into a detached HEAD, see git checkout.

By default, tags are not pushed to remote server.

Ensuring All Tags Are Accessible from the Local Workarea

To make sure all the tags are accessible from the local workarea, run:

git fetch --all --tags

If tags are not explicitly fetched, you may run in the following situation even after running git fetch without other arguments.

git checkout my-tag
error: pathspec 'my-tag' did not match any file(s) known to git

List Tags

Tags can be listed based on a given pattern. All tags are listed if no pattern is given.

git tag [-l] [name-pattern]

git tag

git tag -l

Display the Commit a Tag Points To

git rev-list -n 1 <tag-value>

Also see:

git rev-list

Create a Tag

git tag '<tag-name>'

Pushing a Tag to a Remote Server

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 <tagname>

git push origin release-1.2.1

Pushing All Tags

git push origin --tags

Alternatively:

git push --follow-tags

or set "push.followTags" to do this automatically on each push.

Remove a Tag

Remove a Tag Locally

git tag -d <tag-name>

Remove a Tag Remotely

If tag was pushed to a remote repository and now it should be removed, deleting it locally and then push --follow-tags is NOT sufficient.

You need to remove it locally, then:

git push origin :refs/tags/<tag-name-to-remove>