Work with deployment pipelines

Completed

Once you have content in a pipeline stage, you can deploy it to the next stage. Deploying content to another stage is usually done after you've performed some actions in the pipeline. For example, you made development changes to your content in the development stage or tested your content in the test stage. A typical workflow for moving content from stage to stage, is development to test, and then test to production.

To deploy content to the next stage in the deployment pipeline, select the deploy button at the bottom of the stage.

When reviewing the test and production stage cards, you can see the last deployment time. This indicates the last time content was deployed to the stage.

Deployment time is useful for establishing when a stage was last updated. It can also be helpful if you want to track time between test and production deployments.

Compare stages

When two sequential stages have content, the content is compared based on the content item’s metadata. This comparison doesn't include comparing data or refresh time between stages.

Screenshot highlighting compare option between stages. Content is compared based on the content item's metadata.

To allow a quick visual insight into the differences between two sequential stages, a comparison icon indicator appears between them. The comparison indicator has two states:

ICON EXPLANATION
Screenshot of the icon that appears if one of these conditions is met. Some of the content items in each stage were changed or updated (have different metadata). There is a difference in the number of items between the stages. Appears if one of these conditions is met: 1) Some of the content items in each stage, were changed or updated (have different metadata), or 2) There is a difference in the number of items between the stages.
Screenshot of the icon that shows the metadata for each content item in both stages is the same. Appears when the content in both workspaces is identical.

When two sequential stages aren't the same, a link appears underneath the orange comparison icon. Clicking the link opens the content item list in both stages in Compare view. Compare view shows changes or differences between items, in each pipeline stage. Changed items get one of the following labels:

NEW DIFFERENT MISSING
When a new item get added in source stage. An item that exists both in the source and the target stage. This label indicates that an item   appears in the target stage, but not in the source stage.
A new item in the source stage. This item doesn't exist in the target stage. After deployment, this item will be cloned to the target stage. An item that exists both in the source and the target stage, where one of the versions was changed after the last deployment. After deployment, the item in the source stage will overwrite the item in the target stage, regardless of where the change was made. This label indicates that an item appears in the target stage, but not in the source stage.

Screenshot highlighting comparision between Test stage and production stage.

Deployment rules enable customization of stages

While working in a deployment pipeline, different stages may have different configurations. For example, each stage can have different databases or different query parameters, or the development stage might query sample data from the database, while the test and production stages query the entire database.

Configuring deployment rules enables you to allow changes to content when you deploy content between pipeline stages. For example, if you want a semantic model in a production stage to point to a production database, you can define a rule for semantic model. The rule is defined in the production stage, under the appropriate semantic model. Once the rule is defined, content deployed from test to production will inherit the value as defined in the deployment rule, and will always apply it as long as the rule is unchanged and valid.

See Create deployment rules for detailed information on how to configure deployment rules.

Collaborate with others – permissions

Pipeline permissions and workspace permissions are granted and managed separately. However, you must have both pipeline access and workspace member permissions to deploy content.

For example, a user with pipeline access that doesn't have workspace permissions, will be able to view the pipeline and share it with others. However, this user won't be able to view the content of the workspace in the pipeline, or in the workspace page, and won't be able to perform deployments.

Also, when deploying Power BI items, the ownership of the deployed item may change. Review the table below to understand who can deploy each item and how the deployment affects the item's ownership.

Power BI item Required permission to deploy an existing item Item ownership after a first time deployment Item ownership after deployment to a stage with the Power BI item
Semantic model Workspace member The user who made the deployment becomes the owner Unchanged
Dataflow Dataflow owner The user who made the deployment becomes the owner Unchanged
Paginated report Workspace member The user who made the deployment becomes the owner The user who made the deployment becomes the owner

Managing permissions at both the pipeline and workspaces level (different stages) allows different people to work on them with different permissions.

Managing the deployment processes, especially for larger applications with multiple contributors, can be error prone if everyone has the same permissions – managing these permissions provides a streamline and tight method of control on who can do what.

Review more details at Deployment pipeline and workspaces permissions.