Skip to content

Commit 211f61b

Browse files
🔧 chore(integrations): Updated Azure DevOps Dev Docs (#12231)
Co-authored-by: Alex Krawiec <[email protected]>
1 parent 042f43e commit 211f61b

File tree

7 files changed

+75
-27
lines changed

7 files changed

+75
-27
lines changed

develop-docs/integrations/azuredevops.mdx

Lines changed: 0 additions & 27 deletions
This file was deleted.
Loading
36.9 KB
Loading
Loading
Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
---
2+
title: Azure DevOps Integration
3+
sidebar_title: Azure DevOps
4+
---
5+
6+
## Create an Azure Application
7+
8+
Log into your Azure DevOps account or create a new one, and ensure you have a project set up.
9+
10+
Make sure the organization has third-party access via OAuth enabled in the organization settings.
11+
![3p-oauth](./3p-oauth.png)
12+
13+
14+
To use the Azure DevOps integration you'll need to create an application.
15+
16+
To start, you will need access to a [Microsoft Entra Admin Portal](https://entra.microsoft.com/#home)
17+
18+
![Register App](./register-app.png)
19+
20+
21+
When configuring the app, use the following values:
22+
23+
| Setting | Value |
24+
| ------------------------------- | -------------------------------------------------------------------------------------------------- |
25+
| Supported account types | Accounts in any organizational directory |
26+
| Redirect URI | `{YOUR_DOMAIN}/extensions/vsts/setup` |
27+
28+
<Note>
29+
30+
Take note of your App ID as we'll need it later.
31+
![App ID](./app-id.png)
32+
33+
</Note>
34+
35+
Next go to Manager -> API Permissions to add the following permissions:
36+
* Azure DevOps (`vso.code`, `vso.graph`, `vso.work_item`, `vso.service_endpoint`)
37+
* Microsoft Graph (`User.Read`) (This should be added by default)
38+
39+
![Permissions](./perms.png)
40+
41+
Go to the "Certificates & secrets" tab and create a new client secret. Make sure you copy the secret as we'll need it later.
42+
43+
![Client Secret](./client-secret.png)
44+
45+
Add the App ID and Client Secret to `devlocal.py` like this:
46+
47+
```python
48+
# Azure DevOps #
49+
SENTRY_OPTIONS["vsts_new.client-id"] = your-app-id
50+
SENTRY_OPTIONS["vsts_new.client-secret"] = your-client-secret
51+
```
52+
53+
You can also add the App ID and Client Secret to `config.yml` like this:
54+
55+
```yml
56+
# Azure DevOps #
57+
vsts_new.client-id: your-app-id
58+
vsts_new.client-secret: your-client-secret
59+
```
60+
61+
You will also need to enable the feature flag to use the new Azure DevOps integration.
62+
Enable the `migrate-azure-devops-integration` feature flag in your organization.
63+
Add the following to your `devlocal.py` file:
64+
65+
```python
66+
SENTRY_FEATURES["organizations:migrate-azure-devops-integration"] = True
67+
```
68+
69+
<Alert title="Feature Flag" level="info">
70+
71+
This is a temporary measure until we fully migrate to the new Azure DevOps integration and remove references to the old one.
72+
73+
</Alert>
74+
75+
Follow our [documentation on installing and configuring the Azure DevOps integration](https://docs.sentry.io/organization/integrations/source-code-mgmt/azure-devops/) to finish installation and use the integration.
Loading
Loading

0 commit comments

Comments
 (0)