Startseite › Entwickler-Tools › GitLab-CI-Konfigurationsgenerator

GitLab-CI-Konfigurationsgenerator

Wähle eine Vorlage und gestalte deine Pipeline per Formular: Stages, ein Standard-Image, ein Cache auf Basis der Lock-Datei und Jobs mit Skripten, Artifacts, JUnit-Berichten, Needs und Rules. Die .gitlab-ci.yml aktualisiert sich beim Tippen und wird auf häufige Fehler wie unbekannte Stages oder fehlerhafte Needs geprüft.

Zuletzt aktualisiert:

Pipeline

Jobs

.gitlab-ci.yml

    Anzeige
    Anzeige

    Anleitung: GitLab-CI-Konfigurationsgenerator

    1. Wähle eine Vorlage wie Node.js, Python oder Docker-Image, um mit sinnvollen Jobs zu starten.
    2. Lege die Pipeline-Grundlagen fest: die Liste der Stages, das Standard-Image, den Cache und globale Variablen.
    3. Bearbeite die Jobs: Name, Stage, Skriptzeilen und wann sie laufen. Öffne Weitere Optionen für Services, Needs, Berichte und Environments.
    4. Füge Jobs hinzu, dupliziere, sortiere oder lösche sie und sieh zu, wie sich Stage-Übersicht und YAML aktualisieren.
    5. Behebe alle roten Hinweise, kopiere oder lade die Datei herunter und committe sie als .gitlab-ci.yml im Stammverzeichnis des Repositorys.

    Wichtige Schlüsselwörter der .gitlab-ci.yml

    SchlüsselwortFunktionBeispiel
    stagesReihenfolge, in der Gruppen von Jobs laufen[test, build, deploy]
    defaultEinstellungen, die jeder Job erbt, etwa image, cache und interruptibleimage: node:20-alpine
    variablesUmgebungsvariablen für alle Jobs oder einen JobPIP_CACHE_DIR: "$CI_PROJECT_DIR/.cache/pip"
    scriptShell-Befehle, die der Job ausführt (erforderlich)- npm test
    before_scriptBefehle, die vor script in derselben Shell laufen- docker login …
    servicesZusätzliche Container, die während des Jobs verfügbar sindpostgres:16, docker:27-dind
    cacheDateien, die zwischen Pipelines wiederverwendet werden, um Downloadzeit zu sparenkey: {files: [package-lock.json]}
    artifactsJob-Ausgabe, die an spätere Jobs übergeben und zum Download aufbewahrt wirdpaths: [dist/], expire_in: 1 week
    needsStarten, sobald diese Jobs fertig sind, unabhängig von der Stage-Reihenfolgeneeds: [build]
    rulesEntscheidet, ob und wie ein Job zu einer Pipeline hinzugefügt wird- if: $CI_COMMIT_TAG
    environmentDeployments in eine Umgebung nachverfolgenname: production
    workflowRegeln, ob die gesamte Pipeline erstellt wirdDoppelte MR- und Branch-Pipelines vermeiden

    Nützliche vordefinierte CI/CD-Variablen

    VariableWert
    $CI_DEFAULT_BRANCHDer Standard-Branch des Projekts, meist main
    $CI_COMMIT_BRANCHBranch-Name in Branch-Pipelines (in Merge-Request- oder Tag-Pipelines nicht gesetzt)
    $CI_COMMIT_TAGTag-Name, nur in Tag-Pipelines
    $CI_PIPELINE_SOURCEWas die Pipeline gestartet hat: push, merge_request_event, schedule, web …
    $CI_COMMIT_REF_SLUGBranch- oder Tag-Name, sicher gemacht für URLs und Cache-Schlüssel
    $CI_COMMIT_SHORT_SHADie ersten 8 Zeichen des Commit-SHA, praktisch als Image-Tag
    $CI_PROJECT_DIRVollständiger Pfad, in den das Repository im Job geklont wird
    $CI_REGISTRY_IMAGEAdresse des Images in der Container-Registry des Projekts

    Tipps für schnellere, sicherere Pipelines

    • Lege Image-Versionen fest (node:20-alpine, nicht node:latest), damit ein neues Upstream-Release eine Pipeline nicht über Nacht kaputt machen kann.
    • Nutze needs, damit unabhängige Jobs parallel laufen, statt auf ganze Stages zu warten.
    • Gib Artifacts ein expire_in, damit alte Build-Ausgaben dein Speicherkontingent nicht füllen.
    • Veröffentliche Testergebnisse mit artifacts:reports:junit, um Fehler direkt in Merge Requests zu sehen.
    • Lass Deploy-Jobs auf dem Standard-Branch laufen und mach Produktions-Deploys manual, bis du der Pipeline vertraust.

    Häufige Fragen

    Wohin kommt die Datei .gitlab-ci.yml?

    Committe sie mit genau diesem Namen ins Stammverzeichnis deines Repositorys. GitLab erkennt sie beim nächsten Push und startet eine Pipeline mit den Shared- oder Projekt-Runnern, die dem Projekt zur Verfügung stehen. Du kannst sie in GitLab unter Build, Pipeline-Editor in der Vorschau ansehen und validieren.

    Was ist der Unterschied zwischen Stages und Needs?

    Stages laufen nacheinander: Jeder Job einer Stage wartet, bis alle Jobs der vorherigen Stage fertig sind. Mit needs kann ein Job starten, sobald die von ihm aufgeführten Jobs fertig sind, auch wenn andere Jobs früherer Stages noch laufen – das verkürzt Pipelines. Ein Job kann nur Jobs derselben oder einer früheren Stage benötigen.

    Worin unterscheidet sich Caching von Artifacts?

    Ein Cache beschleunigt Jobs, indem heruntergeladene Abhängigkeiten wie .npm oder .m2 zwischen Pipelines wiederverwendet werden, ist aber nicht garantiert und kann fehlen. Artifacts sind die Ausgaben eines Jobs, etwa ein dist-Ordner oder ein Testbericht, werden zuverlässig an spätere Jobs derselben Pipeline übergeben und bis zum Ablauf zum Download aufbewahrt.

    Warum cache:key:files mit einer Lock-Datei verwenden?

    Mit key: files bildet GitLab den Cache-Schlüssel aus dem Inhalt der aufgeführten Dateien, etwa package-lock.json. Der Cache wird wiederverwendet, bis sich die Abhängigkeiten ändern, und dann automatisch neu erstellt. Du kannst bis zu zwei Dateien angeben.

    Was bewirken die Workflow-Rules?

    Ohne sie kann ein Push auf einen Branch mit offenem Merge Request zwei Pipelines starten: eine Branch-Pipeline und eine Merge-Request-Pipeline. Die generierten Workflow-Rules führen Merge-Request-Pipelines aus, überspringen Branch-Pipelines, solange ein Merge Request offen ist, und führen Pipelines für andere Branches und Tags weiterhin aus.

    Wie verwende ich Secrets in der Pipeline?

    Schreib keine Passwörter oder Tokens in die .gitlab-ci.yml. Füge sie in GitLab unter Einstellungen, CI/CD, Variablen hinzu, markiere sie als maskiert und geschützt und verwende sie in Skripten als $MY_TOKEN. Vordefinierte Variablen wie $CI_REGISTRY_USER und $CI_REGISTRY_PASSWORD werden für die Container-Registry des Projekts automatisch bereitgestellt.

    Warum braucht ein Job ein Skript?

    Jeder normale Job muss einen script-Abschnitt mit mindestens einem Befehl haben; andernfalls lehnt GitLab die Konfiguration ab. Die einzigen Ausnahmen sind Trigger-Jobs, die eine andere Pipeline starten. Versteckte Jobs, deren Namen mit einem Punkt beginnen, sind Vorlagen für extends und laufen nicht.

    Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

    Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

    Ähnliche Tools

    Alle Code-Generatoren & Builder ansehen →