« Table of Contents

vsts logo VSTS/Azure DevOps Integration Jira Cloud

Connecting to VSTS/Azure DevOps Jira Cloud

The Git Integration for Jira app supports Azure DevOps.

This process requires an existing Microsoft account with VSTS or Azure DevOps git projects.

  1. On your Jira Cloud dashboard menu, go to Git > Manage Git Repositories.
  2. The git configuration page for connecting repositories is displayed.
  3. On the Auto-connect integration panel, click Microsoft.
  4. On the following screen, select Visual Studio Team Services (VSTS).  If you are using Azure DevOps, select it from the list instead.  Click Next.
  5. Login to your Microsoft account, if prompted.
  6. The permissions screen is displayed.
  7. Click Accept to authorize access for Git for Jira Cloud.
  8. Repositories of the logged in Microsoft user can be automatically connected to Jira Cloud.  Repositories that are added or removed from VSTS/Azure DevOps will be likewise connected or disconnected from Jira Cloud.
  9. Click Connect.  For now, only git projects are supported from VSTS/Azure DevOps.

Configure Webhooks for VSTS/Azure DevOps

Webhooks are supported on VSTS/Azure DevOps.  You can setup a webhook via Git menu > Manage Git Repositories then click Webhooks.  Enable it to use this feature.  It will trigger immediate index of repositories but will index all of them.

Linking VSTS/Azure DevOps Git Commits to Jira Cloud

This process requires a VSTS or Azure DevOps git repository.

  1. On your web browser, login to your VSTS or Azure DevOps account then go to your working repository.
  2. Clone this repository into your Visual Studio IDE.
  3. ... or update your local repository files by performing a Pull action via VS IDE > Team Explorer.
  4. Create or modify a file from your local repository.
  5. Perform a commit of the changes via Team Explorer > Changes.
    • Enter the commit message by mentioning the Jira issue key to which this commit will be associated. (Underlined in red).
    • Click the dropdown on the Commit All button then select Commit All and Push.
  6. The commit is now displayed in the specified Jira issue.

Working with Branches and Pull Requests with VSTS/Azure DevOps Jira Cloud

This process requires a VSTS or Azure DevOps git repository AND a PAT with at least Code (read and write) scope.

  1. On your Jira Cloud, open a Jira issue.  On the Jira developer panel under Git Commits, click Create Branch.
  2. The Create Branch dialog is displayed.
    • Select a Repository from the list.
    • Choose a Base branch.
    • Enter a Branch name or leave it as is (recommended).
  3. Click Create Branch.  The newly-created branch is now listed in the developer panel under Branches.
  4. On your VS IDE, go to Team Explorer and perform a Pull action.  This will update your local repository with a new branch list.
  5. Go to Team Explorer > Branches.
  6. Under Active Repositories, expand the remote/origin folder view.
  7. Right click the new branch then select Checkout.  The new branch will be listed in the active repositories list.
  8. Make changes to a file to prepare it for commit and branch merge.
  9. On the Team Explorer, click Changes.
    • Make sure that Branch: displays the name of the newly-created branch.  If not, select it again from the list.
    • Add the Jira issue key to the commit message. (Underlined in red).
    • This will associate the commit to the mentioned Jira issue key.
    • Click the dropdown on the Commit All button then select Commit All and Push.

The commit is pushed to the new branch and is now ready for merge.

VSTS/Azure DevOps Pull Request

The pull request feature works the same as merge request.

To create a pull request and merge it to the main source (master):

  1. On your Jira Cloud, open the Jira issue where your previously created a branch.
  2. On the developer panel under Git Commits, click Create Pull Request.
  3. The Create Pull Request dialog is displayed.
    • Select Repository from the list.
    • Choose the newly-created branch as the Source branch.
    • Set master as the Target branch.
    • Enter a descriptive title or leave it as is (recommended).
  4. Click Create to create the pull request.

The pull request is listed on the developer panel of the Jira issue page.

The pull request is also ready for approval by the reviewers in your VSTS or Azure DevOps web portal.

VSTS/Azure DevOps Merging Branch to master

Continuing from the above steps, the current branch is ready for merge.

  1. On the Team Explorer, update your local repository by performing a Pull action.
  2. Go to Pull Requests.
  3. The pending pull request items are displayed here.  Pull requests requires the approval of the reviewers before it can be merged from the VS IDE.
  4. Go to Branches.  Click Merge.
  5. The following screen is displayed:
    • Set the source to the branch to which you pushed the commits.
    • Set the target branch to master.
  6. Click Merge to continue.

The reviewer's approval is required to completely merge the pull request.  This usually takes place in the VSTS or Azure DevOps portal where your updated code is being reviewed.

Once approved, the team leader or reviewer can then complete the merge.  The commit can be viewed in the associated Jira issue page.


« Table of Contents