Adding repositories to a server project

You can add repositories to a server project to access assets and resources available in the respective repository.

Before you begin

You must have completed the following tasks:
  • Added a project on HCL OneTest Server.
  • Been granted permission to access the repository.

About this task

As a project owner or a tester, you can add one or more repositories to your project. When you add a repository, the Git repository is cloned to your project. While adding a repository, you must provide the necessary authentication credentials that are set for the Git repository that you want to add to your project. For example, if the authentication type is SSH, then you must provide the Git URL, a deploy key, and a passphrase.

Procedure

  1. Log in to HCL OneTest Server and open the team space that contains your project.
  2. Open your project either from the left navigation pane or from the My Projects page.
  3. Click Manage from the left navigation pane.

    The Repositories page of the project is displayed.

  4. Click the Add repository button.

    The Add Repository dialog box is displayed.

  5. Enter the URL of the Git repository that you want to add to your project in the Git Repository field.
  6. 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 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.
  7. Click Add.
    The Git repository is added to your project in the team space.
    Note: Depending on the size of the repository that you are cloning, it can take a few to several minutes to clone the repository.
  8. Optional: Repeat the steps to add another 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 when there is a push event in the remote repository.