Adding a repository to a team space

You must add a repository to the team space when you want to create, modify, or store a system model.

Before you begin

You must have completed the following tasks:

Ensured that you are assigned a role as a Team Space Owner or an Architect in the team space. See Managing members and their roles in a team space.
Been provided valid credentials to access the Git repository that you want to add.

About this task

As a Team Space Owner or an Architect, you can add a repository to the team space. You can add a repository to the team space in any of the following methods:

Add an existing repository that can contain test assets, which are created in the desktop products.
Add a bare repository.

Attention: The repository that you want to add must not contain any projects or .project files under the root directory.

When you add a repository, the Git repository is cloned to the team space. While adding a repository, you must provide the necessary authentication credentials that are set for the Git repository. For example, if the authentication type is SSH, then you must provide the Git URL, a deploy key, and a passphrase.

Important: You can add only one repository to the team space. After you add a repository to the team space, the option to add another repository is not available. You must delete an existing repository before you can add a different repository.

Procedure

Log in to Rational® Test Automation Server.
Open the team space to which you want a team space repository.

The Active projects page is displayed.
Click the Settings icon from the left navigation pane, and then select Manage team space.

The Details page is displayed.
Click Repository on the left navigation pane.

The Repository page is displayed.
Click Add repository.

The Add repository dialog is displayed.
Enter the URL of the Git repository, which you want to add to the team space, in the Git Repository field.

The required fields are displayed based on the type of Git URL that you entered.

Enter the required credentials based on any of the following authentication methods configured in the repository.

To gain access to the repository, you must use any one of the authentication methods:


Authentication method	Credentials required
SSH	Deploy key Passphrase
HTTPS	User name Password
HTTP	User name Password

Notes:

You must have defined the authentication type and set the authentication credentials in the Git repository.
If you use SSH to connect to your remote repository and Rational® Test Automation Server displays an Auth Fail exception while using the deliver changes option, you can resolve this exception error by regenerating your SSH keys by using the -m PEM option.

Click Add.

The Git repository is added to the team space on Rational® Test Automation Server.
Note: Depending on the size of the repository you are cloning, it can take a few to several minutes to clone the repository.

What to do next

You can perform the following actions on the repository that you added:

Update the authentication credentials if they are changed in the Git repository configuration. See Updating the authentication credentials of the repository.
Refresh a repository to fetch and synchronize changes from the remote repository. See Refreshing repositories manually.
Configure a webhook to notify the server if there is a push event in the remote repository. See Creating webhooks.
Add a system model to the repository. See Creating a system model.
Delete a repository that is added to the team space, if it is no longer required. See .