Glossar & Keyword-Referenz

Das Nachschlagewerk des Kurses. Begriffe und .gitlab-ci.yml-Keywords, auf die sich alle Lektionen beziehen. Zum Ausdrucken gemacht.

Verbindlich: Diese Begriffe werden in jeder Lektion einheitlich verwendet. Wenn ein Wort hier definiert ist, meint es überall im Kurs genau das.

Grundbegriffe

Pipeline: Der gesamte automatisierte Ablauf, der bei einem Ereignis (Push, Merge Request, Zeitplan) startet. Besteht aus Stages, die wiederum Jobs enthalten.
Job: Die kleinste ausführbare Einheit. Hat einen Namen und mindestens ein script. Läuft isoliert auf einem Runner. Mehrere Jobs im selben Stage laufen parallel.
Stage: Eine benannte Phase (z. B. build, test, deploy). Stages laufen nacheinander; der nächste Stage startet nur, wenn alle Jobs des vorherigen erfolgreich waren.
Runner: Der Agent (eine Maschine/Container), der Jobs tatsächlich ausführt. Wird über tags ausgewählt. Kann shared (von GitLab) oder selbst-gehostet sein.
.gitlab-ci.yml: Die YAML-Konfigurationsdatei im Repo-Wurzelverzeichnis, die die ganze Pipeline definiert. Name und Ort müssen exakt stimmen (Standardpfad).
Artifact: Dateien, die ein Job erzeugt und an spätere Jobs / zum Download weitergibt (z. B. Build-Output, Coverage-Report). Über artifacts deklariert.
Cache: Dateien, die zwischen Pipeline-Läufen wiederverwendet werden, um Zeit zu sparen (z. B. heruntergeladene Dependencies). Nicht garantiert vorhanden – nur ein Beschleuniger.
Environment: Ein benanntes Ziel, in das deployt wird (z. B. staging, production). GitLab trackt, welche Version wo läuft.

Wichtige `.gitlab-ci.yml`-Keywords

Ebene = wo das Keyword steht. Global = ganz oben in der Datei. Job = innerhalb eines Jobs.

Keyword	Ebene	Bedeutung
`stages`	Global	Namen & Reihenfolge der Stages.
`default`	Global	Standardwerte für Job-Keywords (z. B. image).
`variables`	Global/Job	CI/CD-Variablen definieren.
`workflow`	Global	Steuert, ob die Pipeline überhaupt läuft.
`include`	Global	Konfiguration aus anderen Dateien/Komponenten einbinden.
`stage`	Job	Ordnet den Job einem Stage zu.
`script`	Job	Shell-Befehle, die der Job ausführt. Pflicht.
`before_script`	Job	Befehle vor dem `script` (Setup).
`after_script`	Job	Befehle nach dem Job (auch bei Fehler).
`image`	Job	Docker-Image, in dem der Job läuft.
`services`	Job	Zusätzliche Container (z. B. Postgres) für den Job.
`tags`	Job	Wählt passende Runner aus.
`rules`	Job	Bedingungen: ob/wann/wie der Job läuft (modern).
`when`	Job	`on_success`, `manual`, `always`, …
`needs`	Job	Job früher starten als Stage-Reihenfolge erlaubt (DAG).
`artifacts`	Job	Erzeugte Dateien weitergeben.
`cache`	Job	Dateien zwischen Läufen wiederverwenden.
`environment`	Job	Deploy-Ziel benennen.
`parallel`	Job	Job mehrfach (auch als Matrix) ausführen.
`extends`	Job	Konfiguration von einem anderen Eintrag erben (DRY).
`allow_failure`	Job	Fehler erlaubt, Pipeline bleibt grün.
`retry`	Job	Job bei Fehler automatisch wiederholen.

Merksatz Artifact = weitergeben (Output). Cache = wiederverwenden (Beschleuniger). Verlass dich nie darauf, dass ein Cache da ist – aber ein Artifact eines erfolgreichen Jobs ist verlässlich.

← Zurück zu Lektion 1

Glossar & Keyword-Referenz

Grundbegriffe

Wichtige .gitlab-ci.yml-Keywords

Wichtige `.gitlab-ci.yml`-Keywords