The instructions on this page describe how to configure a Subversion source repository for either a Plan or a Job. On this page:

Configuring a Subversion Source Repository

The instructions in this section apply to configuring a source repository for both Plans and Jobs.

To configure a Subversion repository:
If you are creating a new Plan or new Job, or have come from the Editing a Plan or Editing a Job topics, start at step 4.

1. Navigate to the source repository settings for a Plan or Job, as described on Specifying the Source Repository for a Plan and Specifying the Source Repository for a Job respectively.
   
2. Subversion Configuration
   • 
   • 'Repository' — select 'Subversion'.
   • 'Repository URL' — The location of your Subversion repository (e.g.

     http://svn.collab.net/repos/svn/trunk

     ). Note that you can use global variables in this field (see Using Global or Build-specific Variables).
     If you are importing a Maven 2 Project, this location should contain your project's pom.xml file.
   • 'Username' (Optional) — The Subversion username (if any) required to access the repository.
   • 'Authentication Type' — Select either 'Password', 'SSH' or 'SSL Client Certificate'.
     • If you select 'Password', the following fields will appear:
       • 'Password' (Optional) — Type the password required by the Subversion username (if applicable).
       • 'Change Password' (Only available after first saving the Plan/Job with a password) — Select this check box if you want to change the password that is used to access the Subversion repository.
     • If you select 'SSH', the following fields will appear:
       • 'Private Key' — Type the absolute path of your SSH private key.
       • 'Passphrase' — Type the passphrase for your SSH private key.
       • 'Change Passphrase' (Only available after first saving the Plan/Job with a passphrase) — Select this check box if you want to change the password for your SSH private key.'
         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.
     • If you select 'SSL Client Certificate', the following fields will appear:
       • 'Private Key' — Type the absolute path of your SSL client certificate.
       • 'Passphrase' — Type the passphrase for your SSL client certificate.
         Please note, the client certificate has to be in PKCS12 format and the client certificate file must be passphrase protected, otherwise a runtime exception is thrown by JDK security engine while opening the user key.
3. 
   • If you are importing a Maven 2 project, perform the following Advanced Options step and the Web Repository section of the Common Repository Configuration step below, before returning to the Enable this Plan section of Import a Maven 2 Project.
4. Advanced Options (The following fields will only appear if you select the 'Show Advanced Options' check box)
   • 'Enable Quiet Period:' (Only available when configuring an existing Plan) — Select this setting to set Quiet Period parameters for the Plan's build. Upon selecting this option, the following fields become available:
     • 'Quiet Period:' — This field will only display if 'Enable Quiet Period:' has been selected. This setting is used to avoid starting a build while someone is in mid-checkin. Bamboo will only initiate a build for this Plan when no more changes are detected within the Quiet Period following the last known change. Type the number of seconds Bamboo should wait.
     • 'Maximum Retries:' — You can specify how many times Bamboo should check for new changes using the Quiet Period parameter before initiating a build. For example, if you have set the 'Quiet Period' to '10' seconds then Bamboo will check if a checkout has occurred in the last 10 seconds. If you have then specified 'Maximum Retries:' as '5', then Bamboo will perform this check five times before initiating the build, regardless of any activity during the Quiet Period of the last check.
   • 'Detect Changes in Externals:' (Optional) — Select this check box if your Subversion repository uses svn:externals to link to other repositories (note that 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 references a particular (static) revision, you do not need to check this box.
5. 
6. 

Screenshot above: Source Repository — SVN

Appendix - Build Strategies

注意

• 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.

関連トピック

Specifying the Source Repository for a Plan
Specifying the Source Repository for a Job