Integrating Azure DevOps with Sleuth is simple. If you're connecting to a personal Azure DevOps repo, you just need your credentials. If you're part of an organization and aren't the owner, you will need permission to allow Sleuth to connect to the repo—after you connect you'll be able to select individual private or public repositories.
The integration is best tested against Azure DevOps Services, however, it should work for Azure DevOps Server as well. Which is which?
- Azure DevOps Services (formerly known as Visual Studio Team Services, or VSTS_)_ is a cloud-based solution
- Azure DevOps Server (formerly known as Team Foundation Server, or TFS) is an on-premises offering
To set up the Azure DevOps integration:
- 1.Click Integrations in the left sidebar, then click Change Sources.
- 2.In the Azure DevOps tile, click enable.
- 3.You must grant Sleuth access to your Azure DevOps account. Don't worry, you'll select the Azure DevOps repo to connect to your Sleuth project later.
- 4.In a separate browser tab or window, visit your Azure DevOps account, and under User settings, click on Personal Access Tokens and generate a token with the required scopes. The Work Items and Build scopes are only necessary if you want to configure issue and build integration. Paste this token into the Sleuth form.
- 5.On successful integration, Azure DevOps enabled will be displayed in the Azure DevOps tile. You'll next configure the code deployment to connect your repo to a project.
If you using Azure DevOps on-premise behind Cloudflare access or similar, Sleuth might need to include some HTTP headers in order to reach your instance. In order to set Sleuth to send any custom HTTP headers when making requests:
- 1.In the Azure DevOps dialog, click on the Advanced setting
- 2.Enter comma separated list of custom headers you want Sleuth to include
- 1.Click on Integrations in the left sidebar, then on Change Sources.
- 2.In the Azure DevOps integration card, click disable.
The Azure DevOps integration is disconnected and no longer available to any projects within that organization.