Bitbucket Integration

JFrog Pipelines Documentation

ft:sourceType
Paligo

A Bitbucket Integration is used to connect the JFrog Pipelines platform to bitbucket.org.

Creating an Integration

You can add this integration by following the steps on the Managing Pipelines Integrations page.

Here is the information you need to create this integration:

  • Name -- choose a friendly name for the integration

  • URL -- Bitbucket API endpoint. This is already hard-coded to https://api.bitbucket.org

  • User Name -- Username to connect to Bitbucket. This is the username found on the account settings page (Personal SettingsBitbucket profile settings), and not your email Id or display name.

  • Token -- Bitbucket token with the permissions needed to run your commands

Note

Bitbucket integration requires the following permissions:

  • Account: Read

  • Pull requests: Read

  • Workspace membership: Read

  • Projects: Read

  • Repositories: Admin

  • Webhooks: Read and Write

Usage

The Bitbucket integration can be used with the GitRepo resource.

The Bitbucket integration can also be added directly to a step in the integrations section.

Default Environment Variables

When you create a resource with this integration, and create a step that uses it in the inputResources section, a set of environment variables is automatically made available.

Environment variable

Description

res_<resource-name>_gitProvider_url

Bitbucket API location

res_<resource-name>_gitProvider_username

Username used to connect to Bitbucket

res_<resource-name>_gitProvider_token

The token used to connect to Bitbucket

When you add this integration directly to a step, a set of environment variables is automatically made available.

Environment variable

Description

int_<integration-name>_url

Bitbucket API location

int_<integration-name>_username

Username used to connect to Bitbucket

int_<integration-name>_token

The Token used to connect to Bitbucket