Skip to main content
System StatusContact Support
VersionOne Community

Configuring the Bitbucket Cloud Plugin

Set up the Bitbucket Cloud plugin, connect to one or more Bitbucket Cloud instances, and accomplish tasks such as showing a summary of Git Push operations, making API calls, and creating/deleting branches.

Configuration 

Before using the Bitbucket Cloud plugin, you must set up one or more Bitbucket Cloud instances.

  1. Select Plugins from the Administration menu (cogwheel icon) and select  Bitbucket Cloud from the list of plugins available. 
  2. Click Add and enter the following information:
    • Name: Type a name for the Bitbucket instance. 
    • User and Password: Type the username and password that should be used to log on to the Bitbucket Cloud. Leave blank if no authentication is required. 
    • URL: Type the URL of the Bitbucket Cloud. 
  3. Click Test Connection and make sure you are able to connect to the Bitbucket Cloud successfully.
  4. Repeat steps 2 and 3 to add more instances.
  5. When you have more than one cloud instance, click Set As Default to set one of the instances as the default.

Using the Bitbucket Cloud Plugin  

Once one or more Bitbucket Cloud instances have been set up, you can set up pipelines that use the Bitbucket Cloud plugin. You can either create a new Stage and add a step that uses the Bitbucket Cloud plugin or add the Bitbucket Cloud plugin to an existing Stage.

Functions 

There are four functions available with the Bitbucket Cloud plugin, which you can use in your Pipelines.

  • Show Summary: To show a summary of the Push information on the Plugin Details panel. This function needs no user input.
  • API Calls: Make API calls to a Bitbucket Cloud instance. 
  • Create Branch: Create a branch on a Bitbucket Cloud repository. 
  • Delete Branch: Delete a branch from a Bitbucket Cloud repository.

API Calls

Use the API Calls function to make API calls to Bitbucket Cloud. For more information about Bitbucket Cloud APIs, click here.

Properties

  • Type: Select an API call type from the drop-down list. 
  • Request: Type the path and querystring of the API request. 
  • Data: Type the JSON data to submit to the Bitbucket REST API (for certain types of call such as POST, DELETE, etc.)
  • Response Key: Optional path in the data document to store the result. Dotted notation is supported. 
  • Bitbucket Instance Name: Type the Bitbucket Cloud instance name. Leave blank to connect to the default instance. 

 

Create Branch

Use the Create Branch function to create a new branch on a Bitbucket repository. 

Properties

  • Owner: Type the Bitbucket user (username) or the team that owns the Bitbucket repository. 
  • Repository: Type the name of the Bitbucket repository where you want to create a branch. 
  • Source Branch Name: Type the source branch name to create the new branch from. 
  • New Branch Name: Type the name of the new branch. 
  • Bitbucket Instance Name: Type the Bitbucket Cloud instance name. Leave blank to connect to the default instance. 

 

Delete Branch

Use the Delete Branch function to delete a branch from a Bitbucket repository. 

Properties

  • Owner: Type the Bitbucket user (username) or the team that owns the Bitbucket repository. 
  • Repository: Type the name of the Bitbucket repository where the branch you want to delete exists.
  • Branch Name: Type the name of the branch you want to delete. 
  • Bitbucket Instance Name: Type the Bitbucket Cloud instance name. Leave blank to connect to the default instance. 

 

 

  • Was this article helpful?