Adding a repository to a team space

You must add a repository to the team space in HCL DevOps Test Hub (Test Hub) 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.

You can add a Git repository using SSH. 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. If the authentication type is SSH, then you must provide the Git URL, a deploy key, and a passphrase.

For example:
  • git@github.com:account/testRepo.git
  • ssh://git@10.111.111.333:2222/~/account/project.git
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 Test Hub.
    The Projects page of the initial team space is displayed.
  2. Click the Switch Team Space icon from the left navigation pane. Then, use the Switch to option to open the team space to which a team space respository is added.
  3. Click Manage > Configuration.
    The Configuration page of the team space is displayed
  4. Click Add Repository.
    The Add Repository dialog is displayed.
  5. Perform the action based on the selected repository type:
    The following table describes the actions required for each repository type:
    Repository type Action
    Remote Repository
    1. Enter the URL of the Git repository that you want to add to the team space in the Git URL field. The required fields are displayed based on the type of Git URL that you entered.
    2. 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 following authentication methods:
      • SSH: Deploy key and passphrase
      • HTTPS: Username and password
      • HTTP: Username and password
      Note:
      • 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 Test Hub 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.
    Local Repository

    Enter a unique repository name in the Repository Name field.

    Optional: Modify the default branch name in the Default Branch Name field. By default, the branch name is main.

    Note:
    • You cannot change the Local repository names after creation.
    • You can create and edit branches, create and edit assets, and publish changes locally in a local repository.
    • You can later push a local repository to a supported remote repository provider.
    • Ensure that the branch you are pushing from your local repository does not already exist in the remote repository. This helps avoid merge conflicts.
  6. Click Add.

Results

The Git repository is added to the team space on Test Hub.
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: