You can use branch patterns to ensure pipelines are only triggered when necessary. This guide shows you how to setup branch patterns for whole pipelines and individual build steps.
Pipeline-level branch filtering
By default a pipeline will trigger builds for all branches (
* or blank). In your pipeline settings you can set specific branch patterns for the entire pipeline. If a commit doesn't match the branch pattern, no build will be created.
Pull Request Builds
Builds created for pull requests will ignore any pipeline-level branch filters. If you want to limit the branches that can build pull requests, add an additional branch filter in your pipeline's source control settings.
This filter can be found under 'Build pull requests' if you have chosen the 'Trigger builds after pushing code' option.
Step-level branch filtering
As with pipeline-level branch filtering, you can set branch patterns on individual steps. Steps that have branch filters will only be added to builds on branches matching the pattern.
For example, this pipeline.yml file demonstrates the use of different branch filters on its steps:
steps: - label: "🔨 Build" command: - "npm install" - "tests.sh" branches: "feature/* release/* master !infrastructure" - block: "Release notes" prompt: "Please add notes for this release" fields: - text: "Notes" key: "notes" branches: "release/*" - label: "Deploy Preparation" command: "deploy-prep.sh" branches: "master" - wait - trigger: "app-deploy" label: ":shipit:" branches: "master"
You can add branch filters to steps created in Buildkite, as well as to steps in your pipeline.yml file.
Step-level branch filters will only affect the step that they are added to. Subsequent steps without branch filters will still be added to the pipeline.
Branch pattern examples
When you define a value in the
branch attribute of a step, only builds on the specified branch/es will contain that step. Adding more values to the
branch attribute will expand the set of branches that will include that step.
The following are examples of patterns, and the branches that they will match:
master productionwill match master and production only
master features/*will match master and any branch that starts with
*/release-123will match any branch that ends with
v*.0will match branch that begins with a
vand ends with a
.0, such as
v*.*.*will match branch that begins with a
vand has two periods, such as
!productionwill match any branch that's not
staging !production developmentwill match staging and development only
For more advanced step filtering, see the Using conditionals guide.