Stash

はじめる前に

• Ensure that you are using a compatible version of Stash: Stash 2.11 or later is required.

• Configure an application link: If you have not previously configured an application link between your Bamboo and Stash servers, you will need to do so before you can add a linked repository. 

  See Linking to another application for more information. 

  We recommend that you use OAuth for authentication for your link. If you have an existing link that uses a different authentication type, you can also configure OAuth authentication for the link.

• Stash must have SSH access enabled: When you link to a Stash repository, Bamboo generates an SSH key pair that it shares with Stash. See Enabling SSH access to Git repositories in Stash. If you want to view the public SSH key in Stash, see SSH access keys for system use.

Linking to a Stash repository using the Administration menu

To link a new Stash repository using the Administration menu:

1. Click the  icon and select Overview.
2. Select Linked repositories (under Build Resources) to open the Linked source repositories window
3. Click Add repository and select Stash from the Repository host menu.

4. 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 options

   Use 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 機能が定義されていない場合、サブモジュールのサポートは無効になります。
   コマンド タイムアウト	これは、ハングした Bitbucket プロセスを停止するのに役立ちます。低速なネットワークでは、Bamboo が Git リポジトリの最初の複製を作成する時間を確保するため、既定のタイムアウトを長くすることを検討してください。
   詳細なログ	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 because by default Bamboo checks all the files. The same way,  if you configure the Exclude option, Bamboo will not consider the excluded files for 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 sub page for examples.
   Exclude changesets	Enter a regular expression to match the commit messages for changesets that should not start a build.
   Web リポジトリ	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 Stash for more information.