Dokumentation

Wenn eine Aufgabe feststeckt oder fehlschlägt

Eine Fehlermeldung lesen und zwischen Wiederholen, Neuarbeiten, Pausieren und Abbrechen wählen.

Aufgaben schlagen fehl. Die meisten Fehler betreffen Konfigurationen oder Spezifikationen – es handelt sich nicht um etwas Geheimnisvolles – und lassen sich in wenige Kategorien einordnen.

Zuerst prüfen, wo der Prozess unterbrochen wurde.

Der Ausführungsbericht zeigt die fehlgeschlagene Phase an. Diese einzelne Information hilft bei der Ursachenfindung mehr als alles andere:

Fehlgeschlagen beiDas bedeutet fast immer
Noch bevor Code geschrieben wurdeDer Build- oder Installationsbefehl ist für einen sauberen Arbeitsbereich falsch.
Während der ÄnderungEs handelt sich um aufwendige Arbeit oder eine fehlende Abhängigkeit.
Tests ausführenDer Testbefehl ist falsch oder das Testpaket benötigt einen Dienst.
ÜberprüfungEin blockierender Prüfschritt; die Ergebnisse prüfen.
RezensionErgebnisse, die nicht automatisch korrigiert werden konnten.

Fehler vor dem Schreiben der Änderung betreffen die Konfiguration. Siehe dazu Build- und Testkonfiguration.

Wo der Prozess stoppte
Tests ausführen. Die Suite benötigt eine Datenbank, die in der sauberen Arbeitsumgebung fehlt.
Was zu ändern ist
Die Build- und Testkonfiguration des Projekts. Ein erneuter Versuch der Aufgabe ohne Änderungen führt zum gleichen Fehler.
Illustrative Fehlfunktion. Der Entwickler stoppte während der Testausführung, vor der Verifizierung – die Ausgabe weist auf eine fehlende Datenbank statt auf die Änderung hin.

Der Prozess ist nicht festgefahren, sondern wartet im Queue.

Eine Aufgabe in PENDING ist nicht festgefahren. Sie wartet auf einen freien Agenten-Slot. Prüfen Sie Kapazität zuerst – das ist der häufigste falsche Alarm.

Die Anwendung bittet Sie um eine Entscheidung.

NEEDS_HUMAN_REVIEW bedeutet, dass die Aufgabe auf eine Entscheidung stößt, die nur Sie treffen können. Das ist kein Fehler. Beantworten Sie die Frage, und der Prozess setzt dort fort, wo er unterbrochen wurde.

Antworten Sie präzise. Eine vage Antwort führt zu weiteren Vermutungen und erneutem Unterbrechen.

Die Ausführung dauert deutlich länger als erwartet.

Zwei übliche Ursachen:

Ein langsames oder hängendes Testpaket. Coroid führt Ihr Testpaket aus; wenn es in einem sauberen Arbeitsbereich hängt, wartet die Aufgabe. Rekonstruieren Sie den Fehler, indem Sie das Paket auf einem neuen Clone ausführen.

Die Spezifikation ist so breit gefasst, dass der Agent weiterhin neue Aufgaben findet. Ein Hinweis darauf ist eine wachsende Dateiliste. Brechen Sie den Prozess ab, begrenzen Sie den Umfang durch eine explizite Zeile für ausgeschlossene Bereiche und starten Sie erneut. Siehe dazu Spezifikationen.

Entscheiden, was zu tun ist

In aufsteigender Kostenordnung:

  • Antworten – für NEEDS_HUMAN_REVIEW. Am kostengünstigsten, behält den gesamten Kontext bei.
  • Neuarbeiten – die Arbeit ist korrekt, aber unvollständig. Die Aufgabe wird an den Entwickler-Agenten zurückgegeben, zusammen mit Ihren Ergebnissen und dem bestehenden Kontext.
  • Pausieren – Sie müssen zunächst etwas überprüfen. Der Slot wird dadurch frei; der Prozess ist fortsetzbar.
  • Wiederholen – nur für wirklich vorübergehende Fehler geeignet. Bei Konfigurationsproblemen führt ein erneuter Versuch nur zum gleichen Fehler.
  • Abbrechen und neu spezifizieren – der Ansatz oder der Umfang war falsch. Am kostspieligsten, aber oft die richtige Entscheidung.
  1. Antwort

    Für eine Frage. Behält den gesamten Kontext bei.

  2. Nachbearbeitung

    Richtig, aber unvollständig. Geht mit Ihren Ergebnissen zurück.

  3. Pause

    Sie müssen etwas prüfen. Der Slot wird freigegeben.

  4. Wiederholen

    Nur bei wirklich vorübergehenden Fehlern.

  5. Abbrechen und neu spezifizieren

    Der Ansatz oder Umfang war falsch.

GünstigsteTeuerste
Wählen Sie die günstigste Option, die die Ursache behebt. Ein erneuter Versuch ohne Änderungen hilft nur bei vorübergehenden Fehlern.

Fehler, die sich über mehrere Aufgaben hinweg wiederholen

Derselbe Fehler in derselben Phase bei unabhängigen Aufgaben deutet auf ein Projektkonfigurationsproblem hin – nicht auf ein Problem der einzelnen Aufgabe. Hören Sie auf, Aufgaben erneut auszuführen, und korrigieren Sie die Konfiguration.

Eine Release wird nach Abschluss der Aufgabe blockiert.

Eine abgeschlossene Aufgabe bedeutet, dass ihre Arbeit zur Überprüfung bereitsteht; dies sagt jedoch nichts über den ausgewählten Release-Commit oder die Bereitstellung aus. Auf der Seite Release wählen Sie das Umfeld aus und lesen Sie die Hindernisse für die Freigabe. Überprüfen Sie die Situation erneut, nachdem die Checkliste abgeschlossen wurde oder ein Lauf des Quality Graph abgeschlossen ist. Ein geänderter SHA, Umfang oder eine andere Richtlinie macht die alten Freigabekriterien und Genehmigungen ungültig. Falls eine Bereitstellung bereits läuft oder ihr Ergebnis unklar ist, prüfen Sie zuerst den Lauf des Providers, bevor Sie einen neuen anfordern.