GitHub Action for Total Test


This section describes the process of setting up self-hosted runners with local and GitHub. 

Setup self-hosted runners with local and GitHub

Before you begin with your setup, see About self-hosted runners for information about running jobs in your GitHub Actions workflow.


Perform the following steps to setup the self-hosted runner: 

  1. Select the Settings tab from your repository.
    GitHubAction_1a.jpg

  2. Navigate to Actions > Runners in the menu bar. The Runners configuration screen is displayed. 
  3. Click New self-hosted runner to create a new runner.
    GitHubAction_2a.jpg
  4.  In the Runners / Create self-hosted runner screen, complete the setup by performing the required steps to download and setup locally.

Setup Workbench CLI locally

You must ensure the following, prior to setting up Workbench for Eclipse CLI locally:

  • Obtain a copy of the Workbench for Eclipse CLI, which is available in the Workbench for Eclipse installation package. If you do not have the installation package, visit BMC Support.

  • Follow the instructions and install Workbench for Eclipse CLI.
  • Record the installation location path. This path is required when executing test scenarios.

Plugins in marketplace

  1. Login to GitHub and navigate to Extend GitHub.

  2. Search for BMC and press Enter.
    image-2023-8-11_13-48-18.png
  3. Click BMC AMI DevX Total Test to view more information. 
  4. Download and install the plugin to execute Total Test Scenarios.

Configure and execute workflows

To configure and execute workflows, perform the following steps: 

  1. Click Actions > New Workflow. Select the Topaz for Total Test for input values option, and create a workflow.
  2. Click Run workflow and scroll to view all the workflow entries.
    GitHub workflow.png
  3. Enter the HCI Connection and Port information.
  4. Enter the Test Location Path of the Total Test Scenarios to be executed.

    Important

    The path for the Scenarios folder is the last part of the path to be used. For example: C:\Users\gflemmin\Compuware\Workbench\workspaceV20.13\CLITESTS\Tests\Scenarios

  5. Enter the Customized Workspace location of your Workbench for Eclipse CLI installation, including the workspace/configuration portion.
    For example: C:\CLIBUILDS\20.13.1\workspace\configuration
  6. Enter the Repository Server URL.
    For example: http://vw-dtw-xat-01.adprod.bmc.com:48231/totaltestapi/
  7. Enter the HCI User ID and Password.
  8. Click Run workflow. Ensure that your Runner is active to execute the workflow.
  9. From the menu, click build to view the following details:
    GitHubActions_ConfigureExecuteWorkflows_3.jpg

Expand the Calling the CLI function section to view the CLI log of the Test Scenario execution.

In this example, the Scenario results were saved in C:/Users/gflemmin/Compuware/Workbench/workspaceV20.13/CLITESTS/Tests/Output.

The location of the Output folder can be found in the CLI log.


     

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*