The instructions on this page describe how to configure Bamboo to use a Subversion source repository.

On this page:

関連ページ

Configuring a Subversion source repository

Navigate to the source repository settings for a plan or job, as described on Specifying the source repository.

  1. [リポジトリの追加] をクリックして新しいリポジトリを追加するか、既存のリポジトリ設定を編集します。
  2. [ソース リポジトリ] リストから [Subversion] を選択します。
  3. Bamboo 内でリポジトリを識別するのに役立つ [表示名] を入力します。
  4. 計画の Subversion ソース リポジトリ用に以下の設定を設定できます。
リポジトリ URL

The location of your Subversion repository e.g.http://svn.collab.net/repos/svn/trunk(info) Note that you can use global variables in this field (see Using Global or Build-specific Variables).

(info) If you are importing a Maven 2 Project, this location should contain your project's pom.xml file.

ユーザ名(オプション) リポジトリにアクセスするために必要な Subversion ユーザー名 (ある場合)。
認証タイプ パスワード - ユーザー名とパスワードを使用して認証する場合は、このオプションを選択します。
SSH - SSH を使用して認証する場合は、次の詳細を入力する必要があります。
    • 秘密鍵 - SSH 秘密鍵の絶対パス。
    • パスフレーズ - SSH 秘密鍵のパスフレーズ。

(info) If you are planning to use remote agents the ssh private key file has to be copied to the agent box into the same location as specified.

SSL クライアント証明書 - SSL クライアント証明書を使用して認証する場合は、次の詳細を入力する必要があります。
    • 秘密鍵 - SSL クライアント証明書の絶対パス。
    • パスフレーズ - SSL クライアント証明書のパスフレーズ。

(info) クライアント証明書は PKCS12 形式であり、クライアント証明書ファイルはパスフレーズで保護されている必要があることにご注意ください。そうでない場合は、ユーザー キーを開いた際に JDK のセキュリティ エンジンによって実行時例外がスローされます。

詳細オプション

Detect Changes in Externals (外部項目の変更を検出)

Select this if your Subversion repository uses svn:externals to link to other repositories (your externals must be in the root of the checkout directory, not in a subdirectory). Please note that you only need to select this check box if you require Bamboo to detect changes in the externals. If your externals reference a particular (static) revision, you do not need to check this box.

Use SVN Export (SVN エクスポートを使用)このオプションを選択すると、最初のチェックアウトがスピードアップしますが、更新はサポートされていません。クリーン ビルドの強制を意味します。
Enable Commit Isolation (コミットの分離を有効にする)1 つのビルドに含まれる変更を 1 つだけにすることで、ビルドの失敗を切り分けることができます。
Automatically detect root URL for branches (ブランチのルート URL を自動検出)VCS ブランチング タスクで作成されたブランチの場所を自動で特定するかどうかを指定します。
Automatically detect root URL for tags (タグのルート URL を自動検出)VCS タグ付けタスクで作成されたブランチの場所を自動で特定するかどうかを指定します。
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」)。

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

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

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

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.

注意

  • If you are having problems connecting to Subversion, consult our documentation on troubleshooting Subversion connections.
  • If you use pre-1.5 Subversion client to access code checked out by Bamboo, you may encounter problems with your builds. This is due to the SVNKit upgrade in Bamboo 2.1.4. Please read this knowledge base article for further details.
  • SVNKit に -Dsvnkit.http.methods=Basic,NTLM システム プロパティを追加すると、Bamboo で NTLM 認証を使用できます。

12 Comments

  1. MattS

    May 09, 2008

    An example of a URL with a space in it would be good too.

    E.g. http://svn.collab.net/repos/svn/trunk/directory%20with%20spaces

  2. Anonymous

    Mar 23, 2009

    *Is it possible to specify more than one Repository URL? E.g., *http://abc/src/svn/unit1 and http://abc/src/svn/shared are both required to make a build.

    1. Anonymous

      Apr 09, 2010

      Any news on using multiple repository urls for product build?

      1. Anonymous

        Feb 18, 2011

        Yeah.  That would be great.

  3. Anonymous

    Jun 16, 2009

    The "Include /Exclude Files" option checks only file names, or absolute path, or path relative to working directory?

  4. Anonymous

    Jun 17, 2009

    Is it possible for a plan to share the same subversion checkout as another plan?. I need to perform extra operations in a generated ear file by a previous plan and it would be good to have access to those files.

  5. Terris Linenbach

    Jul 21, 2010

    Desperately seeking example of an "exclude" or "include" regular expression. I'm a programmer and I know what a regex is, but I have no idea what Bamboo is trying to match it against.

    Let's cut to the chase. The file is something like http://foo/blank/trunk/harness/etc/env/info.pm . What is the regex?

    1. Sam Kenny

      Aug 31, 2010

      I raised this with Atlassian Support.  This is the reply from Renan which works for me:

      This field uses Java Regex. An example would be the following:

      .*/src/.*|.*\.txt

      That would exclude files located ate a path containing "/src/" or ending with ".txt".
      To exclude ".txt" files you can use:

      .*\.txt

  6. John Harelius

    Nov 18, 2010

    In Bamboo 2.6 I could omit the username and password for accessing Subversion, and then the user running the Bamboo service was used. This was very convenient since you didn't need to bother about username and password for accessing Subversion when creating plans.

    I can't get this to work using Bamboo 2.7 though, have there been a change in the way subversion is accessed in Bamboo 2.7?

  7. Anonymous

    Jul 25, 2011

    For subversion SSH authentication the private key file must be in OpenSSH format.

    I run in windows and sa was trying to use a putty format key file (.ppk extension) and the error message wasn't very helpful. Fortunately the puttygen tool has the ability to save a key in OpenSSH format in "Conversions->Export OpenSSH key".

  8. Jijo John

    Sept 02, 2013

    Is it possible to checkout/export multiple svn url's to same workspace for build?

    1. Chris Pettifer

      Sept 02, 2013

      Yes, but you should use different checkout directories for them within the workspace.

      You configure your various repositories at the Plan level, then in the "Source Code Checkout" task you can use the "Add Repository" button to specify more than one repository location. But you must specify a "Checkout Directory" for all of your different checkouts (one can actually be blank, but it might be easier to put them all in directories).