Zum Hauptinhalt springen

GitLab-Fehler beheben

Auf dieser Seite​

Ist eine Pipeline fehlgeschlagen, ist oft guter Rat teuer. Aber keine Sorge: Auf dieser Seite erklären wir Ihnen Schritt für Schritt, wie Sie der Fehlerursache auf die Spur kommen.

Zugriff auf das Verarbeitungsprotokoll​

Das Verarbeitungsprotokoll eines Jobs (in GitLab Job Log genannt) enthält im Fehlerfall die Ursache und damit auch einen Hinweis auf die Lösung für das Problem. Leider ist es extrem unübersichtlich. Unser Job-Lotse wertet dieses Protokoll für Sie aus, damit Sie sich nicht durch die technischen Details wühlen müssen.

Zunächst stellt sich jedoch die Frage, wie Sie an dieses Verarbeitungsprotokoll heran kommen. Hierzu stehen Ihnen zwei Wege zur Verfügung. Eine Beschreibung finden Sie in den beiden nachfolgenden Abschnitten.

Über die Gitlab-Oberfläche​

  1. Öffnen Sie im Merge Request den Abschnitt Pipelines (oder CI/CD → Pipelines)

  2. Klicken Sie auf das rote X der fehlgeschlagenen Pipeline, um die Pipeline-Details zu öffnen In der Pipeline-Ansicht sehen Sie die einzelnen Jobs. Auch dort ist ein rotes X am fehlgeschlagenen Job zu sehen:

    GitLab: Fehlgeschlagener Job in der Pipeline-Ansicht

  3. Klicken Sie in der Pipeline-Ansicht auf das rote X des fehlgeschlagenen Jobs, um das Verarbeitungsprotokoll zu öffnen

Über die Status-E-Mail Pipeline failed​

Bei einer fehlgeschlagenen Pipeline erhalten Sie eine Status-E-Mail, welche Ihnen diesen Sachverhalt mitteilt. Solche E-Mails erkennen Sie am Absender Gitlab und dem Text „Pipeline failed“ im Betreff. Der Inhalt sieht typisch so aus:

Inhalt der E-Mail bei fehlgeschlagenem Gitlab Job

Klicken Sie in der Mail auf den Link mit dem Namen des fehlgeschlagenen Jobs (unten rechts, im Bild rot markiert). Dieser öffnet das Verarbeitungsprotokoll des Jobs in einem neuen Fenster oder Tab Ihres Browsers.

Ursachensuche​

Suchen Sie im Verarbeitungsprotokoll nach der Fehlermeldung und der betroffenen Datei (Pfad) sowie Zeilennummer
In der Praxis hat es sich bewährt, zunächst ganz ans Ende des Verarbeitungsprotokolls zu springen und sich von dort langsam aufwärts zu bewegen.

Typische Fehlerursachen in Docusaurus-Projekten sind:

  • Nicht korrekt angegebene Link-Ziele (broken link, broken anchor)
  • Tippfehler in Pfaden, IDs oder Dateinamen (z. B. _ statt -)
  • Ein nicht geschlossener Codeblock (fehlende Abschluss-Markierung mit drei Backticks)
  • Ein nicht geschlossener MDX-Block (zum Beispiel fehlendes ::: am Ende einer Admonition)
  • Ungültiger Programmcode (JSX) in MDX (z. B. ein nicht geschlossenes Tag wie <Details>)

Korrigieren Sie den Fehler in der genannten Datei und committen Sie erneut, danach startet die Pipeline automatisch neu.

Das Verarbeitungsprotokoll automatisch erklären lassen​

Wenn Sie die Meldungen im Verarbeitungsprotokoll nicht direkt einordnen können, nutzen Sie unseren Gitlab Job-Lotsen.
Der Job-Lotse nutzt KI-Technologie, um die englischen technischen Fehlermeldungen für Sie ins Deutsche zu übersetzen, verständlich zusammenzufassen und mögliche Ursachen aufzuzeigen. Außerdem gibt Ihnen der Job-Lotse Tipps für Ihre nächsten Schritte.

Gitlab Job-Lotse

Sicher durch das Gitlab-Fehlerprotokoll.

Lade Eingabeoberfläche ...