Limit a custom pipeline to a branch

I added two custom pipelines in order to manually trigger them: One for deployment to test and the other for deployment to prod.

Unfortunately, it is possible to run both pipelines on every branch, e.g. I could run "deployment to prod" on the development branch, which should only be possible on the master branch.

Is there a way to limit custom pipelines to specific branches?

3 answers

This doesn't seem to be possible within bitbucket-pipelines.yml itself, but you can check for the branch in your script:


if [ "$(git rev-parse --abbrev-ref HEAD)" == "master" ]; then
echo "master :)"
echo "not master :("

If you want to follow @Steve Taylor's answer you can also check the BITBUCKET_BRANCH environment variable in the pipeline.

Alternatively, you could set up a pipeline that runs on master only and has manual steps that do the deployments. i.e. Steps that will only trigger with manual input. You will also need to be using artifacts for this.

Documentation links.

Manual Steps:


Something like this:

- step:
trigger: manual
name: test
- build-output/**
- ./runTests
- step:
trigger: manual
name: "Deploy to Staging"
- build-output:**
- ./deploy-to-staging
- step:
trigger: manaual
name: "Deploy to Production"
- ./deploy-to-production

- step:
name: test
- ./run-tests

Then you can also set up Bitbucket Deployments (if you're in the alpha programme) to track the status of your environments

0 vote

I just noticed that since some weeks there's an option to run every pipeline (not only custom ones) from every commit.

This is dangerous (everyone could push to production WIPs or old commits, or even malicious ones via a side branch).

Is it really this way?

Screen Shot 2018-03-23 at 16.13.37.png

Suggest an answer

Log in or Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Posted Jun 12, 2018 in Bitbucket

Do you use any Atlassian products for your personal projects?

After spinning my wheels trying to get organized enough to write a book for National Novel Writing Month (NaNoWriMo) I took my affinity for Atlassian products from my work life and decided to tr...

23,239 views 26 12
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you