Azure Boards

Marketplace to first deploy in around five minutes.

DOCS — Set up guide

Set up
guide.

Add BranchDeploy to Azure DevOps, link a branch or PR, enter a pipeline ID, then deploy from the work item. No backend, account, or stored secrets.

01Requirements

What you need.

req_01

An Azure DevOps organisation on dev.azure.com.

req_02

Azure Repos in the project.

req_03

An Azure Pipeline the current user can queue.

req_04

Permission to install Marketplace extensions, or an admin who can.

02Setup Once per organisation.

Four steps.

install → link → configure → deploy
· available across every project in the organisation
01 Install from the Marketplace
  • Open BranchDeploy in the Marketplace.
  • Click Get it free, select your organisation, and install.
02 Link a branch or PR to a work item
  • Open a work item and create or link a branch in the Development section.
  • Or link the work item from an Azure Repos PR.
  • Only linked Azure Repos branches and PRs are followed.
03 Configure for your project
  • Open Project Settings, then BranchDeploy.
  • Enter pipeline settings and save.
04 Deploy from a work item
  • Open a linked work item.
  • Click the BranchDeploy action in the toolbar, then Deploy.
  • The run ID and pipeline link appear immediately.
BranchDeploy uses Development links only, not work item titles, commit messages, or Related Work links.
03Permissions

Check permissions.

BranchDeploy queues pipelines as the current Azure DevOps user. If you cannot queue the pipeline manually, BranchDeploy cannot queue it either.

Queue builds

Required on the target pipeline.

Branch filters

Pipeline branch filters must allow the linked branch.

04Next steps

Where next?

Configure Configuration guide Set up pipeline parameters and branch rules. Pipeline YAML YAML examples Use BranchDeploy parameters in YAML. Troubleshoot Troubleshooting Fix the most common problems.