Run pipelines manually

Manual steps

Manual steps allows you to customize your CI/CD pipeline by configuring steps that will only be run when manually triggered by someone. This is useful for steps like deployment steps, where some manual testing or checks need to happen before the step runs. You can configure a step as manual by adding trigger: manual to the step in your bitbucket-pipelines.yml file.

Manual pipelines

Any pipeline can be manually run against a specific commit and for configuring scheduled builds. To run a pipeline manually, trigger it from the Bitbucket Cloud UI. 

Custom pipelines are used to define configurations that you only want to run manually. Custom pipelines do not run automatically on a commit to a branch. To define a custom pipeline, add the pipeline configuration in the custom section of your bitbucket-pipelines.yml file. Pipelines which are not defined as a custom pipeline will also run automatically when a push to the branch occurs.

You'll need write permission on the repository to run a pipeline manually.

Step 1: Add a pipeline to the bitbucket-pipelines.yml file

You can manually trigger a build in Bitbucket Pipelines for any build pipeline configuration included in your bitbucket-pipelines.yml file:

  custom: # Pipelines that can only be triggered manually
      - step:
            - echo "Manual triggers for Sonar are awesome!"
      - step:
            - echo "Manual triggers for deployments are awesome!"
  branches:  # Pipelines that run automatically on a commit to a branch can also be triggered manually
      - step:
            - echo "Automated pipelines are cool too."

Step 2: Trigger the pipeline from Bitbucket Cloud

Pipelines can be triggered manually from either the Branches view or the Commits view in the Bitbucket Cloud interface.

Run a pipeline manually from the Branches view

Click to see details...
  1. Go to the Branches view in Bitbucket.
  2. Click on the Actions menu for the branch you want to run a pipeline for, then click Run pipeline for a branch:

  3. Choose a pipeline, then click Run:

Run a pipeline manually from the Commits view

Click to see details...
  1. Go to the Commits view for a commit (click Commits, then a commit hash). 
  2. Click Run pipeline:

  3. Choose a pipeline, then click Run:
Last modified on Jan 29, 2018

Was this helpful?

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