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.

Starting v2.8.0, the Git Integration for Jira add-on supports both lightweight and annotated tags.  The tags are loaded separately from the rest of the Git Source Code.

note
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. 

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

The Git add-on 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 add-on.  This feature is disabled by default for existing customers and is automatically enabled for new customers.

Git tags in Code Dev panel - right sidebar

The Git add-on will show the most recent tags if no filter is set.  If the filter is set, the Git add-on 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.

note
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 utilized cached values.

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)
Git tag tooltip