Track deployment status on pull requests

Deployment visibility helps you answer a common delivery question: Where is my pull request deployed? In Bitbucket Cloud, the pull requests page shows the deployment information for each pull request, so you can see which environments a pull request is deployed to without searching through pipeline runs or the Deployments page.

Before you begin

To be able to see deployment status on pull requests:

• Bitbucket Pipelines must be enabled for the repository.

• The repository must have at least one deployment environment configured.

• Your bitbucket-pipelines.yml file must include deployment steps that use the deployment property for running deployments.

Refer to the following help document for more information on setting up and monitoring deployments: Set up and monitor deployments.

Viewing deployment status in pull requests

1. Open the repository in Bitbucket.

2. Go to Pull requests.

3. In the Deployments column, view the deployment status summary for each of the pull requests.

4. Select the deployment status icon to see the environments and corresponding deployment statuses in a dropdown.

5. Select an environment name in the dropdown to navigate directly to the corresponding deployment summary.

If your repository has no deployment environment configured, you may see an Add option that redirects you to the deployments setup page.

How deployment status is shown

Deployment status is tracked per commit and per environment. If the latest commit for a pull request has been deployed by a Bitbucket Pipelines deployment step, the pull requests page shows the current deployment status for the environments against that pull request. If the same commit in a PR is deployed to the same environment multiple times, Bitbucket shows the latest deployment status for that environment against the pull request.

An aggregated status icon, which shows the overall status of the deployment across all environments where pull request deployment has started or completed, is displayed per pull request.

How redeployments affect status

If an earlier release redeploys an environment, the deployment status of later pull requests no longer deployed there is removed. This prevents a pull request from appearing deployed when the environment has rolled back to an older commit.