GitLab CI

This example pipeline runs Momentic on GitLab CI. More reference configs live in momentic-ai/examples. Given this root package.json:

package.json

{
  "name": "my-momentic-repo",
  "scripts": {},
  "devDependencies": {
    "momentic": "latest"
  }
}

Create a file called .gitlab-ci.yml in your repository with the following contents:

.gitlab-ci.yml

image: node:22
stages:
  - build
build:
  stage: build
  script:
    - npm install
    - npx momentic install-browsers --all
    - npx momentic run
  after_script:
    - npx momentic results upload test-results

Authentication

To run any commands, you must authenticate with Momentic. Add the MOMENTIC_API_KEY environment variable to your GitLab CI pipeline.

Create an API key in the Momentic dashboard.

Copy the value. You add it as a CI secret in the next step.

In your GitLab repository, click Settings, then CI/CD. Create a new variable called MOMENTIC_API_KEY and enter your API key.

Adding the MOMENTIC_API_KEY variable in GitLab

GitLab CI automatically loads environment variables stored in project settings into the CI environment. The CI file needs no changes.

Sharding

If you have a large test set, use sharding to run tests in parallel across CI jobs and shorten total run time. To shard your tests, pass the --shard-index and --shard-count options to the momentic run command. --shard-index is the index of the current shard (starting from 1), and --shard-count is the total number of shards. To collect test results inside a single run group in the Momentic dashboard, add a separate step after all tests complete to merge and upload results.

.gitlab-ci.yml

image: node:22
stages:
  - test
  - merge-results

test:
  stage: test
  script:
    - npm install
    - npx momentic install-browsers --all
    - npx momentic run --shard-index=$CI_NODE_INDEX --shard-count=$CI_NODE_TOTAL --output-dir test-results/shard-$CI_NODE_INDEX
  parallel: 2
  artifacts:
    paths:
      - test-results
    expire_in: 12 hours
    when: always

merge-results:
  stage: merge-results
  when: always
  dependencies:
    - test
  script:
    - npm install
    - npx momentic results merge --output-dir test-results/merged test-results
    - npx momentic results upload test-results/merged

Get started

Building with AI

Author

Run

Learn

Platforms

Integrations

Account

Authentication

Sharding

​Authentication

​Sharding

Authentication

Sharding