« Table of Contents

Git Tags

Git tags identify specific release versions of your code in a particular branch and do not change when the branch moves on.  A tag is an alias for a commit hash, much like symbolic names for a given revision.  It is typically used to mark a particular point in the commit.  It is like a branch with a read-only attribute.  The git tags are accessible in the developer panel.

The git tags refers to merged, released work.

v2.8.0+  The Git Integration for Jira app supports both lightweight and annotated tags.  The tags are loaded separately from the rest of the Git Source Code.

Having more than one tag with the same name across different branches can become difficult to maintain.

Tags cannot be moved since it is linked to a specific commit and are not pushed by default. 

Create a branch to start working from it if a tag is checked out.

The Git for Jira app supports two types of git tags:

  • lightweight  –  shows only the commit object
  • annotated  –  shows the message, author and the tag object followed by the commit

A lightweight tag can be use for marking a version or some specific commits that you will need to use later on  —  like a temporary object label.  It does not contain extra information.

Annotated tags can contain a message, author and date different than the commit that they are pointing to  —  like describing a release without making a release commit.

The git tag is displayed on the right sidebar if it is enabled in the General Settings of the Git Integration app > Calculate and show Git tags in Git Source Code panel.

This feature is disabled by default for existing customers and is automatically enabled for new customers.

The Git for Jira app will show the most recent tags if no filter is set.  If the filter is set, the Git for Jira app will use it and will display the tags sorted in ascending order by date.

If there are several git tags listed, click the more... label link to expand the list in increments of five tags.

If loading of tags on a Jira issue takes longer than 60 seconds, the Git Integration app will notify the user about it and aborts the operation. This could happen if the Jira issue contains several hundreds of git tags or more.
Git tags and branches are cached for the most recently viewed 1000 Jira issues (across all Jira projects).  The cache is reset each time a new change in any repository is detected.  The cache is built the first time an issue with a tag and/or branch is loaded by a user.  Thus, subsequent loading of Jira issues with tag or branch information will utilize cached values.
The tag calculation timeout is 86400 seconds.

Move the mouse pointer over the tag to display the following tooltip information:

  • Repository Name
  • Date / Time
  • Commit author name and email address (if available)
  • Message (if any)

« Table of Contents