The instructions on this page describe how to configure a Mercurial source repository.

On this page:

Configuring a Mercurial Source Repository

Navigate to the source repository settings for a Plan or Job, as described on Specifying the Source Repository for a Plan. Choose to add a new or edit an existing repository and select Mercurial in the Source Control drop-down. 

Mercurial gives you the following options:

Repository URL

Type the full path to your Mercurial repository (eg: git://bitbucket.org/atlassian/bamboo-git-plugin.git)

Valid URLs are of the form:

  • local/filesystem/path[#revision]
  • file://local/filesystem/path[#revision]
  • http[s]://[user[:pass]@]host[:port]/[path][#revision]
  • ssh://[user[:pass]@]host[:port]/[path][#revision]

(for further references visit Mercurial documentation)

Branch  Type the name of the relevant branch (or tag) you want to work on. Leave empty to work on default branch.
UsernameType the username (if any) required to access the repository.
Authentication TypePasswordChoose password if you want to authenticate with a username and password.
Keyfile with passphraseUpload a private key and provide the corresponding SSH Passphrase.
Keyfile without passphrase

This type of authentication is similar to Keyfile with passphrase. However, authenticating without a passphrase is a bit faster. You will still have to Upload a private key.

Default Mercurial credentialsBamboo will rely on default hg authentication. Use this option, for example, if you had set up the Bamboo server manually with SSH servers defined in .ssh/config, valid SSH identity files, etc.

Advanced Options

Command timeout

Type the number of minutes bamboo should wait for hg commands to finish. This is useful to cut hung Mercurial processes. On the slower networks you may consider increasing default timeout to allow bamboo making initial clone of mercurial repository.

Verbose logsTurns on --verbose and --debug options in hg commands and pass the output to build logs. Use that option if you encounter problems in Bamboo Mercurial behaviour.
Location of POM file

Type the path to your project's pom.xml file which is relative to the root of your Mercurial Repository URL (defined above).

(Only available when importing a Maven 2 project) 


Screenshot above: Source Repository — Mercurial

Notes

Related Topics

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