Skip to main content

Run tests with a generic shell

Use this recipe when your CI provider does not have a dedicated page, or when you want one script that works in any pipeline. The script starts a Qodex run, polls until it finishes, and exits non-zero when the run fails or times out.

Before you start

You need:
  • A Qodex project with runnable scenarios.
  • A project API key from Settings > Platform > API keys.
  • bash, curl, and jq on the runner.

Add the script

Save this file at scripts/qodex-run.sh and make it executable.

Run it

Add it to any CI provider

The CI provider only needs to expose QODEX_PROJECT and QODEX_API_KEY as environment variables, then run the script as a normal step.
The job passes only when the Qodex run reaches completed. HTTP errors, failed runs, and timeouts fail the job.

Run tests via webhook

Run tests in CI