Vordefinierte CI/CD-Variablen

Der Spickzettel der Variablen, die GitLab in jedem Job gratis bereitstellt. Zum Ausdrucken neben die Tastatur.

Merke: Diese Variablen musst du nie selbst setzen – GitLab füllt sie pro Job. Sie sind das Rückgrat von rules (Lektion 6), Registry-Login (Lektion 8) und Tagging.

Commit & Branch

Variable	Inhalt
`CI_COMMIT_SHA`	Voller Commit-Hash
`CI_COMMIT_SHORT_SHA`	Kurzer Commit-Hash – idealer Image-Tag
`CI_COMMIT_BRANCH`	Branch-Name (nur bei Branch-Pipelines)
`CI_COMMIT_TAG`	Tag-Name (nur bei Tag-Pipelines)
`CI_COMMIT_REF_SLUG`	URL-sicherer Branch/Tag-Name – gut für Umgebungsnamen
`CI_COMMIT_TITLE`	Erste Zeile der Commit-Message
`CI_DEFAULT_BRANCH`	Default-Branch des Projekts (meist `main`)

Pipeline & Auslöser

Variable	Inhalt
`CI_PIPELINE_SOURCE`	`push`, `merge_request_event`, `schedule`, `web`, `trigger` …
`CI_PIPELINE_ID`	Eindeutige Pipeline-ID
`CI_MERGE_REQUEST_IID`	MR-Nummer (nur in MR-Pipelines)

Projekt & Pfade

Variable	Inhalt
`CI_PROJECT_DIR`	Arbeitsverzeichnis – Cache-Pfade müssen hierin liegen
`CI_PROJECT_PATH`	`gruppe/projekt`
`CI_SERVER_FQDN`	Domain der GitLab-Instanz – für `include: component`

Container Registry

Variable	Inhalt
`CI_REGISTRY`	Hostname der Registry
`CI_REGISTRY_IMAGE`	Voller Image-Pfad dieses Projekts
`CI_REGISTRY_USER` / `_PASSWORD`	Temporärer Login (job-gebunden)
`CI_JOB_TOKEN`	Token für API/Registry im Namen des Jobs

Vollständige Liste Die offizielle, immer aktuelle Liste: docs.gitlab.com – Predefined variables.

← Zurück zu Lektion 4 · Glossar