Setup Azure DevOps Discovery
Overview
This step will guide you through the process of setting up Azure DevOps Discovery to automatically find all your catalog-info.yaml files for you.
Step Checklist
This is the second (2) step in this guide, once completed you can move onto the next step.
- Setup the Azure integration in App Settings
- Setup Azure DevOps Discovery
- Install the Azure DevOps Annotator Processor
- Install the Azure DevOps plugin
- Install the Azure DevOps scaffolder actions
- Install the Azure DevOps Wiki collator
Walkthrough
Here's how to enable Azure DevOps Discovery:
- Navigate to Catalog Settings
- Then click the Ingest button on the Azure DevOps card
- Now in the new screen that appears click on the 2nd "+ Add Item" button
- Then provide a Key name, your Azure DevOps Organization name works well for this
- For host enter
dev.azure.com - Then for organization enter your Azure DevOps Organization name
- For project you can list a single project but the more common approach is to use
*as that will include all your Projects in the provided Organization - You can provide the optional repository and path fields but the default are best for getting started
- Next we will provide a frequency, for initial setup we recommend using a short 10 minute frequency, long term a longer 12 hours or 1 day frequency is best
- Then for timeout use 15 or 30 minutes
- You can skip the optional
initialDelayand scope fields, their default are sound - You can now click the Save button in the bottom right to save the configuration you've just set up
- In the top right you'll see a pulsing message "Applying new configuration..." as the settings get saved
- The message will then change to "New configuration applied successfully." with a Reload button, click it to reload the configuration
- Portal is now configured to discovery your
catalog-info.yamlfiles for you!
From here you can now move on to Step 3 where you'll Install the Azure DevOps Annotator Processor to automatically add helpful annotations to your entities.