Buildkite integrates with Bitbucket Server to provide automated builds based on your source control. You can run a build every time you push code to Bitbucket Server, using a webhook that you create in your Bitbucket Server.
Bitbucket Enterprise Server is available to customers on the Buildkite Business and Enterprise plans.
This guide shows you how to set up your Bitbucket Server builds with Buildkite. It was written using Bitbucket Server version 7.11.1
- Select Settings to open the Organization Settings page.
- Navigate to Repository Providers.
- Select Bitbucket Server.
- In URLs, enter the address of your Bitbucket Server, including a port if needed. For example,
localhost:8000. You can also restrict which network addresses are allowed to trigger builds using webhooks in Allowed IP Addresses in Network Settings.
- Select Save Settings.
- Set up a pipeline as normal. Refer to Pipelines for more information.
If your configuration worked, Buildkite automatically recognizes your repository URL as a Bitbucket Server repository. To check this, go to Pipelines >
your-pipeline > Pipeline Settings. You should see Bitbucket Server in the Pipeline Settings menu.
Buildkite includes built-in instructions on how to set up a Bitbucket Server webhook. This webhook allows Bitbucket Server to trigger Buildkite builds in response to events like code pushes and pull requests.
- Navigate to Pipelines >
your-pipeline> Pipeline Settings > Bitbucket Server.
- Select Bitbucket Server Setup Instructions.
- Follow the on screen instructions to configure your webhook.
You can edit the version control provider settings for each pipeline from the pipeline's settings page. Go to Pipelines > Pipeline Menu > Pipeline Settings >
If you want to use the same repository in multiple pipelines (including pipelines in different Buildkite organizations), you need to configure a separate webhook for each pipeline. Follow the webhook setup instructions in the Buildkite UI. Buildkite shows you these instructions when you create the pipeline, but you can also find them in Pipeline Settings >
<Provider> Setup Instructions.