ENGINEERING

Pre-flight source-map check on GitLab merge requests

When a GitLab MR pipeline completes, it dry-run uploads the built source maps to a Sentry staging release and verifies symbolication before the MR can merge.

CategoryEngineering
Enginesim
Difficultyadvanced
Triggerevent
Steps5
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerGitLab MR pipeline success eventGitLabGitLab
  • ActionUpload MR build maps to staging Sentry releaseSentrySentry
  • LogicProbe symbolication and compare to expected paths
  • ActionSet passing or failing commit status on MRGitLabGitLab
  • OutputPost MR note with verification summaryGitLabGitLab

What it does

It catches broken source-map configuration before code ever reaches production. On each GitLab merge request pipeline, it pushes the MR's built artifacts to a throwaway Sentry release, validates that frames symbolicate, then writes the result back as an MR note and commit status so reviewers see green or red.

When to use it

Use it when source-map regressions (wrong `sourceMappingURL`, missing `release`, stripped maps) only surface after merge. This shifts the check left so the author fixes it in the MR, not in a postmortem.

How it works

  1. 1A GitLab pipeline-success event fires for an open merge request.
  2. 2The flow uploads the MR build's source maps to a temporary Sentry release named for the MR.
  3. 3A logic step runs a symbolication probe and compares resolved frames against expected source paths.
  4. 4On success it sets a passing commit status; on failure it sets a failing status.
  5. 5It posts an MR note summarizing artifact count, resolved frames, and any errors, then deletes the staging release.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect GitLabRepos, MRs, pipelines, registry.
  2. 2
    Connect SentryErrors, performance, releases.
  3. 3
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  4. 4
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  5. 5
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.