Adding a repository to a team space

You can add a repository to store your system model.

Before you begin

You must have been granted permission to access the repository.

About this task

As a Team Space Owner or an Architect, you can add a repository to the team space. 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.

After you log in, from the Home page, you can add a repository to the team space by following these steps.

Procedure

  1. Click Manage > Configuration.

    The Team Space Configuration page is displayed.

  2. Click the Repository tab.
  3. Click Add repository.

    The Add repository page is displayed.

  4. Enter the URL of the Git repository, which you want to add to the team space, in the Git Repository field.

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

  5. 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.
  6. 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.
  • Delete a repository if it is no longer required.
  • Refresh a repository to fetch and synchronize changes from the remote repository.
  • Configure a webhook to notify the server if there is a push event in the remote repository.
  • Add a system model to the repository.