Bitbucket code references
Read time: 2 minutes
Last edited: Jun 05, 2024
Code references is available to customers on an Enterprise plan. To learn more, read about our pricing. To upgrade your plan, contact Sales.
Overview
This topic explains how to use the ld-find-code-refs
utility with Bitbucket code references to create code references in LaunchDarkly.
You can use the ld-find-code-refs
utility with Bitbucket Pipelines to automatically populate code references in LaunchDarkly. To do this, you must create a Pipes configuration using LaunchDarkly's code reference pipe.
Prerequisites
To set up Bitbucket Pipes, you must have the following prerequisite:
- A Bitbucket Pipelines configuration file. To create one, navigate to the Pipelines section of your Bitbucket repository.
- An API access token with write permissions for the
code-reference-repository
resource, either through the built-in Writer role or a custom role. To learn more, read API access tokens and Code reference actions.
Alternatively, you can give the access token access to a custom role with the code-reference-repository
resource specifier. To learn more, read Custom roles.
Set up the Pipes configuration
To set up the Bitbucket Pipes configuration:
- Create a new Pipeline configuration in your Bitbucket repository.
- Configure the Pipeline to run on
push
using thedefault
configuration. Include the following variables:
LD_ACCESS_TOKEN
: This secured variable should be your API access token.LD_PROJ_KEY
: This should be your LaunchDarkly project key. To learn how to find your project key, read Project keys.
Here's an example of a minimal Pipeline configuration:
![An example Pipeline configuration.](/static/1725648931703.4346522321/6af66/bitbucket-config.png)
You can copy and paste the following code into a blank Pipelines configuration if you have set the LD_PROJ_KEY
and LD_ACCESS_TOKEN
environment variables as repository variables:
pipelines:default:- step:script:- pipe: launchdarkly/ld-find-code-refs-pipe:2.12.0environment:LD_ACCESS_TOKEN: $LD_ACCESS_TOKENLD_PROJ_KEY: $LD_PROJ_KEY
To learn more about repository variables, read Atlassian's documentation.
- Confirm that the pipeline is working by creating a new pull request with the workflow file and visiting the Pipelines page on your repository's webpage. If your pipeline fails, there may be a problem with your configuration. To investigate, check the pipeline's logs to view any error messages.
Pipeline configuration
You may configure the code reference pipe with additional environment variables to enable more functionality. For additional configuration options, read the ld-find-code-refs-pipe repository.