Skip to main content

Azure DevOps Plugin

Without this plugin, Azure Pipelines builds and Pull Requests are tracked only in Azure DevOps — a service registered in the portal has no operational visibility from it. Enable the plugin, add dev.azure.com/project-repo to the entity, and the entity gains both a CI tab (Pipelines build history) and a Pull Requests tab. The portal becomes the entry point for CI and code review workflows, not Azure DevOps.

The Azure DevOps plugin displays Azure Pipelines builds and Azure Pull Requests in catalog entity pages.

Status: Preloaded in the DevPortal image, disabled by default. Enable via dynamic-plugins.yaml or Marketplace.

Package​

backstage-community-plugin-azure-devops-dynamic

What it does​

  • CI tab: Shows Azure Pipelines build results via EntityAzurePipelinesContent
  • Pull Requests tab: Shows open Azure PRs via EntityAzurePullRequestsContent
  • Both components only render when isAzureDevOpsAvailable is true (i.e., the required annotation is present)

Enabling the plugin​

plugins:
  - package: ./dynamic-plugins/dist/backstage-community-plugin-azure-devops-dynamic
    disabled: false
    pluginConfig:
      dynamicPlugins:
        frontend:
          backstage-community.plugin-azure-devops:
            mountPoints:
              - mountPoint: entity.page.ci/cards
                importName: EntityAzurePipelinesContent
                config:
                  layout:
                    gridColumn: "1 / -1"
                  if:
                    allOf:
                      - isAzureDevOpsAvailable
              - mountPoint: entity.page.pull-requests/cards
                importName: EntityAzurePullRequestsContent
                config:
                  layout:
                    gridColumn: "1 / -1"
                  if:
                    allOf:
                      - isAzureDevOpsAvailable

App configuration​

azureDevOps:
  host: dev.azure.com
  token: ${AZURE_TOKEN}
  organization: ${AZURE_ORGANIZATION}

Required annotation​

metadata:
  annotations:
    dev.azure.com/project-repo: my-project/my-repo