Skip to content

GitLab: Minimal Example

The simplest configuration for GitLab CI.


Step 1: Add a Variable

Settings โ†’ CI/CD โ†’ Variables โ†’ Add variable

Name Value Options
AI_REVIEWER_GOOGLE_API_KEY Your Gemini API key Masked
AI_REVIEWER_GITLAB_TOKEN Personal Access Token with api scope Masked

Step 2: Add a Job

.gitlab-ci.yml:

ai-review:
  image: ghcr.io/konstziv/ai-code-reviewer:1
  script:
    - ai-review
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"

CI/CD variables

AI_REVIEWER_GOOGLE_API_KEY and AI_REVIEWER_GITLAB_TOKEN are inherited automatically from project CI/CD variables โ€” no variables: section needed.


Step 3: Create an MR

Done! AI review will appear as comments on the MR.


What's Included

Feature Status
Notes on MR โœ…
Language adaptivity โœ… (adaptive)
Metrics โœ…
Auto-retry โœ…

Limitations

Limitation Solution
MR blocked on error Add allow_failure: true

PAT vs Project Access Token

Personal Access Token (PAT) works on all GitLab plans, including Free.

Project Access Token requires GitLab Premium/Ultimate. For the Free plan, always use a Personal Access Token.


Next Step

๐Ÿ‘‰ Advanced example โ†’