BitBucket
Integration Setup
To configure the BitBucket integration, follow these steps (either during the onboarding wizard, or once you have access to the Gomboc platform):
Go to Settings > Integrations > BitBucket
Click on your profile drop down in the top right corner and access your Gomboc settings and create a personal or workspace token.
Once the Gomboc token is created copy the generated token.
Click on the BitBucket integration button to open the form for creating the integration
Paste in the generated Gomboc token under the input Gomboc Access Token
In BitBucket, go to your workspace settings to create an access token Workspace Access Token that has Repositories (Read & Write), Pull requests (Read & Write), and Webhooks (Read & Write) permissions. Once generated, copy the workspace access token. Also keep in mind the workspace ID, which can be found within your workspace settings as well.
You can now complete the integration form by inputting your Workspace ID and copied workspace access token from BitBucket
3. Click "Integrate" to complete the initial SCM integration.
Review the status notification to ensure that all steps of the integration completed successfully. If the webhook setup failed to automatically complete, follow the steps below to create the webhook.
Integration without Webhook Setup
Please note that we do create a workspace webhook to complete the integration and keep track of PR's that we have opened. In the event that setup cannot execute properly due to errors creating the webhook, follow these steps.
Follow Step 1 above to navigate to the Integration setup page for Bitbucket
Follow Step 4 to open the integration settings
Follow Step 6 to create the BitBucket Workspace Access Token
Follow Step 7 to complete the integration form, but only specify the Workspace ID and the BitBucket access token. Leave the Gomboc Access Token blank
After you complete the integration, you should see a message that the integration was created successfully, but that the webhook for receiving change request status is not created or active.
Troubleshooting
BitBucket Access Token Issues
If you see the following message, then the access token that you created does not have all of the required scopes. Go back to the BitBucket admin page and create a new token being sure to give Repositories (Read & Write), Pull requests (Read & Write), and Webhooks (Read & Write) permissions.
Integration Creation Failures
If the integration fails to create properly, it's possible there are some issues where there are repositories in the workspace which cannot be managed by the admin. This will present as a failure to create the webhook during integration setup. In the logs for the error, Gomboc will be able to find "You cannot administer personal accounts of other users." The workaround for this issue is to create the integration following these instructions.
CI/CD
See BitBucket Pipelines.
Last updated