1. Resources
  2. /
  3. Plugins
  4. /
  5. bail-early-buildkite-plugin

bail-early-buildkite-plugin

If any jobs or triggered builds fail, cancel the parent build immediately

Screenshot of bailed build

Usage

  1. Provide a Buildkite token with graphql and write_builds access via a BUILDKITE_TOKEN environment variable

  2. Add the plugin to your steps:

steps:
  - command: 'echo hi'
    plugins:
      - 'uber-workflow/bail-early#v1.1.0': ~

Any step using this plugin will cause the parent build to bail with an annotation linking to the failed job.

If this plugin is used in a build triggered by a trigger step, it will bail the parent build it was triggered from and add the annotation there instead.

Configuration

If you need to limit when the plugin is enabled, you can use the if parameter. Its value is eval’d in a bash conditional (e.g. if [ <your value here> ]; then...)

steps:
  - command: 'echo hi'
    plugins:
      - 'uber-workflow/bail-early#v1.1.0':
        if: '"$SHOULD_BAIL_EARLY" = "true"'

The plugins listed on this webpage are provided for informational purposes only. They have not undergone any formal security review or assessment. While we strive to provide useful resources, we cannot guarantee the safety, reliability, or integrity of these plugins. Users are strongly advised to conduct their own security evaluations before downloading, installing, or using any plugin. By using these plugins, you acknowledge and accept any risks associated with their use. We disclaim any liability for any harm or damages arising from the use of the plugins listed.

Start turning complexity into an advantage

Create an account to get started with a 30-day free trial. No credit card required.

Buildkite Pipelines

Platform

  1. Pipelines
  2. Public pipelines
  3. Test Engine
  4. Package Registries
  5. Mobile Delivery Cloud
  6. Pricing

Hosting options

  1. Self-hosted agents
  2. Mac hosted agents
  3. Linux hosted agents

Resources

  1. Docs
  2. Blog
  3. Changelog
  4. Example pipelines
  5. Plugins
  6. Webinars
  7. Case studies
  8. Events
  9. Migration Services
  10. Comparisons

Company

  1. About
  2. Careers
  3. Press
  4. Security
  5. Brand assets
  6. Contact

Solutions

  1. Replace Jenkins
  2. Workflows for AI/ML
  3. Testing at scale
  4. Monorepo mojo
  5. Bazel orchestration

Legal

  1. Terms of Service
  2. Acceptable Use Policy
  3. Privacy Policy
  4. Subprocessors
  5. Service Level Agreement

Support

  1. System status
  2. Forum
© Buildkite Pty Ltd 2025