Configure Bamboo to use a Bitbucket Data Center repository.

Bamboo では、次のレベルでリポジトリを指定できます。

• グローバル - Bamboo のすべてのプランでリポジトリを利用できます。
• プラン - Bamboo プランのすべてのジョブでリポジトリを利用できます。
• ジョブ - Bamboo ジョブのすべてのタスクでリポジトリを利用できます。

推奨されるアプローチは、リンクされたソース リポジトリをグローバル レベルで設定することです。「ソース コード リポジトリへのリンク」を参照してください。

When you link a repository hosted in Atlassian's Bitbucket Data Center with a build plan in Bamboo, then without any further configuration:

• Bamboo will automatically run a build when changes are pushed to the Bitbucket Data Center 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 Data Center to see the commit diff for all files that are part of the changeset.
• Bitbucket Data Center commits that are part of a build are displayed in Bamboo.
• Build results are notified to Bitbucket Data Center (and displayed for the associated commits and pull requests).
  
  

Bitbucket Data Center and Bamboo only need to have been connected by creating an application link. Repositories in Bitbucket Data Center are then made available in Bamboo, so it is easy for you to link your Bamboo plan to a Bitbucket Data Center repository.

When you create a plan that uses a Bitbucket Data Center source repository, Bamboo will automatically use the Bitbucket Data Center repository to trigger the build when changes are committed trigger option instead of polling the repository for changes option. This reduces the load on the Bamboo and Bitbucket Data Centers because Bamboo doesn't need to send poll requests (for each branch of each plan) to the Bitbucket Data Center every 3 minutes (the default polling period). Instead, Bitbucket Data Center 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:

1. Either select Add repository to add a new repository, or edit an existing repository configuration.

2. Select Stash from the Repository host list.

3. Complete the required information:

   名前	A name that identifies this repository within Bamboo.
   Server	This menu will show all Bitbucket Data Centers that have been linked to Bamboo via an application link.
   リポジトリ	The repository that will be built. This menu will show all repositories on the Bitbucket Data Center that you have permission to access.
   ブランチ	Select a branch if you want to check out code from a branch other than the default branch.

   Advanced options

   Use shallow clones (shallow clone を使用する)	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 don't 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.
   サブモジュールを使用する	リポジトリにサブモジュールが定義されている場合に、サブモジュールのサポートを有効にするために選択します。エージェントにネイティブの Git 機能が定義されていない場合、サブモジュールのサポートは無効になります。
   SSH key applies to submodules	Bamboo will use the primary repository's SSH key for submodule authentication.
   コマンド タイムアウト	This helps to stop the 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.
   詳細なログ	Git コマンドからのより詳細なログを有効にします。Bamboo で Git に関する問題が発生した場合は、このオプションを使用してください。
   Fetch whole repository	Fetches whole repository instead of only one selected branch.
   Enable LFS support	Enables support for Git Large File Storage (LFS), which replaces large files such as audio samples, videos, datasets, and graphics with text pointers inside Git, while storing the file contents on a remote server. To use this option you must have the following: Git version 1.8.2 or later installed locally in your environment Git LFS 1.2 or later installed. To learn more about Git LFS, see Git LFS tutorials.
   Mirror	Allows you to use mirror locations for storing your repository data instead of using remote locations. Read more.

   Change detection options

   Enable quiet Period	1 つのコミットが検出されてからビルドが開始されるまでの遅延を指定します。これによって、複数のコミットを 1 つのビルドに集約できます。
   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. In File pattern, enter 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.

   Web repository options

   Web ブラウザでリポジトリを表示できる場合は、リポジトリの種類を選択します。

   This allows links to relevant files to be displayed in the Code changes section of a build result.

   Fisheye – specify the following details for the repository:

   • Fisheye URL — the URL of your Fisheye repository (e.g. ' https://atlaseye.atlassian.com/ ')
   • Repository Name — the name of your Fisheye repository (e.g. 'Bamboo'). This is effectively the alias for your repository path
   • Repository Path — the path for your Fisheye repository (e.g. '/atlassian/bamboo/')

   See Integrating Bamboo with Fisheye for more information.

   Bitbucket Data Center — see Integrating Bamboo with Bitbucket Data Center for more information.