Connect Azure DevOps repositories to Catalog with the Konnect UI

Uses: Catalog

Incompatible with

on-prem

Prerequisites

Kong Konnect

If you don’t have a Konnect account, you can get started quickly with our onboarding wizard.

The following Konnect items are required to complete this tutorial:
- Personal access token (PAT): Create a new personal access token by opening the Konnect PAT page and selecting Generate Token.
Set the personal access token as an environment variable:
```
export KONNECT_TOKEN='YOUR KONNECT TOKEN'
```
Copied!

Konnect roles

You need the Integration Admin role in Konnect to install and authorize Catalog integrations.

Create and configure an Azure account

You need to configure the following in Azure DevOps:

An Azure DevOps account.
An Azure DevOps personal access token (PAT) with Code: Read permission.

Your PAT can be created with an expiration period of your choice, up to a maximum of one year. Make sure to renew the PAT before it expires to avoid interruptions.

Configure the Azure DevOps integration

Before you can discover Azure DevOps repositories in Catalog, you must configure the integration:

In the Konnect sidebar, click Catalog.
In the Catalog sidebar, click Integrations.
Click Azure DevOps.
Click Add Azure DevOps instance.
In the Azure DevOps organization name field, enter your organization name exactly as it appears in Azure DevOps.
In the Azure DevOps personal access token (PAT) field, enter your Azure DevOps token.
In the Display name field, enter azure-devops-repository-service.
In the Instance name field, enter azure-devops-repository-service.
(Optional) In the Description field, enter a description for this instance.
Click Save.

If you don’t immediately see resources, try manually syncing your Azure DevOps integration. From the Konnect UI, navigate to the Azure DevOps integration that you just installed. Then, from the Actions dropdown menu, select Sync Now.

Create a Catalog service and map the Azure DevOps resources

After you configure the Azure DevOps integration, create a service in Catalog and map an Azure DevOps repository resource to it.

In this tutorial, we’ll refer to your Azure DevOps repository as azure-devops-repository.

In the Konnect sidebar, click Catalog.
In the Catalog sidebar, click Services.
Click New service.
In the Display Name field, enter azure-devops-repository-service.
Click Create.
Click Map Resources.
Select the azure-devops-repository checkbox.
Click Map 1 Resource.

Validate the mapping

To confirm that the Azure DevOps resource is now mapped to the intended service, navigate to the new service:

In the Konnect sidebar, click Catalog.
In the Catalog sidebar, click Services.
Click the azure-devops-repository-service service.
Click the Resources tab.

You’ll see the azure-devops-repository-service resource listed.