Assign a workspace to a deployment pipeline
APPLIES TO: ❌ Power BI Desktop ✔️ Power BI service
Deployment pipelines enables you to assign and unassign workspaces to any stage in a pipeline. This capability is particularly important for organizations that already have workspaces that are used as development, test and production environments. In such cases, you can assign each workspace to its corresponding pipeline stage, and continue working in your usual flow.
This article describes how to assign and unassign a workspace to a deployment pipeline stage in the Power BI service. You can also perform these functions programmatically, using the Assign Workspace and Unassign Workspace Power BI REST APIs.
Assign a workspace to any vacant pipeline stage
To assign a workspace to a pipeline, the pipeline stage you want to assign the workspace to, has to be vacant. If you want to assign a workspace to a pipeline stage that already has another workspace assigned to it, unassign the current workspace from that stage and then continue with assigning the new workspace.
Before you assign a workspace to a pipeline stage, review the limitations section and make sure that the workspace meets the required conditions.
Before you assign or unassign a workspace to a pipeline, consider that every time you deploy to a vacant stage, a new workspace is created.
To assign a workspace to a pipeline stage, follow these steps:
Open the pipeline.
In the stage you want to assign a workspace to, expand the dropdown titled Choose a workspace to assign to this pipeline.
From the dropdown menu, select the workspace you want to assign to this stage.
Select Assign a workspace.
Unassign a workspace from a pipeline stage
You can unassign a workspace from any pipeline stage. If you want to assign a different workspace to a pipeline stage, you'll first have to unassign the current workspace from that stage.
To unassign a workspace from a pipeline stage, follow these steps:
Open the pipeline.
In the stage you want to unassign the workspace from, select settings.
From the settings menu, select Unassign workspace.
In the Unassign workspace dialogue box, select Unassign.
After assigning a workspace to a deployment pipeline stage, if there are any adjacent stages already assigned, deployment pipelines attempts to create the connections between the Power BI items (such as reports, dashboards and datasets) in the adjacent stages. During this process, deployment pipelines checks the names of the Power BI items in the source stage and the stages adjacent to it. Connections to items in adjacent stages, are established according to the item's type and name. If there are multiple items of the same type with the same name in the adjacent stages, assigning the workspace will fail. To understand why this happens and resolve such cases, see Why am I getting the 'can't assign the workspace' error message when I assign a workspace?
Connections between items are only established when you assign a workspace to a pipeline stage. Adding a new item to a workspace that's part of a pipeline, doesn't trigger the creation of connections between that item and identical items in adjacent stages. To trigger forming a connection between a newly added item in a workspace stage and its equivalent item in an adjacent stage, unassign and reassign the workspace that contains the newly added item.
The workspace must be a new workspace experience.
You must be an admin of the workspace.
The workspace is not assigned to any other pipeline.
The workspace must reside on a Premium capacity.
To assign a workspace you need at least workspace member permissions for the workspaces in its adjacent stages. For more information see Why am I getting the 'workspace member permissions needed' error message when I try to assign a workspace?
You cannot assign a workspace with Power BI samples to a pipeline stage.
You cannot assign a template app workspace.
Submit and view feedback for