Guardrail-Ledger-Dokumentation

Das Gate und Ausnahmen

Das Gate entscheidet, ob ein Pull Request besteht. Eine Ausnahme verhindert bis zu ihrem Ablauf, dass ein akzeptierter Befund das Gate fehlschlagen lässt.

Das Gate festlegen

Ein Owner oder Admin öffnet die Seite Gates und legt fest:

Wählen Sie Save (Speichern). Das Ändern des Gates wird im Audit-Log festgehalten.

Das Ergebnis lesen

Jeder Lauf antwortet mit dem Gate-Ergebnis. Wenn das Gate blockiert, antwortet der Ingest-Aufruf mit Status 409, und der Schritt oder Job schlägt fehl, sofern Sie nicht failOnGate: false an der Task oder fail-on-gate: false an der Action setzen. Das Ergebnis wird außerdem in den Pull-Request-Kommentar und, auf GitHub, in die Job-Zusammenfassung geschrieben. Befunde bleiben unter Findings mit dem Repository und dem Pull Request, in dem sie gefunden wurden.

Ein Scan behebt nur die Befunde der Engines, die darin berichtet haben. Ein Befund, der nicht mehr erscheint, wird als behoben markiert.

Eine Ausnahme erfassen

  1. Ein Owner oder Admin öffnet die Seite Exceptions.
  2. Wählen Sie einen offenen Befund oder fügen Sie seinen Fingerprint ein.
  3. Wählen Sie den Verantwortlichen, ein Workspace-Mitglied, das nicht Sie selbst ist. Sie werden als Genehmiger erfasst.
  4. Schreiben Sie die Begründung und legen Sie das Ablaufdatum fest, höchstens 90 Tage ab heute.
  5. Wählen Sie Record exception (Ausnahme erfassen). Sie gilt sofort.

Ein ausgenommener Befund lässt das Gate nicht fehlschlagen. Nach dem Ablaufdatum zählt ihn der nächste Scan wieder für das Gate. Die Konsole hat keine Schaltfläche, um eine Ausnahme zu widerrufen.