Erstellen einer Pull-Anforderung

Durch das Erstellen von Pull-Anforderungen können andere Benutzer Ihre Codeänderungen sehen und prüfen, bevor Sie diese mit einem anderen Branch zusammenführen. Zunächst erstellen Sie einen Branch für Ihre Codeänderungen. Dieser wird als Quell-Branch einer Pull-Anforderung bezeichnet. Nachdem Sie die Änderungen in das Repository übernommen und per Push übertragen haben, können Sie eine Pull-Anfrage erstellen, die den Inhalt des Quell-Branches mit dem Inhalt des Ziel-Branches vergleicht.

Sie können in der CodeCatalyst Amazon-Konsole einen Pull-Request von einem bestimmten Branch aus, von der Pull-Requests-Seite oder von der Projektübersicht aus erstellen. Wenn Sie einen Pull Request von einem bestimmten Branch aus erstellen, werden der Repository-Name und der Quell-Branch automatisch auf der Seite zur Erstellung von Pull-Requests angezeigt. Wenn du einen Pull-Request erstellst, erhältst du automatisch E-Mails über alle Aktualisierungen des Pull-Requests sowie darüber, ob der Pull-Request zusammengeführt oder geschlossen wurde.

Anmerkung

Während du einen Pull Request erstellst, ist der angezeigte Unterschied der Unterschied zwischen der Spitze des Quell-Branches und der Spitze des Ziel-Branches. Sobald der Pull Request erstellt wurde, besteht der angezeigte Unterschied zwischen der Revision des Pull-Requests, den du ausgewählt hast, und dem Commit, der bei der Erstellung des Pull-Requests der Tip des Ziel-Branches war. Weitere Informationen zu Unterschieden und Merge-Bases in Git finden Sie git-merge-basein der Git-Dokumentation.

Sie können beim Erstellen von Pull Requests die Funktion Beschreibung für mich schreiben verwenden, damit Amazon Q automatisch eine Beschreibung der in einer Pull-Anfrage enthaltenen Änderungen erstellt. Wenn Sie diese Option wählen, analysiert Amazon Q die Unterschiede zwischen dem Quell-Branch, der die Codeänderungen enthält, und dem Ziel-Branch, in dem Sie diese Änderungen zusammenführen möchten. Anschließend erstellt es eine Zusammenfassung der Änderungen sowie die beste Interpretation der Absicht und Wirkung dieser Änderungen. Diese Funktion ist nur in der Region USA West (Oregon) für CodeCatalyst Pull-Requests verfügbar. Die Funktion „Beschreibung für mich schreiben“ ist für Pull-Requests in verknüpften Repositorys nicht verfügbar.

Anmerkung

Bereitgestellt von Amazon Bedrock: AWS implementiert automatisierte Missbrauchserkennung. Da die Funktionen Beschreibung für mich schreiben und Inhaltszusammenfassung erstellen auf Amazon Bedrock basieren, können Benutzer die in Amazon Bedrock implementierten Kontrollen in vollem Umfang nutzen, um Sicherheit und den verantwortungsvollen Umgang mit künstlicher Intelligenz (KI) durchzusetzen.

Um eine Pull-Anfrage zu erstellen

1. Navigiere zu deinem Projekt.

2. Führen Sie eine der folgenden Aktionen aus:

   • Wählen Sie im Navigationsbereich Code, dann Pull Requests und dann Create Pull Request aus.

   • Wählen Sie auf der Repository-Startseite die Option Mehr und dann Pull-Request erstellen aus.

   • Wähle auf der Projektseite die Option Pull-Request erstellen aus.

3. Stellen Sie im Quell-Repository sicher, dass das angegebene Quell-Repository das ist, das den festgeschriebenen Code enthält. Diese Option wird nur angezeigt, wenn Sie den Pull-Request nicht von der Hauptseite des Repositorys aus erstellt haben.

4. Wählen Sie im Ziel-Branch den Branch aus, in den der Code nach der Überprüfung zusammengeführt werden soll.

5. Wählen Sie im Quellzweig den Zweig aus, der den festgeschriebenen Code enthält.

6. Geben Sie im Feld Titel der Pull-Anfrage einen Titel ein, der anderen Benutzern hilft zu verstehen, was überprüft werden muss und warum.

7. (Optional) Geben Sie unter Beschreibung des Pull-Requests Informationen wie einen Link zu Problemen oder eine Beschreibung Ihrer Änderungen ein.

   Tipp

   Du kannst Beschreibung für mich schreiben auswählen, damit CodeCatalyst automatisch eine Beschreibung der in der Pull-Anfrage enthaltenen Änderungen generiert wird. Sie können Änderungen an der automatisch generierten Beschreibung vornehmen, nachdem Sie sie dem Pull Request hinzugefügt haben.

   Diese Funktionalität setzt voraus, dass generative KI-Funktionen für den Space aktiviert sind und ist nicht für Pull-Requests in verknüpften Repositorys verfügbar. Weitere Informationen finden Sie unter Generative KI-Funktionen verwalten.

8. (Optional) Wählen Sie unter Probleme die Option Probleme verknüpfen aus und wählen Sie dann entweder ein Problem aus der Liste aus oder geben Sie dessen ID ein. Um die Verknüpfung eines Problems aufzuheben, wählen Sie das Symbol „Verknüpfung aufheben“.

9. (Optional) Wählen Sie unter Erforderliche Prüfer die Option Erforderliche Prüfer hinzufügen aus. Wählen Sie aus der Liste der Projektmitglieder aus, um sie hinzuzufügen. Erforderliche Prüfer müssen die Änderungen genehmigen, bevor der Pull-Request mit dem Ziel-Branch zusammengeführt werden kann.

   Anmerkung

   Sie können einen Prüfer nicht gleichzeitig als erforderlichen Prüfer und als optionalen Prüfer hinzufügen. Sie können sich nicht selbst als Prüfer hinzufügen.

10. (Optional) Wählen Sie unter Optionale Prüfer die Option Optionale Prüfer hinzufügen aus. Wählen Sie aus der Liste der Projektmitglieder aus, um sie hinzuzufügen. Optionale Prüfer müssen die Änderungen nicht als Anforderung genehmigen, bevor der Pull-Request mit dem Ziel-Branch zusammengeführt werden kann.

11. Überprüfe die Unterschiede zwischen den Branches. Der Unterschied, der in einem Pull Request angezeigt wird, besteht in den Änderungen zwischen der Revision im Quell-Branch und der Merge-Base, bei der es sich um den Head-Commit des Ziel-Branches zum Zeitpunkt der Erstellung des Pull-Requests handelt. Wenn keine Änderungen angezeigt werden, sind die Branches möglicherweise identisch, oder Sie haben denselben Branch sowohl für die Quelle als auch für das Ziel ausgewählt.

12. Wenn Sie überzeugt sind, dass der Pull Request den Code und die Änderungen enthält, die Sie überprüfen möchten, wählen Sie Create aus.

    Anmerkung

    Nachdem Sie den Pull Request erstellt haben, können Sie Kommentare hinzufügen. Kommentare können zum Pull-Request oder zu einzelnen Zeilen in Dateien sowie zum gesamten Pull-Request hinzugefügt werden. Du kannst Links zu Ressourcen wie Dateien hinzufügen, indem du das @-Zeichen gefolgt vom Namen der Datei verwendest.

Um einen Pull-Request von einem Branch aus zu erstellen

1. Navigiere zu dem Projekt, in dem du einen Pull Request erstellen möchtest.

2. Wählen Sie im Navigationsbereich Quell-Repositories und wählen Sie dann das Repository aus, das den Branch enthält, in dem Sie Codeänderungen überprüfen möchten.

3. Wählen Sie den Dropdown-Pfeil neben dem Standard-Branch-Namen und wählen Sie dann den gewünschten Branch aus der Liste aus. Um alle Branches für ein Repository anzuzeigen, wählen Sie Alle anzeigen aus.

4. Wähle Mehr und dann Pull-Request erstellen aus.

5. Das Repository und der Quell-Branch sind für Sie vorausgewählt. Wählen Sie im Zielzweig den Zweig aus, in dem Sie den Code zusammenführen möchten, sobald er überprüft wurde. Geben Sie im Feld Titel der Pull-Anfrage einen Titel ein, der anderen Projektbenutzern hilft zu verstehen, was überprüft werden muss und warum. Geben Sie optional in der Beschreibung des Pull-Requests weitere Informationen ein, z. B. indem Sie einen Link zu verwandten Problemen in CodeCatalyst einfügen oder eine Beschreibung der von Ihnen vorgenommenen Änderungen hinzufügen.

   Anmerkung

   Workflows, die so konfiguriert sind, dass sie für Ereignisse zum Erstellen von Pull-Requests ausgeführt werden, werden nach der Erstellung der Pull-Anfrage ausgeführt, wenn der Ziel-Branch für den Pull Request mit einem der im Workflow angegebenen Branches übereinstimmt.

6. Überprüfen Sie die Unterschiede zwischen den Branches. Wenn keine Änderungen angezeigt werden, sind die Zweige möglicherweise identisch, oder Sie haben denselben Zweig sowohl für die Quelle als auch für das Ziel ausgewählt.

7. (Optional) Wählen Sie unter Probleme die Option Probleme verknüpfen aus und wählen Sie dann entweder ein Problem aus der Liste aus, oder geben Sie dessen ID ein. Um die Verknüpfung eines Problems aufzuheben, wählen Sie das Symbol „Verknüpfung aufheben“.

8. (Optional) Wählen Sie unter Erforderliche Prüfer die Option Erforderliche Prüfer hinzufügen aus. Wählen Sie aus der Liste der Projektmitglieder aus, um sie hinzuzufügen. Erforderliche Prüfer müssen die Änderungen genehmigen, bevor der Pull-Request mit dem Ziel-Branch zusammengeführt werden kann.

   Anmerkung

   Sie können einen Prüfer nicht sowohl als erforderlich als auch als optional hinzufügen. Sie können sich nicht selbst als Prüfer hinzufügen.

9. (Optional) Wählen Sie unter Optionale Prüfer die Option Optionale Prüfer hinzufügen aus. Wählen Sie aus der Liste der Projektmitglieder aus, um sie hinzuzufügen. Optionale Prüfer müssen die Änderungen nicht genehmigen, bevor der Pull-Request mit dem Ziel-Branch zusammengeführt werden kann.

10. Wenn Sie überzeugt sind, dass der Pull Request die Änderungen, die Sie überprüfen möchten, und die erforderlichen Reviewer enthält, wählen Sie Create aus.

Wenn Sie Workflows so konfiguriert haben, dass sie ausgeführt werden, bei denen der Branch mit dem Ziel-Branch im Pull Request übereinstimmt, werden Ihnen nach der Erstellung des Pull Requests Informationen zu diesen Workflow-Ausführungen in der Übersicht im Bereich Pull-Request-Details angezeigt. Weitere Informationen finden Sie unter Hinzufügen eines Push-, Pull- oder Schedule-Triggers.