Bitbucket Server
This page describes how to configure Bamboo to use a Bitbucket Server repository.
Bamboo では、次のレベルでリポジトリを指定できます。
- グローバル - Bamboo のすべてのプランでリポジトリを利用できます。
- プラン - Bamboo プランのすべてのジョブでリポジトリを利用できます。
- ジョブ - Bamboo ジョブのすべてのタスクでリポジトリを利用できます。
推奨されるアプローチは、リンクされたソース リポジトリをグローバル レベルで設定することです。「ソース コード リポジトリへのリンク」を参照してください。
When you link a repository hosted in Atlassian's Bitbucket Server with a build plan in Bamboo, then without any further configuration:
- Bamboo will automatically run a build when changes are pushed to the Bitbucket Server repository, without needing to configure polling.
- Bamboo will automatically update plan branches when a developer pushes a new branch to the repository (or deletes a branch).
- You can click through to Bitbucket Server to see the commit diff for all files that are part of the changeset.
- Bitbucket Server commits that are part of a build are displayed in Bamboo.
- Build results are notified to Bitbucket Server (and displayed for the associated commits and pull requests).
このページの内容
Bitbucket Server and Bamboo only need to have been connected by creating an application link. Repositories in Bitbucket Server are then made available in Bamboo, so it is easy for you to link your Bamboo plan to a Bitbucket Server repository.
When you create a plan that uses a Bitbucket Server source repository, Bamboo will automatically use the 'Bitbucket Server repository triggers the build when changes are committed' trigger option instead of using the 'polling the repository for changes' option. This reduces the load on the Bamboo and Bitbucket servers because Bamboo doesn't need to send poll requests (for each branch of each plan) to the Bitbucket server every 3 minutes (the default polling period). Instead, Bitbucket Server will trigger Bamboo whenever there is a push to the repository.
Configuration requirements
Navigate to the source repository settings for a plan or job, as described on Linking to source code repositories, then:
- Either click Add Repository to add a new repository, or edit an existing repository configuration.
Choose Stash from the Repository host list.
Complete the required information:
Display name
A name that identifies this repository within Bamboo.
Stash server
This menu will show all Bitbucket servers that have been linked to Bamboo via an application link.
Repository
The repository that will be built. This menu will show all repositories on the Bitbucket server that you have permissions to access.
Branch
Pick a branch if you want to check out code from a branch other than the default branch.
Advanced options
Use shallow clones
Allows Bamboo to perform shallow clones (i.e. history truncated to a specified number of revisions). This should increase the speed of the initial code checkouts, however if your build depends on the full repository history, we recommend that you do not use this option. Shallow clones are enabled by default.
Enable repository caching on remote agents
Allow caching of repositories on remote agents to save bandwidth. Note that caches are always full clones of the source repository.
Use submodules
Select to enable submodules support if these are defined for the repository. If native Git capability is not defined for agent submodules support will be disabled.
Command timeout
This helps to stop hung Bitbucket processes. On slower networks, you may consider increasing the default timeout to allow Bamboo time to make an initial clone of the Git repository.
Verbose logs
Turns on more verbose logs from Git commands. Use this option if you encounter problems with Git in Bamboo.
Fetch whole repository
Fetches whole repository instead of only one selected branch.
Enable Quiet Period
Specifies a delay after a single commit is detected before the build is started. This allows multiple commits to be aggregated into a single build.
Include/Exclude Files
Allows you to specify the files that Bamboo should, or should not, use to detect changes. When you configure the Include option, it means that you want Bamboo to use only the mentioned files for change detection (by default Bamboo checks all the files). In the same way, if you configure the Exclude option, Bamboo will not consider the excluded files when detecting changes.
Enter into File Pattern a regular expression to match the files that Bamboo includes or excludes. The regex pattern must match the file path in the repository. See this page for examples.
Exclude changesets
Enter a regular expression to match the commit messages for changesets that should not start a build.
Git LFS
- Git version 1.8.2 or later installed locally in your environment
Git LFS 1.2 or later installed.
Bamboo 5.15 is shipped number of images which also include the Git LFS client.
Web repository
Stash – specify the following details for the repository:
- Server URL – the URL of your Bitbucket Server instance (e.g. 'https://bitbucket.mycompany.com ').
- Stash Project Key – the key of the project in Bitbucket Server (e.g. 'CONF').
- Repository Name – the name of the repository in Bitbucket Server (e.g. 'conf-dev').
See Integrating Bamboo with Bitbucket Server for more information.