Stash
Bamboo では、次のレベルでリポジトリを指定できます。
- グローバル - Bamboo のすべてのプランでリポジトリを利用できます。
- プラン - Bamboo プランのすべてのジョブでリポジトリを利用できます。
- ジョブ - Bamboo ジョブのすべてのタスクでリポジトリを利用できます。
推奨されるアプローチは、リンクされたソース リポジトリをグローバル レベルで設定することです。「ソース コード リポジトリへのリンク」を参照してください。
When you link a repository hosted in Atlassian's Stash (now 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 Stash 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 Stash to see the commit diff for all files that are part of the changeset.
- Stash commits that are part of a build are displayed in Bamboo.
- Build results are notified to Stash (and displayed for the associated commits and pull requests).
このページの内容
Stash and Bamboo only need to have been connected by creating an application link. Repositories in Stash are then made available in Bamboo, so it is easy for you to link your Bamboo plan to a Stash repository.
When you create a plan that uses a Stash source repository, with Stash 3.1 and later, Bamboo will automatically use the 'Stash 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 Stash servers because Bamboo doesn't need to send poll requests (for each branch of each plan) to the Stash server every 3 minutes (the default polling period). Instead, Stash 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:
表示名 A name that identifies this repository within Bamboo. Stash server This menu will show all Stash servers that have been linked to Bamboo via an application link. リポジトリ The repository that will be built. This menu will show all repositories on the Stash server that you have permissions to access. ブランチ 既定のブランチ以外のブランチのコードをチェックアウトする場合、ブランチを選択します。
Advanced optionsUse shallow clones (shallow clone を使用する) Bamboo で shallow clone を実行できるようにします (つまり、履歴は指定のリビジョン数に切り捨てられます)。これにより、最初のコード チェックアウトの速度が向上するはずですが、ビルドがリポジトリ全体の履歴に依存している場合は、このオプションを使用しないことをお勧めします。shallow clone は既定で有効になっています。 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 機能が定義されていない場合、サブモジュールのサポートは無効になります。 コマンド タイムアウト 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. 詳細なログ Git コマンドからのより詳細なログを有効にします。Bamboo で Git に関する問題が発生した場合は、このオプションを使用してください。 Fetch whole repository Fetches whole repository instead of only one selected branch. 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.
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 ビルドを開始しないチェンジセットのコミット メッセージに合うように正規表現を入力します。 Web repository Web ブラウザでリポジトリを表示できる場合は、リポジトリの種類を選択します。
This allows links to relevant files to be displayed in the 'Code Changes' section of a build result.
Stash – specify the following details for the repository: - Stash URL – the URL of your Stash instance (e.g. ' https://stash.mycompany.com ').
- Stash プロジェクト キー - Stash 内のプロジェクトのキー (例:「CONF」)。
- Repository Name – the name of the repository in Stash (e.g. 'conf-dev').
See Integrating Bamboo with Bitbucket Server for more information.