Skip to main content

Run tests in GitLab CI

Use a GitLab CI job to trigger Qodex during merge requests and after changes land on main.

Before you start

You need:
  • A Qodex project with runnable scenarios.
  • A project API key from Settings > Platform > API keys.
  • Permission to add GitLab CI/CD variables.

Add CI/CD variables

In GitLab, open Settings > CI/CD > Variables.
  • QODEX_API_KEY: your qk_... key. Mark it masked and protected when appropriate.
  • QODEX_PROJECT: your Qodex project slug.

Add the job

Save this file as .gitlab-ci.yml.

Gate merge requests

Enable Pipelines must succeed in GitLab merge request settings. The Qodex job then becomes part of the merge gate.

Common adjustments

  • Use tags:["critical"] for a faster post-deploy check.
  • Remove tags to run the full active suite.
  • Add a separate deploy-time job that runs only after the deploy stage.

CircleCI recipe

Generic shell recipe