Bitbucket

Bitbucket Setup

Bitbucket integration is available on enterprise plans. Bitbucket provides source control integration (push/pull between portal and repository) but does not include automatic deployments. Use Bitbucket Pipelines to deploy your API.

Bitbucket.org

If you are using the SaaS Bitbucket hosted at bitbucket.org, contact support@zuplo.com to enable Bitbucket on your account.

Provide support with your Bitbucket Workspace ID, found on your Workspace Settings page.

Self-Hosted Bitbucket

For self-hosted Bitbucket, you need to set up a custom Bitbucket OAuth App and provide Zuplo support with the following values:

  • Bitbucket Server URL — Something like https://bitbucket.example.com
  • Client ID — The client ID of the Bitbucket app you created
  • Client Secret — The client secret of the Bitbucket app you created

When configuring your app you will need to set the following values:

  • Callback URL - https://portal.zuplo.com
  • Permissions - repo user read:org

Limiting Access

Bitbucket doesn't support scoping OAuth app access to specific repositories. This is a Bitbucket limitation. To limit Zuplo's access:

  1. Create a new workspace and install the Zuplo app only in that workspace
  2. Create a service account user with limited repository access and use that user to connect Bitbucket to Zuplo
Last modified on