Azure DevOps deployment guides

Practical walkthroughs for Azure Boards, Azure Repos, and Azure Pipelines teams that deploy feature branches to QA, staging, and UAT.

Start here

Deploy an Azure Pipeline from a work item How to queue an Azure Pipeline directly from an Azure Boards work item using BranchDeploy or the manual method. Deploy a specific Azure Repos branch with Azure Pipelines Options for deploying a particular Azure Repos branch to staging, UAT, QA, or preview environments. Azure DevOps UAT deployment workflow A practical UAT workflow using Azure Boards work items, Azure Repos branches, Azure Pipelines, and BranchDeploy.

Pipeline setup and configuration

Find an Azure Pipeline ID How to find the pipeline ID BranchDeploy needs and avoid copying a run ID, release ID, or build number by mistake. Azure Pipelines queue-time variables and parameters How queue-time variables differ from YAML runtime parameters, and how to pass deployment context into a pipeline run. Branch allowlist patterns for Azure DevOps deployments Practical BranchDeploy branch allowlist patterns for feature branches, bugfixes, releases, and full refs. Fix Azure DevOps queue build permissions Troubleshoot queue-build permission errors for manual pipeline runs and work item deployments.

Azure Boards links and PRs

Link a work item to a branch or pull request How Azure Boards work items connect to Azure Repos branches and PRs, and why those links matter for deployments. Azure Boards Development links explained What Development links are, how they connect work items to branches, commits, and PRs, and how they support traceability. Deploy a pull request source branch with Azure Pipelines How to deploy the feature branch behind an Azure Repos PR instead of accidentally deploying the target branch. Fix no linked branch found in Azure DevOps A troubleshooting checklist for work items that do not have a usable linked branch or PR.

Troubleshooting

Why Azure Pipelines manual runs deploy the wrong branch How to diagnose source-branch mistakes, PR target/source confusion, skipped stages, and branch-copy errors.

Next steps

Set up BranchDeploy Manual Azure Pipeline runs vs BranchDeploy Deploy from Azure Boards Security and permissions

Install Free forever for one project.

Ready to deploy?

Install BranchDeploy from the Marketplace, open Project Settings, add your pipeline ID, and deploy from a work item in minutes.

$ az devops extension install --extension-id branchdeploy --publisher-id PixelFunnelLtd

Requirements

Azure Repos + Azure Pipelines.
Permission to queue the pipeline.
No BranchDeploy account needed (Free).

Setup

Install the extension.
Open Project Settings → BranchDeploy.
Enter your pipeline ID and save.

Free tier

One project, one environment.
Queues as your Azure DevOps session.
Completely free, forever.

Pro

Multiple projects and environments.
90-day audit log.
Branch allowlists per environment.
Teams bot
AI assistant (MCP)

// No clipboard. No tab switching. No branch-name guesswork.