Microsoft Fabric Extension for Azure DevOps

The Microsoft Fabric Extension for Azure DevOps brings first-class Fabric automation directly into your ADO pipelines. It adds the FabricCLITask@0 task, which automatically provisions the Fabric CLI (fab) into the pipeline agent — no manual installation required.

Use it to provision workspaces, deploy items, manage Git integration, trigger deployment pipelines, and fully automate your Fabric CI/CD workflows.

Features

• Zero-setup Fabric CLI — the fab CLI is automatically provisioned by the task; no pip install needed.
• Multi-platform scripting — supports PowerShell, PowerShell Core, Bash, and Batch script types.
• Inline or file-based scripts — embed commands directly in YAML or point to a .ps1/.sh file in your repo.
• Workspace management — create, configure, and assign Fabric workspaces to capacities.
• Item deployment — publish notebooks, lakehouses, semantic models, pipelines, and more.
• Git integration — connect workspaces to ADO Git, commit changes, and sync from branches.
• Deployment pipelines — trigger stage promotions (Dev → Test → Prod) from CI/CD.
• Version-pinned CLI — pin a specific FabricCLIVersion for deterministic, reproducible builds.

Quick Start

1. Install the extension from the Azure DevOps Marketplace.

2. Create a variable group named FabricSecrets in ADO → Pipelines → Library:

   Variable	Description	Secret?
   FAB_SPN_CLIENT_ID	Service principal / managed identity client ID	No
   FAB_TENANT_ID	Microsoft Entra tenant ID	No
   FAB_CAPACITY_NAME	Target Fabric capacity name	No

   Note: No secrets are stored in the variable group. Authentication uses workload identity federation — the federated token is generated at pipeline runtime.

3. Add the task to your pipeline YAML:

variables:
  - group: FabricSecrets

steps:
  - task: Bash@3
    displayName: 'Generate Federated Token'
    inputs:
      filePath: './generate-federated-token.sh'

  - task: FabricCLITask@0
    displayName: 'Create Fabric Workspace'
    env:
      FAB_SPN_CLIENT_ID: $(FAB_SPN_CLIENT_ID)
      FAB_TENANT_ID: $(FAB_TENANT_ID)
      FAB_SPN_FEDERATED_TOKEN: $(FEDERATED_TOKEN)
    inputs:
      scriptType: inlineScript
      inlineScript: |
        fab mkdir "MyWorkspace.Workspace" -P capacityname=$FAB_CAPACITY_NAME

Task Reference

The extension provides one task: FabricCLITask@0.

Prerequisites

• An Azure DevOps organization and project
• A Microsoft Fabric capacity (F2 or higher, or a trial capacity)
• An Azure service connection configured in your ADO project

Related Resources

• Microsoft Fabric REST API
• Fabric CLI (fab) documentation
• Microsoft Fabric CI/CD documentation
• Workload identity federation setup