GitLab CI
xyva.ai connects to the GitLab API to give you a pipeline dashboard, job-level logs, artifact access, and merge request management without leaving the studio.
Access Token Setup
- In GitLab, go to Settings > Access Tokens (project or personal scope).
- Create a token with scopes:
api,read_repository,write_repository. - In xyva, open Settings > Integrations > GitLab and enter:
| Field | Example |
|---|---|
| GitLab URL | https://gitlab.example.com |
| Access Token | glpat-xxxxxxxxxxxxxxxxxxxx |
| Project ID | 42 |
WARNING
Use a project access token in CI environments to avoid leaking personal credentials. Rotate tokens every 90 days.
Pipeline Dashboard
The dashboard lists the most recent pipeline runs for the configured project, including:
- Status -- passed, failed, running, pending, cancelled
- Branch / Tag -- the ref that triggered the pipeline
- Duration -- wall-clock time from start to finish
- Triggered by -- user or schedule that initiated the run
Click any pipeline row to expand its stage and job breakdown.
Job Logs & Artifacts
Each job entry provides:
- Live log stream -- tails the job output while it runs.
- Full log download -- available once the job finishes.
- Artifact browser -- lists downloadable artifacts (JUnit XML, screenshots, traces).
TIP
xyva can parse JUnit XML artifacts and display results inline alongside your local Runner results, giving you a unified view of local and CI test outcomes.
Merge Requests
The MR panel shows open merge requests for the project. For each MR you can review:
- Title, author, and assignee
- Pipeline status of the source branch
- Diff stat (files changed, additions, deletions)
Triggering Pipelines
You can trigger a new pipeline run directly from xyva:
Branch: main
Variables: SUITE=smoke, HEADLESS=trueSelect the target branch, add optional CI variables, and click Run Pipeline. The dashboard refreshes automatically when the pipeline starts.
What To Read Next
- Git Overview -- local change monitoring and commit workflow
- GitHub -- GitHub-equivalent features
