Bitbucket Server Integration

JFrog Pipelines Documentation

Products
JFrog Pipelines
Content Type
User Guide
ft:sourceType
Paligo

A Bitbucket Server Integration is used to connect the JFrog Pipelines platform to an installation of Bitbucket Server.

Creating a Bitbucket Server Integration

You can add this integration by following 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 Server API endpoint. For example: https://bitbucket.myserver.com/

  • User Name-- username to connect to Bitbucket Server

  • Password -- password for the user account on Bitbucket Server

Note

Bitbucket Server integration requires Admin permission for repositories.

Usage

The Bitbucket Server integration is most commonly used with the GitRepo resource or while adding a Pipeline source.

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

URL Specification

When a Bitbucket Server repository is part of a project, the URL uses the project key rather than the project name. So if the "Teams in Space" project key is TIS, then the "buildPipe" repository in that project is addressed as TIS/buildpipe.

When a Bitbucket Server repository is a personal repository, the '~' (tilde) character must precede the user slug in the URL. For example: ~janedoe/test.

For additional information, see Atlassian Stash REST API Reference.

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 Server API location

res_<resource-name>_gitProvider_username

Username used to connect to a Bitbucket Server user account

res_<resource-name>_gitProvider_password

The password used to connect to the Bitbucket Server user account

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 Server API location

int_<integration-name>_username

Username used to connect to the Bitbucket Server user account

int_<integration-name>_password

The password used to connect to the Bitbucket Server user account