Catalog: Azure DevOps Integration

[TuannasCodeCatastrophe]

Description

Definition of done
todo @cloudjumpercat seeing if there's a bigger use case with scorecards
API and UI how tos (ex. https://developer.konghq.com/how-to/monitor-dynatrace-slos-with-konnect-api/ and https://developer.konghq.com/how-to/monitor-dynatrace-slos-with-konnect-ui/)
New integration reference (ex. https://developer.konghq.com/catalog/integrations/dynatrace/)
Add Azure DevOps tile to https://developer.konghq.com/catalog/integrations/
Notes:
Ingesting repositories "Repos" (which are a subset of projects)
Org name MUST match what's in DevOps exactly (need to test/research if spaces/capital letters are allowed)
PAT expires in a year and they will have to renew it (this applies to SwaggerHub and others, so update those too), PAT needs the Code: Read permission
Important

This is a Konnect release PR and should be handed off to the PM to merge with the release once complete. Make sure you follow the Konnect release checklist.

Information
Aha: https://konghq.aha.io/epics/KSC-E-33
DRP: Miko B.
Info about testing/setup in slack thread: https://kongstrong.slack.com/archives/C09ND85GCVB/p1762830649798549?thread_ts=1762830537.927639&cid=C09ND85GCVB

Due date (optional)
internal Dec 1st
Ga on Dec 8th

Size
Medium

Fixes #3335

Preview Links

• PR: Catalog: Azure DevOps Integration #3647
• Tile: https://deploy-preview-3647--kongdeveloper.netlify.app/catalog/integrations/
• API How-to: https://deploy-preview-3647--kongdeveloper.netlify.app/how-to/connect-azure-devops-to-the-konnect-catalog-with-the-konnect-api/
• UI How-to: https://deploy-preview-3647--kongdeveloper.netlify.app/how-to/connect-azure-devops-to-the-konnect-catalog-with-the-konnect-ui/
• Reference: https://deploy-preview-3647--kongdeveloper.netlify.app/catalog/integrations/azure-devops/

Checklist

• Tested how-to docs. If not, note why here.
• All pages contain metadata.
• Any new docs link to existing docs.
• All autogenerated instructions render correctly (API, decK, Konnect, Kong Manager).
• Style guide (capitalized gateway entities, placeholder URLs) implemented correctly.
• Every page has a description entry in frontmatter.
• Add new pages to the product documentation index (if applicable).

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 2 committers have signed the CLA.

✅ jharmn
❌ TuannasCodeCatastrophe

---

TuannasCodeCatastrophe seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[netlify]

✅ Deploy Preview for kongdeveloper ready!

Name	Link
🔨 Latest commit	42c46da
🔍 Latest deploy log	https://app.netlify.com/projects/kongdeveloper/deploys/694034d4f3707900085c78d0
😎 Deploy Preview	https://deploy-preview-3647--kongdeveloper.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[TuannasCodeCatastrophe]

Waiting on icon - everything else ready. Request sent for icon.

[Guaris]

@TuannasCodeCatastrophe Could we please add preview links to the PR?

[Guaris]

@TuannasCodeCatastrophe You can make this pass by turning vale off on the konnect_api_requests, like this:

<!--vale off-->
{% konnect_api_request %}
url: /v3/apis/$API_ID/versions
status_code: 201
method: POST
body:
    version: 1.0.0
    spec:
        content: '{"openapi":"3.0.3","info":{"title":"Example API","version":"1.0.0"},"paths":{"/example":{"get":{"summary":"Example endpoint","responses":{"200":{"description":"Successful response"}}}}}}'
{% endkonnect_api_request %}
<!--vale on-->

[Guaris]

The API instructions worked for me after changing the environment variable, the UI instructions did not. Run through the doc one more time, and make sure everything works from top to bottom. UI and API. There may have been changes since you wrote it that need to be accounted for.

[Guaris]

For the UI doc:

• Change the Tl;DR so that its more clear what the doc is actually doing
• Rename the azure-devops-api variable to something like azure-devops-repository
• In step 2, add a sentence that explains what it is you are actually adding (If relevant add this to the API doc as well)
• Run through both the UI and API docs again, by yourself, and make sure that the workflow is working from top-to-bottom as expected.

[Guaris]

This is missing, you have to add to the front matter the bindeable entities. @TuannasCodeCatastrophe

bindable_entities: "Repositories"

[TuannasCodeCatastrophe]

@DaniellaFreese This is ready for you