gitlab-org--gitlab-foss/doc/user/project/integrations/bamboo.md

stage	group	info
Ecosystem	Integrations	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments

Atlassian Bamboo integration (FREE)

You can automatically trigger builds in Atlassian Bamboo when you push changes to your project in GitLab.

When this integration is configured, merge requests also display the following information:

• A CI/CD status that shows if the build is pending, failed, or has completed successfully.
• A link to the Bamboo build page for more information.

Bamboo doesn't provide the same features as a traditional build system when accepting webhooks and commit data. You must configure a Bamboo build plan before you configure the integration in GitLab.

Configure Bamboo

1. In Bamboo, go to a build plan and choose Actions > Configure plan.
2. Select the Triggers tab.
3. Select Add trigger.
4. Enter a description like GitLab trigger.
5. Select Repository triggers the build when changes are committed.
6. Select the checkbox for one or more repositories.
7. Enter the GitLab IP address in Trigger IP addresses. These IP addresses are allowed to trigger Bamboo builds.
8. Save the trigger.
9. In the left pane, select a build stage. If you have multiple build stages, select the last stage that contains the Git checkout task.
10. Select the Miscellaneous tab.
11. Under Pattern Match Labeling enter ${bamboo.repository.revision.number} in Labels.
12. Select Save.

Bamboo is ready to accept triggers from GitLab. Next, set up the Bamboo integration in GitLab.

Configure GitLab

1. On the top bar, select Menu > Projects and find your project.
2. On the left sidebar, select Settings > Integrations.
3. Select Atlassian Bamboo.
4. Ensure the Active checkbox is selected.
5. Enter the base URL of your Bamboo server. For example, https://bamboo.example.com.
6. Enter the build key from your Bamboo build plan.
7. If necessary, enter a username and password for a Bamboo user that has access to trigger the build plan. Leave these fields blank if you do not require authentication.
8. Optional. To test the configuration and trigger a build in Bamboo, select Test Settings.
9. Select Save changes.

Identify the Bamboo build plan build key

A build key is a unique identifier typically made up from the project key and plan key. Build keys are short, all uppercase, and separated with a dash (-), for example PROJ-PLAN.

The build key is included in the browser URL when you view a plan in Bamboo. For example, https://bamboo.example.com/browse/PROJ-PLAN.

Troubleshooting

Builds not triggered

If builds are not triggered, ensure you entered the right GitLab IP address in Bamboo under Trigger IP addresses. Also check service hook logs for request failures.

Advanced Atlassian Bamboo features not available in GitLab UI

Advanced Atlassian Bamboo features are not compatible with GitLab. These features include, but are not limited to, the ability to watch the build logs from the GitLab UI.