Ein Spec-Validierungsjob führt die Testfälle eines Regelentwurfs (die zugehörige
.spec.md-Datei) gegen die CodeCharter-Engine aus und zeigt, welche Fälle
bestanden und welche fehlgeschlagen sind. Sie starten einen Job über die
Schaltfläche Specs ausführen im Portal-Regeleditor. Dabei werden
ungespeicherte Änderungen zuerst gespeichert und die Specs anschließend gegen
den aktuellen Entwurf ausgeführt, ohne etwas zu veröffentlichen. Außerdem
können Sie einen früheren Job von dieser Seite aus erneut starten (siehe
Aktionen).
Die Seite /spec-jobs listet alle Spec-Validierungsjobs Ihres Accounts. Hier lassen sich historische Ergebnisse prüfen, fehlgeschlagene Läufe neu starten oder Warteschlangen-Jobs abbrechen.
Tabellenspalten
| Spalte | Beschreibung |
|---|---|
| Job-ID | Kurzes Suffix der eindeutigen Job-ID (hover für die vollständige UUID). |
| Regel + Version | Regel-Slug und Entwurfs-Revision des Jobs. Der Slug verlinkt auf die Detailseite der Regel. Jobs ohne zugeordnete Regel zeigen Ad-hoc. |
| Status | Aktueller Verarbeitungsstatus (siehe unten). |
| Engine-Version | CodeCharter-Engine-Version, die den Job ausgeführt hat. |
| Dauer | Zeit vom Start des Jobs durch einen Worker bis zu seinem Abschluss. |
| Gestartet | UTC-Zeitstempel, wann ein Worker den Job übernommen hat (oder Einreihungszeit). |
Job-Status
- In der Warteschlange: wartet auf einen Worker.
- Läuft: ein Worker führt die Spec-Fälle gerade aus.
- Bestanden: alle Fälle erfolgreich.
- Fehlgeschlagen: ein oder mehrere Fälle haben ein unerwartetes Ergebnis geliefert.
- Timeout: der Job hat das Engine-Zeitlimit überschritten.
- Abgebrochen: manuell abgebrochen vor oder während der Ausführung.
- Fehler: der Worker ist auf einen nicht behebbaren Fehler gestoßen.
Filtern
Über die Filterleiste lässt sich die Ansicht einschränken:
- Status: nur Jobs in einem bestimmten Zustand anzeigen.
- Regel-Slug: nach Regel-Slug filtern (Teilübereinstimmung).
- Seit: nur Jobs ab diesem Datum anzeigen.
Anwenden klicken, um die Liste mit den aktuellen Filtern neu zu laden.
Aktionen
- Aktualisieren: Job-Liste manuell neu laden.
- Automatisch aktualisieren: alle 5 Sekunden auf neue Jobs prüfen.
- Erneut ausführen (fehlgeschlagene, Timeout- oder Fehler-Jobs): neuen Job für dieselbe Regel mit dem aktuellen Entwurf einreichen. Nur für Jobs mit zugeordneter Regel verfügbar; Ad-hoc-Jobs lassen sich nicht erneut starten.
- Abbrechen (Jobs in Warteschlange oder laufende Jobs): Job vor Abschluss abbrechen.
Die Liste zeigt 50 Jobs pro Seite; mit Zurück und Weiter unterhalb der Tabelle blättern Sie zwischen den Seiten.
Das Einreichen und Abbrechen von Spec-Jobs wird im Audit-Log Ihres Kontos festgehalten.