Prerequisites to run tests in a GitHub Actions Workflow

Before you configure a test run for any test resources that are in a project repository of HCL OneTest™ Server, you must complete certain tasks to run the test resources in a GitHub Actions Workflow.

You must be familiar with creating projects and running test resources from HCL OneTest™ Server.

You must complete the following tasks to set up and use HCL OneTest™ Server:
  • Install HCL OneTest™ Server. See Installation of the server software.
  • Possess valid licenses to use HCL OneTest™ Server. See Management of licenses in HCL OneTest Server.
  • Create a project on HCL OneTest™ Server. See Adding a project.
  • Add a repository that contains test resources to the project repository. See Adding repositories to a server project.
  • Generate the Offline User Token on HCL OneTest™ Server that is required for connecting to HCL OneTest™ Server from another application such as the GitHub Action. See Managing access to HCL OneTest Server.
  • Open the project to view the details of the test resources that you want to run in a GitHub Actions Workflow. You must make a note of the test resource details from the Execution page of HCL OneTest™ Server.
    You must note the following details of the test resource that are to be provided in the YAML file for the GitHub Action:
    • The URL of the HCL OneTest™ Server instance.
    • The name of the team space that contains the project on HCL OneTest™ Server.
    • The name of the project on HCL OneTest™ Server that contains the test resources.
    • The branch name of the project repository that contains the test resources.
    • The ID of the test resource.
You must complete the following tasks outside of HCL OneTest™ Server:
  • Create an empty Git repository on any GitHub Enterprise server, if you do not already use Git repositories to store the test resources that you create. For more information about creating Git repositories, refer to Creating a new repository.
    If you already use Git repositories to store test resources created, you can use the same Git repositories.
    Note: You must have the required privileges in the Git repository to create a GitHub Actions Workflow.
  • Enable the GitHub Actions option in the Git repository, if it is not available as an option to use. For more information about enabling the GitHub Actions, refer to Learn about GitHub Actions.

You can continue to configure a run of a test, see Configuring a test run in a GitHub Actions Workflow.