CircleCI code references
Read time: 1 minute
Last edited: Feb 09, 2023
Code references is available to customers on an Enterprise plan. To learn more, read about our pricing. To upgrade your plan, contact Sales.
This topic explains how you can use the
ld-find-code-refs utility with CircleCI to automatically populate code references in LaunchDarkly.
To complete this procedure, you must have the following prerequisites:
- An API access token with write permissions for the
code-reference-repositoryresource, either through the built-in Writer role or a custom role. To learn more, read API access tokens and Code reference actions.
- The LaunchDarkly CircleCI Orb.
To use CircleCI code references, you must be using a Circle Workflow version of 2.1 or higher. If you're using an earlier version, try manually using the utility binary or docker image to create your own workflow job. To learn more, read Execution via CLI in the
Setting up the LaunchDarkly CircleCI integration
To set up the LaunchDarkly orb in CircleCI:
- Save your API access token as an environment variable titled
LD_ACCESS_TOKENin your CircleCI project settings. To learn more, read CircleCI's documentation.
- Create a YAML file in CircleCI with configuration including LaunchDarkly's Orb. Here's an example minimal configuration using LaunchDarkly's Orb:
version: 2.1orbs:launchdarkly: firstname.lastname@example.org:main:jobs:- launchdarkly/find-code-references:proj_key: $YOUR_LAUNCHDARKLY_PROJECT_KEYrepo_type: github # can be 'bitbucket', 'custom', 'github', or 'gitlab'repo_url: $YOUR_REPO_URL # used to generate links to your repository
Additional configuration options
There are additional configuration options for the code references orb.
To skip searching files and directories, use an
To configure custom delimiters and aliases for your flag keys, or to set other advanced configuration, use the