View a markdown version of this page

Erstellen einer Pull-Anforderung - Amazon CodeCatalyst

Amazon CodeCatalyst ist nicht mehr offen für neue Kunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Wie migriert man von CodeCatalyst.

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.

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 du Änderungen festgeschrieben und an das Repository übertragen hast, kannst du einen Pull Request erstellen, der den Inhalt des Quell-Branches mit dem Inhalt des Ziel-Branches vergleicht.

Du kannst in der CodeCatalyst Amazon-Konsole einen Pull Request von einem bestimmten Branch, von der Pull-Requests-Seite oder von der Projektübersicht aus erstellen. Wenn du einen Pull Request von einem bestimmten Branch aus erstellst, werden automatisch der Repository-Name und der Quell-Branch 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, wann der Pull Request zusammengeführt oder geschlossen wird.

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, wird der angezeigte Unterschied zwischen der Revision des Pull Requests, den du ausgewählt hast, und dem Commit, der der Tipp des Ziel-Branches war, als du den Pull Request erstellt hast, angezeigt. Weitere Informationen zu Unterschieden und Merge-Basen in Git findest du unter git-merge-base in der Git-Dokumentation.

Du kannst beim Erstellen von Pull-Requests die Funktion „Beschreibung für mich schreiben“ verwenden, damit Amazon Q automatisch eine Beschreibung der in einem Pull Request 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 dieser Änderungen sowie eine optimale 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
Anmerkung

Bereitgestellt von Amazon Bedrock: AWS Implementiert eine automatische Missbrauchserkennung. Da die Features Beschreibung für mich schreiben, Inhaltszusammenfassung erstellen, Aufgaben empfehlen, Features mit Amazon Q erstellen oder zu einem Projekt hinzufügen und Probleme Amazon Q zuweisen mit Amazon-Q-Developer-Agent für die Softwareentwicklung auf Amazon Bedrock basieren, können Benutzer die in Amazon Bedrock implementierten Steuerelemente in vollem Umfang nutzen, um die Sicherheit und den verantwortungsvollen Umgang mit künstlicher Intelligenz (KI) durchzusetzen.

So erstellen Sie eine Pull-Anforderung

  1. Navigieren Sie zu Ihrem Projekt.

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

    • Wähle im Navigationsbereich Code, wähle Pull Requests und dann Create Pull Request aus.

    • Wähle auf der Repository-Startseite Mehr und dann Pull Request erstellen aus.

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

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

  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 übergebenen Code enthält.

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

  7. (Optional) Gib im Feld Beschreibung der Pull-Anfrage Informationen an, z. B. einen Link zu Problemen oder eine Beschreibung deiner Änderungen.

    Tipp

    Du kannst „Beschreibung für mich schreiben“ wählen, damit CodeCatalyst automatisch eine Beschreibung der im Pull Request enthaltenen Änderungen generiert wird. Du kannst Änderungen an der automatisch generierten Beschreibung vornehmen, nachdem du sie dem Pull Request hinzugefügt hast.

    Diese Funktion setzt voraus, dass generative KI-Funktionen für den Space aktiviert sind. Sie ist für Pull-Requests in verknüpften Repositorys nicht verfügbar. Weitere Informationen findest du unter Generative KI-Funktionen https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html 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 zu einem Problem aufzuheben, wählen Sie das Symbol zum Aufheben der Verknüpfung.

  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 Reviewer 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 Voraussetzung genehmigen, bevor der Pull Request mit dem Ziel-Branch zusammengeführt werden kann.

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

  12. Wenn du überzeugt bist, dass der Pull Request den Code und die Änderungen enthält, die du überprüfen möchtest, wähle Create.

    Anmerkung

    Nachdem du den Pull Request erstellt hast, kannst du 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, für das du einen Pull Request erstellen möchtest.

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

  3. Klicken Sie auf den Dropdown-Pfeil neben dem Standard-Branchnamen 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.

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

  5. Das Repository und der Quell-Branch sind für dich vorausgewählt. Wählen Sie im Ziel-Branch den Branch aus, in dem Sie den Code zusammenführen möchten, sobald er überprüft wurde. Gib 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 weitere Informationen in die Beschreibung des Pull-Requests ein, z. B. indem Sie einen Link zu verwandten Problemen einfügen oder eine Beschreibung der von Ihnen vorgenommenen Änderungen hinzufügen. CodeCatalyst

    Anmerkung

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

  6. Überprüfe die Unterschiede zwischen den Branches. Wenn keine Änderungen angezeigt werden, sind die Zweige möglicherweise identisch, oder Sie haben möglicherweise 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 zu einem Problem aufzuheben, wählen Sie das Symbol zum Aufheben der Verknüpfung.

  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 Reviewer müssen die Änderungen genehmigen, bevor der Pull Request mit dem Ziel-Branch zusammengeführt werden kann.

    Anmerkung

    Du kannst keinen Prüfer hinzufügen, da er sowohl erforderlich als auch optional ist. Du kannst dich selbst nicht als Rezensenten 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 Reviewer müssen die Änderungen nicht genehmigen, bevor der Pull Request mit dem Ziel-Branch zusammengeführt werden kann.

  10. Wenn du überzeugt bist, dass der Pull Request die Änderungen enthält, die du überprüfen möchtest, und die erforderlichen Reviewer enthält, wähle Create.

Wenn du Workflows so konfiguriert hast, dass sie dort ausgeführt werden, wo der Branch dem Ziel-Branch im Pull Request entspricht, findest du Informationen zu diesen Workflow-Ausführungen in der Übersicht im Bereich Pull Request-Details, nachdem der Pull Request erstellt wurde. Weitere Informationen finden Sie unter Hinzufügen von Triggern zu Workflows.