Git Integration for Jira Self-Managed (Data Center/Server) Documentation

Contact Support
GitKraken Status  

Features – Creating branches

Jira administrator notes

Feature note
This feature is not available to single repository connections.

Introduction

The Create branch feature offers Jira users the ability to create a git branch directly from the Jira issue.

For information about creating pull/merge requests from a Jira issue – see article Creating pull/merge request.

Advantages

When creating a branch from within Jira: 

  • Automatically populates branch name with issue key (necessary for branch  Jira issue association) and issue summary.

  • Further – default branch naming conventions can be customized to match your development workflow.
    For example: ${issuetype:New Issue,new,Bug Fix,bug}/${issuekey}-${summary} generates "bug/PRJ-123-add-more-logging" (See General settings for more information).

  • Require each Jira user to provide their Personal Access Token for creating branches. This option adds some friction to creating branches/pull requests but enabling this setting will enforce the git server user permissions as well as give better attribution for the actions. For more information, see Require Personal Access Tokens for user actions (create branch/pull request) for more information.

Supported platforms

  • Full feature (Auto-Connect) integrations:

    • GitHub

    • GitLab

    • AWS CodeCommit

    • Azure DevOps

    • Microsoft Visual Studio Team Services (VSTS)

    • Microsoft Team Foundation Server (TFS)

Steps to creating a git branch in Jira

  1. Prerequisite: Jira administrator configures a a full feature integration (auto-connect) via Add new integration panel in the Git Integration for Jira Data Center app. See Integration Guides for more information.

  2. To access the Create branch action, do one of the following:

    1. Open/expand the Git Development panel.

    2. If not visible or displayed, enable in General settings.

  3. Click Create branch in one of the panels from step 2.

  4. Select git repository. Use the search box to look for the specific name of the repository that will be used.

  5. If a personal access token is required (and not yet provided) – follow on screen instructions to provide a personal access token with correct permissions for selected repository.

  6. Select base branch.

  7. Verify branch name is correct. Edit as desired.
    Note: The Jira issue key must remain in the branch name to create the branch  Jira issue association.

  8. Click Create branch.

Video: Creating branch via Git Development panel ( UPDATED VIDEO COMING SOON )

Right click here to open this video in a new tab/window for more viewing options.

The video shows Git Integration for Jira Cloud process but is also applicable to the Jira Server version.

If you still have a question – reach out to our Support Desk or email us at [email protected].

Have feedback about this article? Did we miss something? Let us know!
On this page