For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sign inTry it free
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
  • Integrations
    • Collaboration tools
    • Data Export
    • Edge tools
    • Environments as a service
    • Experimentation and metric integrations
    • Internal developer platforms
    • Monitoring tools
    • Segments integrations
    • Workflow management tools
    • More integrations
      • Ansible Collection
      • AWS CloudTrail Lake
      • AWS PrivateLink
      • Bitbucket Pipelines
      • Bitrise Release Management
      • CloudQuery
      • Contentful
      • Convex
      • Crossplane
      • Ditto
      • FullStory
      • GitHub Actions
      • Kosli
      • ngrok
      • Osano
      • Terraform
      • Zendesk
    • Managing integrations
    • Using the LaunchDarkly integration framework
    • Building partner integrations
Sign inTry it free
LogoLogo
On this page
  • Overview
  • Prerequisites
  • Create feature flags in your Pipelines build
  • Enable a feature flag in your Pipelines build
IntegrationsMore integrations

Bitbucket Pipelines

Was this page helpful?
Previous

Bitrise Release Management

Next
Built with
The Bitbucket Pipelines integration is available to customers on select plans

The Bitbucket Pipelines integration is only available to customers on select plans. To learn more, read about our pricing. To upgrade your plan, contact Sales.

Overview

This topic explains how to create and enable feature flags using Bitbucket Pipelines.

The LaunchDarkly integration lets you insert feature flag actions directly into your Pipeline’s continuous delivery flow. Bitbucket Pipelines is a continuous delivery platform that lets your team build, test, and deploy from Bitbucket. It exists within Bitbucket, giving you end-to-end visibility from coding to deployment.

We provide two scripts you can add to your pipelines:

  • Create feature flags in your Pipelines build: This lets you create feature flags within a specified project. The feature flag will be created in all environments for that project.
  • Enable a feature flag in your Pipelines build: This lets you turn on a specific feature flag for a specific environment within a project.

Prerequisites

To use the LaunchDarkly Bitbucket Pipelines integration, you must meet the following prerequisites:

  • A Bitbucket account
  • Bitbucket Pipelines installed on your Bitbucket account

Create feature flags in your Pipelines build

You can configure a Bitbucket Pipeline step to create a set of feature flags in LaunchDarkly as part of your build process.

To set up your Bitbucket Pipeline with LaunchDarkly:

  1. Copy the create-launchdarkly-flags.sh shell script from our Bitbucket repository.
  2. Add create-launchdarkly-flags.sh to your Pipelines build configuration.
  3. Add two environment variables to your Pipelines settings:
    • LAUNCHDARKLY_ACCESS_TOKEN: Copy your API access token from the Authorizations tab within Account settings.
    • LAUNCHDARKLY_PROJECT_KEY: Copy your project key from your LaunchDarkly Projects tab within Account settings.

The Access tokens section of the Authorization tab.

The Access tokens section of the Authorization tab.
Do not use the LaunchDarkly environment key

Be careful to use the LaunchDarkly project key in the Bitbucket Pipelines settings, not the environment key. To learn how to find your project key, read Project keys.

  1. Add an ld-flags.conf file to your repository and declare flags in it.

When your Pipelines build runs, any feature flags you declare in this file is also created in LaunchDarkly.

Enable a feature flag in your Pipelines build

You can configure a Pipeline step that enables an existing feature flag in an environment as part of your build.

To enable feature flags with Bitbucket Pipelines:

  1. Copy the enable-launchdarkly-flags.sh shell script from our Bitbucket repository.
  2. Add enable-launchdarkly-flags.sh to your Pipelines build configuration.
  3. Add these environment variables to your Pipelines settings:
    • LAUNCHDARKLY_ACCESS_TOKEN: Copy your API access token from the Authorization tab.
    • LAUNCHDARKLY_PROJECT_KEY: To learn how to find your project key, read Project keys.
    • LAUNCHDARKLY_ENVIRONMENT_KEY: Copy your environment key from your LaunchDarkly Projects tab.
    • LAUNCHDARKLY_FLAG_KEY: Enter the key for the feature flag you wish to enable.