Was ist eine Pipeline?

Dein erstes .gitlab-ci.yml – eine echte App testet sich selbst.

Unser durchgehendes Beispiel

Statt „Hello World" begleitet uns durch den ganzen Kurs eine kleine, echte App: eine FastAPI-„Tasks"-API in Python – ein Service, der Aufgaben verwaltet. Das Repo enthält ungefähr das hier:

tasks-api/
├── app/
│   └── main.py          # die FastAPI-App
├── tests/
│   └── test_main.py     # pytest-Tests
├── requirements.txt
└── .gitlab-ci.yml       # ← darum geht es

Jedes Mal, wenn jemand Code pusht, soll GitLab automatisch prüfen: Ist der Code sauber formatiert? Laufen die Tests durch? Genau das ist die Aufgabe einer Pipeline.

Die vier Begriffe

Eine Pipeline besteht aus vier Bausteinen. Mehr brauchst du fürs Erste nicht:

• Pipeline – der gesamte Ablauf, der bei einem Push startet.
• Stage – eine Phase. Stages laufen nacheinander.
• Job – eine konkrete Aufgabe mit einem Skript. Jobs im selben Stage laufen parallel.
• Runner – die Maschine, die den Job tatsächlich ausführt.

Bildlich: die Pipeline ist das Fliessband, Stages sind die Stationen in fester Reihenfolge, und Jobs sind die Arbeiter, die an einer Station gleichzeitig anpacken.

Die erste .gitlab-ci.yml

Die ganze Pipeline lebt in einer einzigen YAML-Datei im Wurzelverzeichnis des Repos. Hier ist sie – Zeile für Zeile danach erklärt:

stages:
  - lint
  - test

default:
  image: python:3.12-slim

ruff:
  stage: lint
  script:
    - pip install ruff
    - ruff check app tests

pytest:
  stage: test
  script:
    - pip install -r requirements.txt
    - pytest -q

Was hier passiert

• stages: legt fest: erst lint, dann test. Die Reihenfolge zählt.
• default: image: – alle Jobs laufen im Docker-Image python:3.12-slim, sofern sie nichts anderes sagen. (Mehr zu image in einer späteren Lektion.)
• ruff: und pytest: sind die Namen der Jobs – frei wählbar.
• Jeder Job nennt sein stage: und ein script: – eine Liste von Shell-Befehlen.
• Schlägt ein Befehl im script fehl (Exit-Code ≠ 0), gilt der Job als rot – und die Pipeline stoppt.

Besonderheiten & Stolperfallen

Kurz prüfen (aus dem Kopf)

Nicht spicken – Abrufen aus dem Gedächtnis ist genau die Übung, die hängen bleibt.