Configuring External Repositories (Git, SVN)

By default, Polarion uses the Subversion (SVN) repository that was configured by the installation program (Windows) or script (Linux). This "Default" repository is used for all projects by default. The assumption is that development code bases are managed in this same SVN repository. However, if you have code bases managed in another repository, you can configure your Polarion project to enable linking of Polarion Work Items (stored in the default repository) to revisions in the external repository.

Polarion supports revision links with external Subversion or Git repositories.

When your Polarion project is configured, users can link an external SVN or Git revision to a Polarion Work Item, either automatically by including the Work Item ID in the commit comment, or manually in the Linked Work Items table of a Work Item's detail. The user can select the external repository in the drop-down list, and use the Revision Picker dialog to select the revision, just as they can when linking to revisions in the default SVN repository. Revisions from an external repository appear in the same Linked Revisions table as revisions from Polarion's own SVN repository in the Work Item editor. They are differentiated visually by an icon.

Configuring the Project

The Repositories topic in project Administration enables you to specify one or more external repository(ies) so that revisions there can be linked to Polarion Work Items in the project. It is possible to configure more than one external repository, and external repositories can be of either supported type (SVN or Git).

To configure an external repository:

  1. Log in with administrator permissions for the project you want to configure to use an external repository, and open the project.

    Enter Administration if your login did not already take you into it.

  2. In Navigation, select RepositoriesConfiguration

  3. On the Configuration page, if there are no repositories configured yet, the Add New Repository button is present. Click it to begin configuring a new external repository.

    If one or more repositories are already configured, the Add below button appears in the Actions column of each repository. Click this button on any row to begin configuring a new external repository.

  4. In the Provider list, select the type repository you want to use with this project. When you select repository type, a set of fields specific to the selected type appears below the list control.

  5. Fill in the fields with data specific to the repository you want the Polarion project to access, noting the required fields marked with a red asterisk (*).

  6. Click the Save button to save the configuration settings.

Repeat the above procedure to configure additional external repositories. IMPORTANT: The Default SVN repository is always used by Polarion to store Work Items and other Polarion data. If you have source code for the project in this repository as well as in an external repository, then after adding the external repository(ies) to the configuration, you must explicitly add the Default repository back to the project configuration. If you don't, then users will not be able to link revisions in the default repository to Work Items.

To do this, begin adding a new repository as described in step 4 above, select Default in the Provider list, and save the change.

Note

Values for the user name and password for each repository are automatically encrypted and stored in the User Accounts Vault.

TIP

You can also adjust the following property in the polarion.properties file:

(It determines how frequently (in milliseconds) external repositories are polled for changes.)

The default value is 5000.

com.polarion.repository.pollingPeriod=5000
                

Important!

When using SSH keys on Linux, make sure that you place them in the following folder: /opt/polarion/data/.ssh

Note:

Symlinks are not supported.