Azure DevOps (VSTS) Setup

Updated 5 days ago by Jaala

At GitPrime, we want to support systems of all stripes, so teams can measure and understand the development lifecycle using the processes that work best for them.That’s why we’re excited to announce that we’ve built an integration with Azure DevOps that provides the same level of visibility we offer for any other Git host. Here’s what’s included and how to get setup.

Overview

Below is a step-by-step guide on how to connect your Microsoft Azure DevOps to GitPrime.

Before you get started

Before you get started, please make sure that your system is supported. You are supported if:

  • You Azure DevOps Services (i.e. HOSTED at Microsoft, not on-prem)
  • You use git repos (TFVC repos are not supported and are not expected to be supported)

Azure DevOps Configuration

Step 1: In order to connect your Azure DevOps account, you will need to first create a new Integration. Starting on your GitPrime Home page go to the left navigation bar. At the bottom go to Settings > Integrations.

Step 2: Select the Add Integration button in the top right hand corner of you Integrations screen.

Step 3: On the following page select Azure DevOps

Step 4: On this page you will need to input the following information:

  • Email - Email associated with the service account.
This field is case sensitive. Use the exact email format seen in your Azure user profile.
  • Personal Access Token (see below)
  • Base URL - https://dev.azure.com/{yourorganization} 
Even if your base URL in Azure Devops uses the visualstudios.com domain, you will need to use the https://dev.azure.com domain in the "Base URL" field in GitPrime for the connection to be successful.
Creating a Personal Access Token

To create a personal access token in Azure DevOps follow the instructions below. 

Step 1: Locate Security under your gravatar menu.

Step 2: On the Personal access token page click New Token.

Step 3: Fill in the following information for your new personal access token:

  • Name
  • Organization 
  • Expiration date
  • Scopes - Below find the minimum scopes required to connect your account.
    • Code:Read
    • Graph: Read
    • Identity: Read
    • Project and Team: Read
    • Work Items: Read
Admin permissions withing Azure will be required to ensure all integration services (specifically webhooks) work properly.

Step 4: Click Save.

Finalizing the Connection

Now that you have created a personal access token you can complete your Integration setup in GitPrime. 

Step 1: Copy your access token and paste it into the GitPrime Personal Access Token field. 

Step 2: Click Test connection

Step 3: If the connection was successful you will see the following message:

If you receive an “Authorization denied” error when trying to connect your Azure DevOps account verify access token and try again.

If you receive “An error has occurred” error verify that the email and base URL are correct and try again. 

Step 4: Once you have successfully connected to your Azure DevOps account, click Next.

Step 5: On the next screen you will be selecting the services you want turned on for this Integration. If you would like to import pull request data in addition to repo data, then leave all services on. You can turn services “on” and “off” at any time. Click Next.

Step 6: Name your Integration so you can identify the account you connected with. Click Create.

Step 7: You have successfully created a new Azure Devops Integration.

Step 8: You can begin to import your repos by going to your repo import page. Click repo import page. To learn more about managing your new Integration settings, see Managing Integrations.

Still having issues connecting your Azure Devops account? Email us at support@gitprime.com or click on the chat icon in the bottom right corner of your screen.


How did we do?