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 DevOps Test Hub (Test Hub), 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 Test Hub.

You must complete the following tasks to set up and use Test Hub:
  • Install Test Hub. See Installation of DevOps Test Hub.
  • Possess valid licenses to use Test Hub. See Management of licenses in DevOps Test Hub.
  • Create a project on Test Hub. 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 Test Hub that is required for connecting to Test Hub from another application such as the GitHub Action. See Managing access to DevOps Test Hub.
  • 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 Test Hub.
    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 Test Hub instance.
    • The name of the team space that contains the project on Test Hub.
    • The name of the project on Test Hub 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 Test Hub:
  • 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.