Prerequisites to run tests in a GitHub Actions Workflow

Before you configure a test run for test resources, 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 in HCL OneTest™ API.

You must complete the following tasks to set up and use HCL OneTest™ API:
  • Install HCL OneTest™ API. See Installation.
  • Posses valid licenses to use HCL OneTest™ API. See Managing licenses.
  • Create tests in HCL OneTest™ API. See Tests: Overview and tasks.
  • Open the project to view the details of the test resources that you want to run in a GitHub Actions Workflow.
    You must note the following details of the test resource that are to be provided in the YAML file for the GitHub Action:
    • The path to the location where the HCL OneTest™ API project resides.
    • The name of the HCL OneTest™ API project.
    • The name of the environment that is configured in your HCL OneTest™ API project.
    • The name of the test in your HCL OneTest™ API project.
You must complete the following tasks outside of HCL OneTest™ API:
  • 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.
  • Set up self-hosted runners on your computer. For more information, refer to Adding self-hosted runners.

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