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.
  • Ensured that you obtained 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 you add 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

  1. Log in to HCL OneTest Server, if you are not already logged in.
  2. Open the team space to which you want a team space repository.

    The Active projects page is displayed.

  3. Click the Settings icon from the left navigation pane, and then select Manage team space.

    The Details page is displayed.

  4. Click Repository on the left navigation pane.

    The Repository page is displayed.

  5. Click Add repository.

    The Add repository dialog is displayed.

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

  7. 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
    • Username
    • Password
    HTTP
    • Username
    • 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 HCL OneTest 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.
  8. Click Add.
    The Git repository is added to the team space on HCL OneTest Server.
    Note: The time to clone the repository can take a few to several minutes and depends on the size of the repository.

What to do next

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