Freigeben über

Verarbeiten eines Pull Requests

  • Artikel

Nachdem Sie eine Pull-Anforderung (PR) geöffnet haben, wird die PR einer Reihe von Prüfungen und Überprüfungen unterzogen, um sicherzustellen, dass Ihre vorgeschlagenen Änderungen zusammengeführt werden können. Weitere Hintergrundinformationen zu PRs finden Sie unter Git- und GitHub-Grundlagen.

Überprüfen

Bevor Ihre PR mit ihrer Zielverzweigung zusammengeführt werden kann, muss sie möglicherweise einen oder mehrere PR-Validierungsprozesse durchlaufen. Nachdem Sie "Pullanforderung erstellen" ausgewählt haben, führt GitHub die für Ihr Repository konfigurierten Überprüfungen aus. Nach Abschluss des Validierungsprozesses werden die Ergebnisse im PR angezeigt.

Validierungsprozesse variieren je nach Umfang der vorgeschlagenen Änderungen und den Regeln des Zielrepositorys. Nachdem Sie Ihren PR übermittelt haben, können Sie davon ausgehen, dass mindestens eine der folgenden Validierungen erfolgt:

  • Mergebarkeit: Zunächst wird ein grundlegender GitHub-Mergetest durchgeführt, um zu überprüfen, ob die vorgeschlagenen Änderungen in Ihrem Branch mit dem Zielbranch in Konflikt stehen. Wenn der PR darauf hinweist, dass der Test fehlgeschlagen ist, müssen Sie den Inhalt ausgleichen, der den oder die Konflikte beim Zusammenführen verursacht, bevor die Verarbeitung fortgeführt werden kann.
  • Lizenzvereinbarung für Mitwirkende (CLA): Wenn Sie als Nicht-Microsoft-Mitarbeiter einen Beitrag zu einem öffentlichen Repository leisten, werden Sie möglicherweise aufgefordert, eine kurze CLA auszufüllen, wenn Sie zum ersten Mal einen PR an dieses Repository senden. Nachdem der CLA-Schritt erfolgt ist, wird Ihr PR verarbeitet.
  • Bezeichnung: Bezeichnungen werden automatisch auf Ihren PR angewendet, um den Status Ihres PR anzugeben, während dieser den Validierungsworkflow durchläuft. Beispielsweise können neue PRs automatisch mit der Bezeichnung „do-not-merge“ versehen werden, die angibt, dass der PR die Validierungs-, Review- und Freigabeschritte noch nicht abgeschlossen hat.
  • Validierung und Erstellung: Automatische Prüfungen verifizieren, ob Ihre Änderungen die Validierungstests bestehen. Die Validierungstests führen möglicherweise zu Warnungen oder Fehlern, sodass Sie eine oder mehreren Dateien in Ihrem PR bearbeiten müssen, bevor dieser gemergt werden kann. Die Validierungstestergebnisse für das Review werden Ihrem PR als Kommentar hinzugefügt und möglicherweise per E-Mail an Sie gesendet.
  • Staging: Nach erfolgreicher Validierung und Erstellung werden die von Ihnen geänderten Artikel automatisch in einer Staging-Umgebung zur Überprüfung bereitgestellt. Vorschau-URLs erscheinen in einem PR-Kommentar.
  • Automatisches Mergen: Der PR kann automatisch gemergt werden, wenn er die Validierungstests bestanden hat und bestimmte Kriterien erfüllt. In diesem Fall müssen Sie nichts mehr tun.

Überprüfen und Adressfeedback

Nachdem alle PR-Verarbeitung abgeschlossen ist, sollten Sie die Ergebnisse überprüfen (z. B. PR-Kommentare, Buildergebnisse). ermitteln Sie, ob Sie weitere Änderungen vornehmen müssen, bevor Sie sich für die Zusammenführung abmelden. Möglicherweise müssen Sie Ihre Inhalte aus einem der folgenden Gründe ändern:

  • PR-Kommentare von Bearbeitern. Wenn ein PR-Prüfer Ihre PR überprüft hat, können sie Feedback über Kommentare senden, wenn noch offene Probleme oder Fragen vorhanden sind, die vor dem Zusammenführen behoben werden müssen.
  • Feedback von Peer-Prüfern.
  • Formatierungskorrekturen aufgrund von Renderingproblemen.
  • Überprüfungsfehler oder Warnungen.
  • Konflikte zusammenführen.

Wenn Sie Änderungen vornehmen müssen, können Sie Ihre Inhalte direkt in der PR bearbeiten oder zu VS Code zurückkehren, um Ihre Änderungen vorzunehmen. Wenn Sie fertig sind, übernehmen Sie die Änderungen an Ihrer Arbeitsverzweigung. Die PR wird automatisch mit Ihren Änderungen aktualisiert.

Jedes Mal, wenn Sie einen Commit zur gleichen Arbeitszweig hinzufügen, wird der Commit automatisch zur PR hinzugefügt. Bei jedem Commit führt das Veröffentlichungssystem die Überprüfungs- und Überprüfungsprozesse automatisch erneut aus.

Abmelde- und Kommentarautomatisierung

Wenn Sie alle Feedback- und Validierungsfehler behoben haben und Bereit für die Zusammenführung Ihrer Änderungen sind, ist es an der Zeit, sich bei Ihrer PR abzumelden, indem Sie einen neuen Kommentar erstellen, der gelesen wird #sign-off. Sie müssen den #sign-off Kommentar eingeben, um Ihre Änderungen zusammenzuführen. Selbst wenn alle Überprüfungen und Überprüfungen bestehen, sind Sie dafür verantwortlich, diesen Kommentar zu verwenden, um den PR-Prüfern und Repo-Administratoren mitzuteilen, dass Ihre Änderungen für die Zusammenführung bereit sind.

Wenn die Prüfer feststellen, dass Ihre PR problemfrei und abgemeldet ist, werden Ihre Änderungen mit dem Standardbranch zusammengeführt und die PR geschlossen.

Mit der Kommentarautomatisierung können Benutzer, die nicht über Schreibberechtigungen in einem Repository verfügen, eine Aktion auf Schreibebene ausführen, indem Sie einer PR die entsprechende Bezeichnung zuweisen. Wenn Sie in einem Repository arbeiten, in dem die Kommentarautomatisierung implementiert wurde, verwenden Sie die in der folgenden Tabelle aufgeführten Hashtag-Kommentare, um Bezeichnungen zu vergeben, Labels zu ändern oder einen PR zu schließen. Microsoft-Autoren werden auch per E-Mail zur Überprüfung und Abmeldung benachrichtigt, wenn Änderungen an ihren Artikeln vorgeschlagen werden.

Hashtagkommentar Was es tut
#sign-off Dieser Kommentar weist automatisch die Bezeichnung ready-to-merge zu, damit die Reviewer*innen im Repository wissen, dass der PR bereit fürs Review bzw. Mergen ist.

Wenn Sie nicht der oder die aufgeführte Autor*in sind und versuchen, einen PR für ein öffentliches Repository mit dem Kommentar #sign-off freizugeben, wird der PR mit einem Hinweis aktualisiert, dass nur der oder die Autor*in die Bezeichnung zuweisen kann.
#hold-off Dieser Kommentar entfernt die Bezeichnung ready-to-merge, falls Sie Ihre Meinung ändern oder einen Fehler machen. Im privaten Repository wird die Bezeichnung do-not-merge zugewiesen.
#please-close Dieser Kommentar schließt den PR, wenn Sie beschließen, dass die Änderungen nicht gemergt werden sollen.
#please-open Dieser Kommentar öffnet einen geschlossenen PR oder ein Issue wieder.

Veröffentlichung

Ihre PR muss von einem PR-Prüfer zusammengeführt werden, bevor die Änderungen in den nächsten geplanten Veröffentlichungslauf aufgenommen werden können. Normalerweise werden PRs in der Reihenfolge der Übermittlung geprüft und gemergt.

Nachdem Ihre Beiträge genehmigt und zusammengeführt wurden, werden sie vom Veröffentlichungsprozess übernommen. Je nach Team, das das Repository verwaltet, an dem Sie mitwirken, können die Veröffentlichungszeiten variieren. In der Regel erfolgt die Veröffentlichung jedoch mindestens einmal pro Wochentag. Es kann bis zu 45 Minuten dauern, bis Artikel nach der Veröffentlichung online erscheinen.

Sobald Ihre Änderungen veröffentlicht wurden, erscheinen sie auf Microsoft Learn. Dann können andere mit dem Lernen beginnen.

Nächste Schritte

Das ist alles! Sie haben einen Beitrag zum Inhalt von Microsoft Learn geleistet!