Azure DevOps deployment guides

Practical walkthroughs for Azure Boards, Azure Repos, and Azure Pipelines teams that deploy feature branches to QA, staging, and UAT — and tell their customers what shipped afterwards.

Start here

Deploy an Azure Repos branch from an Azure Boards work item Step by step from linked branch to queued pipeline run: link the branch, prepare the pipeline, and deploy from the ticket. 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. Run an Azure Pipeline from an Azure Boards work item Manual runs, the CLI and REST API, service hooks, and a work item deploy button compared. Azure DevOps UAT deployment workflow A practical UAT workflow using Azure Boards work items, Azure Repos branches, Azure Pipelines, and BranchDeploy. Deploy a feature branch to staging in Azure DevOps Manual runs, YAML runtime parameters with branch conditions, and a work item deploy button compared, with YAML.

Audit, Teams, and AI assistants

Azure DevOps deployment audit log What Azure DevOps records about deployments, where the gaps are, and how to log ticket, branch, environment, and person together. Deploy from Microsoft Teams with Azure DevOps Notifications, approvals, and ticket-based deployment requests in Microsoft Teams, compared. Using an AI assistant for Azure DevOps deployments How to let ChatGPT, Claude, Cursor, or Copilot deploy work items over MCP without letting them pick the branch.

Release notes and changelogs

Publish a changelog from Azure Boards Turn work items and deployments into a customer-facing changelog, without maintaining a separate release notes document. Changelog and release notes for Azure DevOps How release notes work: writing from deployment history, and publishing to a JSON feed or a hosted page. Release notes documentation The public JSON schema, pagination, caching, and worked examples for fetching the feed from your own app.

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 the linked branch from an Azure DevOps work item Use the branch or PR linked to a ticket as the deployment source, and handle stale, missing, or multiple links. 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.