Troubleshooting disabled "Deploy" button in Bitbucket Cloud Pipelines with the error message "<Branch_name> are preventing the deployment to <Deployment_name>"

 

Platform Notice: Cloud - This article applies to Atlassian products on the cloud platform.

   

Summary

This knowledge base article aims to provide a step-by-step guide on troubleshooting the disabled "Deploy" button in Bitbucket Cloud Pipelines. Hovering your mouse towards the disabled "Deploy" button will show the following error:

Branch restrictions on <Branch_name> are preventing the deployment to <Deployment_name>

Cause

This issue occurs when the Deployment branch permission is not properly configured. It could be due to an incorrect branch name or the presence of additional empty spaces in the name. Consequently, the deployment process considers the steps ineligible for deployment on that particular branch.

Solution

To fix the issue, follow these steps:

  1. Access Repository Settings.
  2. Find the "Pipelines" section and click on "Deployment".
  3. Look for the name of the deployment that is affected and expand it.
  4. Locate the "Branches allowed to deploy to Production" option.
  5. Remove the affected branch by clicking on the "x" symbol next to it.
  6. After removing the branch, re-add it by entering the branch name correctly in the provided form. Make sure to spell the name correctly. If you are using an asterisk pattern, ensure there are no additional spaces between characters.


If you are still encountering issues after following this troubleshooting article, please raise a support ticket or raise a community support ticket for further assistance.

DescriptionTroubleshooting disabled "Deploy" button in Bitbucket Cloud Pipelines with the error message "<Branch_name> are preventing the deployment to <Deployment_name>"
ProductBitbucket Cloud
Last modified on Jan 17, 2024

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.