This is the documentation for Bamboo 5.7. View this page for the

Unknown macro: {spacejump}

of Bamboo, or visit the latest Bamboo documentation.

This page describes how to configure Bamboo to use a Perforce repository.

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

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

The recommended approach is to set up linked source repositories at the global level – see Linking to source code repositories.

Configure a Perforce source repository

  1. Navigate to the repository configuration for a linked repository, plan or job. See Linking to source code repositories.
  2. [リポジトリの追加] をクリックして新しいリポジトリを追加するか、既存のリポジトリ設定を編集します。
  3. Choose Perforce from the Source Repository list.
  4. Bamboo 内でリポジトリを識別するのに役立つ [表示名] を入力します。
  5. You can configure the following settings for a Perforce source repository for your plan:

このページの内容

ポート Type either the port to which the Perforce client will connect, or the Perforce server itself. This is the Perforce P4PORT environment variable that tells Bamboo which p4d (Perforce server) to use.
Client (Workspace) (3) The name of the Perforce Client Workspace which Bamboo will use. The Client Workspace determines which portions of the depot are visible in your Workspace Tree.
Do not create two Plans/Jobs that use the same client (e.g. one client set to manage, the other client set to not manage). This setup will create major issues in your builds.
Depot View The client view of the depot that contains the source code files for this Plan/Job. This is typically in the form //<clientname>/<workspace_mapping>/... For details please see the Perforce User's Guide.

Bamboo sets the client root to its working directory, which means that code will be checked out to the 'working directory/<workspace_mapping>' location. Please take note of this, when specifying the 'Artifact Copy Pattern' for your Build Artifacts.)

ユーザ名 The Perforce username that Bamboo will use when it accesses the server ('Port'). Leave this field blank if you want Bamboo to use the default Perforce user (i.e. the OS username).
パスワード Type the password required by the Perforce username (if applicable).
Let Bamboo manage your workspace (4) This field indicates whether or not you want Bamboo to manage your workspace.
Use Client Mapping For Change DetectionSelect this option if you use overlay mappings for your workspace. Your workspace must be available on the Bamboo Server

詳細オプション

Enable Quiet Period (待機期間を有効にする) 1 つのコミットが検出されてからビルドが開始されるまでの遅延を指定します。これによって、複数のコミットを 1 つのビルドに集約できます。
Include/Exclude Files (ファイルを含める/除外する)

Bamboo が変更を検出するために使用する (または使用しない) ファイルを指定できます。

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.

一般的な Web リポジトリ

    • Web リポジトリ URL - リポジトリの URL。
    • Web リポジトリ モジュール - 上記の [Web リポジトリ URL] が複数のリポジトリを指している場合に、この計画またはジョブに必要な特定のリポジトリ。
Stash - リポジトリの次の詳細を指定します。
    • Stash URL - Stash インスタンスの URL (例: https://stash.mycompany.com)。
    • Stash プロジェクト キー - Stash 内のプロジェクトのキー (例:「CONF」)。
    • リポジトリ名 - Stash 内のリポジトリの名前 (例:「conf-dev」)。

See Integrating Bamboo with Stash for more information.

FishEye – リポジトリの URL およびその他の詳細を指定します。

    • FishEye URL - FishEye リポジトリの URL (例:「 https://atlaseye.atlassian.com/ 」)。
    • リポジトリ名 - FishEye リポジトリの名前 (例:「Bamboo」)。これは事実上、リポジトリ パスのエイリアスです。
    • リポジトリ パス - FishEye リポジトリのパス (例:「/atlassian/bamboo/」)。

See Integrating Bamboo with FishEye for more information.

リポジトリのパスを特定する方法

If you have previously run builds with changes from your repository, the easiest way of determining your repository path is to view the code changes and copy the path from the start of the path of one of the changed files, up to (but not including) the appropriate root directory. The root directories for repositories are the ones shown by FishEye when browsing a repository (e.g. trunk)). For example, if a code change listed /atlassian/bamboo/trunk/bamboo-acceptance-test/pom.xml, the path would be /atlassian/bamboo/.
If you have not previously run builds with changes from your repository, you will need to ask your FishEye administrator for the repository path indexed by FishEye.

注意

  1. You will not be able to create plans or jobs that use a Perforce repository without specifying the shared local Perforce capability first. Read more about configuring a VCS capability .
  2. Keep your Perforce configuration up to date — If you are using Perforce as your repository, you must ensure your Perforce configuration in Bamboo is in sync with any changes to your Perforce repository (such as client, depot or user credential changes). If not, your Perforce repository changes may cause unexpected behaviour in Bamboo when Bamboo tries to access the repository. See the notes in the configuration instructions below for further details.
  3. Issue when running Bamboo with Perforce prior to Bamboo 2.0.7 — A known issue exists when running Bamboo with Perforce prior to Bamboo 2.0.7 (See BAM-2866 and BAM-2849). If you change the name of your Perforce client (i.e. via an update) without updating your Perforce configuration in Bamboo, Bamboo will not be able to find the Perforce client to run against. Perforce will then create a default client in your running directory. This can lead to situations where Bamboo will attempt to clear out data from your running directory (e.g. force build). To avoid this problem, ensure that you update the 'Client' in your Perforce configuration whenever you change your Perforce client.
  4. Please be aware of the following implications when either letting Bamboo manage or preventing Bamboo from managing your workspace:
    • If you let Bamboo manage your workspace,
      • We recommend this configuration if your Jobs will be running on many different machines or different operating systems, as Bamboo sets the client root for you.
      • Bamboo will make configuration changes to the Client Workspace to manage builds (e.g. Bamboo will modify the host and root). You need to ensure that you enter a Client Workspace in the 'Client' field that will be used solely for Bamboo.
      • Under this configuration, you should configure one client per Job to avoid conflicts when updating the client root.
    • If you do not let Bamboo manage your workspace,
      • We recommend this configuration if you wish to reuse your client for several Jobs, as Bamboo will retrieve the client root directory from Perforce and use it to run builds.
        (warning) Setting the client root in Perforce: We strongly recommend that you choose a directory that is dedicated for Bamboo's use only, when you are specifying the client root in your Perforce repository. This directory may get cleaned (i.e. files and sub-directories deleted) if you choose to force clean builds.
      • Under this configuration, you need to ensure that the client root directory exists on all machines that the Job will be built on.
      • Please note that alternate roots does not currently work in Bamboo. See issue BAM-2377 for further details.

 

 

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.