blob: 6f2b3116d0d94130884d5a4bbd01db8a44597a4a [file] [log] [blame] [view]
---
title: "Azure DevOps"
sidebar_position: 5
description: Config UI instruction for Azure DevOps
---
Visit Config UI at: `http://localhost:4000`.
## Step 1 - Add Data Connections
![azuredevops-create-a-connection](images/azuredevops-create-a-connection.png)
### Connection Name
Give your connection a unique name to help you identify it in the future.
### Token
Paste your Azure DevOps personal access token (PAT) here. You can click on "Learn about how to create a PAT" to get instructions on how to create a PAT.
Make sure that the Organization field is set to "All accessible organizations" when creating the PAT.
### Test and Save Connection
Click `Test Connection`, if the connection is successful, click `Save Connection` to add the connection.
## Step 2 - Setting Data Scope
![azuredevops-set-data-scope](images/azuredevops-set-data-scope.png)
### Select repositories
Select the repositories you want to collect data from.
### Data Entities
Azure DevOps supports the following data entities.
- CI/CD: builds and jobs.
- Source Code Management: repositories and their commits.
- Code Review: pull requests and their commits.
## Step 3 - Adding Transformation Rules (Optional)
![azuredevops-set-transformation](images/azuredevops-set-transformation.png)
This set of configurations is used for calculating [DORA metrics](../DORA.md).
If you'd like to define `deployments` with Azure DevOps, you can set the following options:
- Deployment regex: Azure DevOps builds or jobs whose names match this regex will be registered as deployments
- Production: Azure DevOps builds or jobs whose names match this regex will be assigned environment 'PRODUCTION'
### Additional Settings (Optional)
The additional settings are RefDiff options:
- Tags Limit: the number of tags to compare.
- Tags Pattern: Only tags that match the given regex are taken into account.
## Troubleshooting
If you run into any problem, please check the [Troubleshooting](/Troubleshooting/Configuration.md) or [create an issue](https://github.com/apache/incubator-devlake/issues)