title | publishedDate | description | humanName | logoImage | integrationType |
---|---|---|---|---|---|
Integrating with Azure DevOps |
2022-11-09T16:20:00.0Z |
How to configure Roadie to read entities from Azure DevOps |
Azure DevOps |
../../../assets/logos/azure-devops/Azure-DevOps-logo.png |
Catalog data source |
Azure DevOps is a popular alternative to GitHub as an SCM provider.
This guide describes how to set up access for Roadie to your Azure DevOps repositories and retrieve relevant entities from that source.
Azure discovery is driven by the Code Search feature in Azure DevOps, this may not be enabled by default. For Azure DevOps Services you can confirm this by looking at the installed extensions in your Organization Settings.
If the Code Search extension is not listed then you can install it from the Visual Studio Marketplace.
In your Azure DevOps navigate to the User Settings > Tokens page in https://dev.azure.com/<your-organization>/_usersSettings/tokens
. Within this page you can generate a token to grant Roadie access to read your entity manifest files.
- Click 'New Token'
- Create an access token with at least repository Read permissions.
Navigate to https://<your-tenant>.roadie.so/administration/settings/secrets
and locate a secret with a name AZURE_TOKEN
. Update the value of this secret with the token created in the step above.
The updating of secrets within the Roadie application takes a few minutes. You will see the status of the secret change when it becomes available.
Navigate to https://<your-tenant>.roadie.so/administration/settings/integrations/azure
.
Add a provider configuration pointing to your entities within your Azure DevOps organization and project. The updating of provider configurations within the Roadie application takes a few minutes. When the update cycle is complete, you should be able to find your discovered entities in the catalog and the locations log.