CloudBees action: Run a GitHub Actions workflow

Use this action to trigger a GitHub Actions (GHA) workflow. GHA is an automation platform provided by GitHub.

All CloudBees action repositories are listed at CloudBees, Inc. on GitHub.

Inputs

Input name Data type Required? Description

url

String

The GitHub server URL. If not specified, uses https://api.github.com.

token

String

Yes

The GitHub token.

org-name

String

Yes

The GitHub organization name.

repo-name

String

Yes

The GHA repository name.

branch-name

String

Yes

The GHA branch name.

workflow-name

String

Yes

The GHA workflow name.

The GHA workflow name is the name attribute defined within the target GHA YAML file.

test-type

String

Specifies the test type for generating a job test report. Supported test types are JUnit (junit) and TestNG (testng).

test-result-location

String

Specifies the test report file location. Accepts pattern matching, such as my-dir/*/my-file.

parameters

JSON

Any additional parameters, formatted as JSON data in key/value pairs.

Usage example

In your YAML file, add:

jobs:
  run-gha-workflow:
    steps:
      - name: Run GHA workflow
        uses: cloudbees-io/ghactions-run-workflow@v2
        with:
          url: ${{ vars.GITHUB_URL }}
          token: ${{ secrets.GHA_TOKEN }}
          org-name: my_org
          repo-name: my_repo
          branch-name: main
          workflow-name: BUILD_PARAM
          test-type: Junit
          test-result-location: junit-service*
          parameters: '{"ENV_NAME":"TEST"}'▼