Configuring Bitbucket integrations

Manage your Bitbucket source files.

Before you begin

BitBucket 5.15.0 or later is supported.

About this task

This topic describes how to integrate BitBucket into a value stream by modifying the value_stream_name.json file.

To define an integration, complete the following steps:


  1. On the Value Stream page, click Download value stream map. The value_stream_name.json is downloaded to the specified location.
  2. Using a text editor, define an integration object in the integrations array, or area, of the value_stream_name.json file.
    The following code example illustrate a typical integration.
          "type": "ucv-ext-bitbucket-server", 
          "tenant_id": "5ade13625558f2c6688d15ce", 
          "name": "my-bitbucket", 
          "disabled": false, 
          "properties": { 
            "baseApiUrl": "[Base URL ex:]", 
            "username": "admin", 
            "password": "[Basic user password]", 
            "projectName": "[Full project name ex: JKE Mortgage Application]", 
            "projectKey": "[Project key ex: JMA]", 
            "repositoryName": "[app repository name ex: web-application]", 
            "repositorySlug": "[app repository name ex: web-application]" 
  3. On the Value Stream page, click Replace value stream map, and then select the modified file.
    For more information about creating value stream integrations, see About value stream integrations.


Objects from the integrated BitBucket instance appear in stages of the value stream, and the integration is listed on the Integrations page in the web UI.