Verwenden von Pull-Anforderungen inAWS CodeCommitRepositories - AWS CodeCommit

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden von Pull-Anforderungen inAWS CodeCommitRepositories

Eine Pull-Anforderung ist die primäre Vorgehensweise, wie Sie und andere Repository-Benutzer Codeänderungen prüfen, kommentieren und über Branches hinweg zusammenführen können. Mit Pull-Anforderungen können Sie Codeänderungen auf kleine Änderungen oder Fehlerkorrekturen, größere Funktionserweiterungen oder neue Versionen Ihrer veröffentlichten Software gemeinsam prüfen. Hier finden Sie einen möglichen Workflow für eine Pull-Anforderung:

Li Juan, eine Entwicklerin, die ein Repository mit dem Namen MyDemoRepo verwendet, möchte an einer neuen Funktion für eine künftige Version eines Produkts arbeiten. Um ihre Arbeit vom produktionsbereiten Code zu trennen, erstellt sie für diese Arbeit einen Branch, der vom Standard-Branch abzweigt, und nennt diesen feature-randomizationfeature. Sie schreibt Code, führt Commits durch und überträgt den neuen Funktionscode auf diesen Branch. Sie möchte die Codequalität durch andere Repository-Benutzer überprüfen lassen, bevor sie ihre Änderungen in den Standard-Branch einfügt. Zu diesem Zweck erstellt sie eine Pull-Anforderung. Die Pull-Anforderung enthält den Vergleich zwischen dem Branch mit ihrer Arbeit und dem Branch mit dem Code, mit dem sie ihre Änderungen zusammenführen möchte (in diesem Fall der Standard-Branch). Sie kann außerdem eine Genehmigungsregel erstellen, die voraussetzt, dass die Pull-Anforderung von einer bestimmten Anzahl von Benutzern genehmigt wird. Und sie kann einen Genehmigungs-Pool von Benutzern angeben. Andere Benutzer prüfen ihren Code sowie die Änderungen und fügen Kommentare und Vorschläge hinzu. Als Reaktion auf Kommentare aktualisiert sie den Branch mit ihrer Arbeit möglicherweise mehrmals mit Codeänderungen. Ihre Änderungen werden jedes Mal in die Pull-Anforderung einbezogen, wenn sie diese auf den Branch in CodeCommit per Push überträgt. Sie kann zudem Änderungen einbeziehen, die im vorgesehenen Ziel-Branch vorgenommen wurden, während die Pull-Anforderung offen ist, sodass Benutzer sicher sein können, dass sie alle Änderungsvorschläge im Kontext sehen. Wenn sie und die Prüfer zufrieden sind und die Bedingungen für Genehmigungsregeln (falls vorhanden) erfüllt sind, führt sie oder einer der Prüfer den Code zusammen und schließt die Pull-Anforderung.

Erstellen einer Pull-Anforderung

Pull-Anforderungen erfordern zwei Branches: einen Quell-Branch mit dem Code, den Sie prüfen lassen möchten, und einen Ziel-Branch, mit dem der geprüfte Code zusammengeführt werden soll. Der Quell-Branch enthält den AFTER-Commit, bei dem es sich um den Commit mit den Änderungen handelt, die Sie mit dem Ziel-Branch zusammenführen möchten. Der Ziel-Branch enthält den BEFORE-Commit, der den Status des Codes repräsentiert, bevor der Pull-Anforderungs-Branch mit dem Ziel-Branch zusammengeführt wird. Die Wahl der Mergestrategie wirkt sich auf die Details aus, wie Commits zwischen den Quell- und Ziel-Branches in der CodeCommit-Konsole zusammengeführt werden. Weitere Informationen zu Mergestrategien in CodeCommit finden Sie unterZusammenführen einer Pull-Anforderung (-Konsole)aus.

Die Quell- und Ziel-Branches für eine Pull-Anforderung mit der Beziehung zwischen BEFORE- und AFTER-Commits

Die Pull-Anforderung zeigt die Unterschiede zwischen der Spitze des Source-Branch und dem neuesten Commit auf dem Ziel-Branch, auf dem die Pull-Anforderung erstellt wird, sodass die Benutzer Änderungen ansehen und kommentieren können. Sie können die Pull-Anforderung aufgrund der Kommentare mit weiteren Änderungen aktualisieren, indem Sie Commits für Änderungen durchführen und diese per Push auf den Quell-Branch übertragen.

Hinzufügen eines Kommentars zu einer Zeile in einer Pull-Anforderung.

Wenn Ihr Code geprüft wurde und die Genehmigungsregeln (falls vorhanden) erfüllt sind, können Sie die Pull-Anforderung auf verschiedene Arten schließen:

  • Führen Sie die Branches lokal zusammen und übertragen Sie Ihre Änderungen per Push. Damit wird die Anforderung automatisch geschlossenWenn die Mergestrategie mit Vorlauf verwendet wird und keine Mergekonflikte auftretenaus.

  • Verwenden Sie die AWS CodeCommit-Konsole, um die Pull-Anforderung zu schließen, ohne sie zusammenzuführen, Konflikte in einer Zusammenführung zu lösen oder die Branches mit einer der verfügbaren Merge-Strategien zu schließen und zusammenzuführen, wenn keine Konflikte vorliegen.

  • Verwenden Sie die AWS CLI.

Bevor Sie eine Pull-Anforderung erstellen, müssen Sie folgende Schritte ausführen:

  • Stellen Sie sicher, dass Sie die zu prüfenden Codeänderungen bestätigt und per Push an einen Branch (den Quell-Branch) übergeben haben.

  • Richten Sie Benachrichtigungen für Ihr Repository ein, sodass die Benutzer über die Pull-Anforderung und entsprechende Änderungen informiert werden. (Dieser Schritt ist zwar optional, wird aber empfohlen.)

  • Erstellen Sie Genehmigungsregelvorlagen mit dem Repository und ordnen Sie sie zu, damit automatisch Genehmigungsregeln für Pull-Anforderungen erstellt werden und die Code-Qualität sichergestellt bleibt. Weitere Informationen finden Sie unter Arbeiten mit Genehmigungsregelvorlagen .

Pull-Anforderungen sind effektiver, wenn Sie IAM-Benutzer für Ihre Repository-Benutzer in Ihrem Amazon Web Services Services-Konto eingerichtet haben. Das erleichtert das Identifizieren des Benutzers, der einen Kommentar abgegeben hat. Der andere Vorteil besteht darin, dass IAM-Benutzer Git-Anmeldeinformationen für den Repository-Zugriff verwenden können. Weitere Informationen finden Sie unter Schritt 1: Erstkonfiguration für CodeCommit . Sie können Pull-Anforderungen mit anderen Arten von Benutzern verwenden, einschließlich Benutzern mit verbundenem Zugriff.

Weitere Informationen zur Verwendung anderer Repository-Funktionen in CodeCommit finden Sie unterArbeiten mit Repositorien,Arbeiten mit Genehmigungsregelvorlagen,Arbeiten mit Dateien,Mit Commits arbeiten,Arbeiten mit Zweigen, undArbeiten mit Benutzereinstellungenaus.

Themen