Grundlegendes dazu, warum Ihre Pullanforderung blockiert ist
Repository-Administratoren und Organisationsinhaber können Quality Gates mithilfe von GitHub Code Quality festlegen. Wenn Sie eine Pullanforderung öffnen, werden Die Prüfungen automatisch ausgeführt, um Ihre Änderungen anhand dieser Standards auszuwerten.
Es gibt zwei Arten von Blöcken:
- Codequalitätsergebnisse: Ihre Änderungen führen zu Problemen, die unter den erforderlichen Qualitätsschwellenwert fallen.
- Schwellenwert für die Codeabdeckung: Ihre Änderungen führen dazu, dass die Codeabdeckung unter den erforderlichen Mindestwert fällt oder sich die Codeabdeckung im Vergleich zum Standard-Branch um mehr als den zulässigen Betrag verringert.
Diese Prüfungen tragen dazu bei, eine gesunde, wartungsfähige Codebasis aufrechtzuerhalten und zu verhindern, dass technische Schulden akkumuliert werden.
Beheben einer Codequalitätsbefundsperre
Wenn Ihr Pull Request Code einführt, der unter den erforderlichen Qualitätsgrenzwert fällt, wird unten im Pull Request im Abschnitt „Prüfungen“ ein Sperrbanner für das Zusammenführen angezeigt: „Das Zusammenführen ist blockiert: Es wurden Probleme bei der Codequalität erkannt.“
Das von Ihrem Repository-Administrator oder Organisationsinhaber festgelegte Quality Gate definiert den Mindestschweregrad, ab dem das Zusammenführen blockiert wird. Alle Befunde dieser oder einer höheren Schweregradstufe müssen behoben oder verworfen werden, bevor Sie mergen können. Wenn im Merge-Block-Banner kein Schweregrad angegeben ist, müssen in Ihrem Repository alle Befunde bearbeitet werden.
Um Ihre Pull Request zu entsperren, müssen Sie die Befunde beheben oder verwerfen, die den blockierenden Schweregrad erreichen oder überschreiten:
- Prüfen Sie die Kommentare, die
github-code-quality[bot]in Ihrem Pull Request hinterlassen hat. Jeder Kommentar wird nach Schweregrad bezeichnet (Fehler, Warnung, Hinweis). - Korrigieren oder verwerfen Sie die relevanten Befunde. Ausführliche Anweisungen findest du unter Beheben von Erkenntnissen zur Codequalität in einem Pull Request.
- Vergewissern Sie sich, dass das Banner zur Blockierung des Mergings im Abschnitt „Checks“ Ihres Pull Requests nicht mehr angezeigt wird.
Beheben einer Blockierung durch den Abdeckungsschwellenwert
Wenn Ihr Pull Request durch eine Regel für den Abdeckungsschwellenwert blockiert wird, sehen Sie im Abschnitt „Checks“ ein Banner zur Zusammenführungssperre mit einer Meldung, in der beschrieben wird, welcher Schwellenwert nicht erreicht wurde. Beispiel:
- „Die Abdeckung von 22,0 % liegt unter dem Minimum von 50,0 %“: Die Branch-Abdeckung Ihres Pull-Requests liegt unter dem im Regelsatz konfigurierten Mindestwert.
- „Die Abdeckung verringerte sich um 2,5 %, der maximal zulässige Rückgang ist 1,0 %“: Ihre Änderungen haben dazu geführt, dass die Abdeckung im Vergleich zum Standardzweig um mehr als den zulässigen Betrag gesunken ist.
Um die Blockierung Ihrer Pullanforderung aufzuheben, müssen Sie Tests hinzufügen oder ändern, damit mehr codebase ausgeführt wird:
- Überprüfen Sie den Zusammenfassungskommentar zur Abdeckung Ihrer Pull-Anforderung, um zu ermitteln, welche Dateien oder Bereiche keine Abdeckung haben.
- Hinzufügen oder Aktualisieren von Tests, um die Ausführungsabdeckung zu erhöhen. Copilot kann Ihnen dabei helfen, Ihre Tests zu schreiben und zu aktualisieren. Weitere Informationen findest du unter Testen von Code.
- Pushen Sie Ihre Änderungen. Die Abdeckungsprüfung wird automatisch erneut ausgeführt.