GitHub Action: Publish test results to the CloudBees platform

Use this action to publish test results if you are using a GitHub Actions (GHA) workflow. This action supports many popular testing tools, and enables testing results from running a GHA workflow to be displayed in the Test results tab of Run details and in the Test insights analytics dashboard.

View the action on the GitHub marketplace.

This action is a Preview feature and is not yet fully supported by CloudBees.

A Preview feature:

Has not undergone end-to-end testing with CloudBees products.
Is provided without service-level agreements (SLA), and therefore does not include CloudBees' commitment to functionality or performance.
May impact other stable areas of the product when used.
May have limited documentation.
May not be feature-complete during the Preview period.
May graduate from Preview to a supported feature or be removed from the product.
May introduce breaking changes that prevent upgrades due to incompatibility with future development.

Product features and documentation are frequently updated. If you find an issue or have a suggestion, please contact CloudBees Support.

Inputs

Table 1. Input details
Input name	Data type	Required?	Description
`cloudbees-pat`	String	Yes	The CloudBees platform personal access token.
`test-type`	String	Yes	The name of the testing tool^[1].
`folder-path`	String	Yes	The pattern, file, or directory path of the test report to convert.
`cloudbees-url`	String	No	The CloudBees platform URL. Typically, this value is `"https://api.cloudbees.io"`.

^[1] The testing tool name must be formatted correctly, in either all lowercase, or all uppercase.

Supported testing tools

Only the testing tools listed in the table below are supported for use in this action.

Use the given test-type input format to specify a testing tool.

Table 2. Supported testing tool names and `test-type` format
Supported tool name	Accepted `test-type` input formats
	lowercase	UPPERCASE
GO	`go`	`GO`
Jest	`jest`	`JEST`
JUnit	`junit`	`JUNIT`
MSTest	`mstest`	`MSTEST`
Playwright	`playwright`	`PLAYWRIGHT`
ProdPerfect	`prodperfect`	`PRODPERFECT`
Selenium	`selenium`	`SELENIUM`
TestNG	`testng`	`TESTNG`
Tosca	`tosca`	`TOSCA`

Usage examples

Basic example

The following is a basic example of using this action:

steps:
      - name: publish GHA run test results
        uses: cloudbees-gha-cbp/publish-test-results@v1
        with:
          cloudbees-pat: ${{ secrets.CloudBees-platform-PAT }}
          test-type: junit
          folder-path: /example-dir/my-test-results▼

Full workflow and run example

The following GHA workflow example uses this action to publish test results to the CloudBees platform.

Example GHA workflow YAML file

name: GHA Workflow

on:
    workflow_dispatch:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Compile code
        run: echo "Compiling..."

      - name: Produce binary
        run: sleep 10

      - name: Push binary
        run: echo "Pushing binary to ECR..."

      - name: Register build artifacts in Cloudbees platform
        uses: cloudbees-gha-cbp/register-build-artifact@v2
        id: go-action
        with:
          name: "GHA app"
          version: 1.0.0
          url: "docker.io/example:latest"
          digest: "sha256:1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr"
          type: "docker"
          cloudbees-url: "https://api.cloudbees.io"
          cloudbees-pat: ${{ secrets.CBP_PAT }}

  test:
    runs-on: ubuntu-latest
    needs: [build]   # Depends on 'build' job
    steps:
      - name: Run tests
        run: echo "Running tests..."

      - name: Checkout to collect test results
        uses: actions/checkout@v3

      - name: Publish test results in Cloudbees platform
        uses: cloudbees-gha-cbp/publish-test-results@v1
        with:
          test-type: GO
          folder-path: test_reports/*
          cloudbees-url: "https://api.cloudbees.io"
          cloudbees-pat: ${{ secrets.CBP_PAT }}

  deploy:
    runs-on: ubuntu-latest
    needs: [build,test]   # Depends on 'build' and 'test' jobs
    steps:
      - name: Checkout to prepare manifest
        uses: actions/checkout@v3

      - name: Trigger deployment
        run: echo "Invoking CBP deploy workflow..."▼

After the run has completed, the testing results are collected and displayed in the Test results tab of Run details and in the Test insights dashboard.

Figure 1. Example test results in Run details