Amazon CodeCatalyst ist nicht mehr offen für Neukunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter [Wie migriert man von CodeCatalyst](migration.md). 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. # Speichern Sie Code mit Quell-Repositorys in und arbeiten Sie gemeinsam daran CodeCatalyst CodeCatalyst Quell-Repositorys sind Git-Repositorys, die in Amazon gehostet werden. CodeCatalyst Sie können Quell-Repositorys verwenden, CodeCatalyst um Ressourcen für ein Projekt sicher zu speichern, zu versionieren und zu verwalten. Zu den Ressourcen in einem CodeCatalyst Repository können gehören: + -Documents + Quellcode + binäre Dateien CodeCatalyst verwendet auch das Quell-Repository für ein Projekt, um Konfigurationsinformationen für Ihr Projekt zu speichern, z. B. Workflow-Konfigurationsdateien. Sie können mehr als ein Quell-Repository in einem CodeCatalyst Projekt haben. Möglicherweise möchten Sie beispielsweise separate Quell-Repositorys für Front-End-Quellcode, Back-End-Quellcode, Dienstprogramme und Dokumentation haben. Hier ist ein möglicher Workflow für die Arbeit mit Code in Quell-Repositorys, Pull-Requests und Entwicklungsumgebungen in: CodeCatalyst Mary Major erstellt ein Webanwendungsprojekt CodeCatalyst mithilfe eines Blueprints, der ein Quell-Repository mit Beispielcode erstellt. Sie lädt ihre Freunde Li Juan, Saanvi Sarkar und Jorge Souza ein, mit ihr an dem Projekt zu arbeiten. Li Juan schaut sich den Beispielcode im Quell-Repository an und beschließt, einige schnelle Änderungen vorzunehmen, um dem Code einen Test hinzuzufügen. Li erstellt eine Entwicklungsumgebung, wählt AWS Cloud9 sie als IDE aus und spezifiziert einen neuen Zweig,*test-code*. Die Entwicklungsumgebung wird geöffnet. Li fügt schnell den Code hinzu, überträgt dann den Branch mit den Änderungen und überträgt ihn in das Quell-Repository. CodeCatalyst Li erstellt dann eine Pull-Anfrage. Im Rahmen der Erstellung dieser Pull-Anfrage fügt Li Jorge Souza und Saanvi Sarkar als Reviewer hinzu, um sicherzustellen, dass der Code überprüft wird. Bei der Überprüfung des Codes erinnert sich Jorge Souza daran, dass er sein eigenes Projekt-Repository hat, das einen Prototyp der App enthält GitHub , an der sie gerade arbeiten. Er bittet Mary Major, die Erweiterung zu installieren und zu konfigurieren, die es ihm ermöglicht, das GitHub Repository als zusätzliches Quell-Repository mit dem Projekt zu verknüpfen. Mary überprüft das Repository auf GitHub und arbeitet mit Jorge zusammen, um die GitHub Erweiterung so zu konfigurieren, dass er das GitHub Repository als zusätzliches Quell-Repository für das Projekt verknüpfen kann. CodeCatalyst Quell-Repositorys unterstützen die Standardfunktionalität von Git und funktionieren mit Ihren vorhandenen Git-basierten Tools. Sie können persönliche Zugriffstoken (PATs) als anwendungsspezifisches Passwort erstellen und verwenden, wenn Sie Quell-Repositorys von einem Git-Client oder integrierten Entwicklungsumgebungen () klonen und damit arbeiten. IDEs Diese PATs sind mit Ihrer Benutzeridentität verknüpft. CodeCatalyst Weitere Informationen finden Sie unter [Gewähren Sie Benutzern Repository-Zugriff mit persönlichen Zugriffstoken](ipa-tokens-keys.md). CodeCatalyst Quell-Repositorys unterstützen Pull-Requests. Dies ist eine einfache Möglichkeit für dich und andere Projektmitglieder, Codeänderungen zu überprüfen und zu kommentieren, bevor du sie von einem Branch zum anderen zusammenführst. Sie können die Änderungen in der CodeCatalyst Konsole anzeigen und Codezeilen kommentieren. Durch Pushs an Branches in einem CodeCatalyst Quell-Repository kann automatisch eine Ausführung in einem Workflow gestartet werden, in dem Änderungen erstellt, getestet und bereitgestellt werden können. Wenn Ihr Quell-Repository als Teil eines Projekts mithilfe einer Projektvorlage erstellt wurde, werden ein oder mehrere Workflows als Teil des Projekts für Sie konfiguriert. Sie können jederzeit zusätzliche Workflows für Repositorys hinzufügen. Die YAML-Konfigurationsdateien für Workflows in einem Projekt werden in den Quell-Repositorys gespeichert, die in der Quellaktion für diese Workflows konfiguriert wurden. Weitere Informationen finden Sie unter [Erste Schritte mit Workflows](workflows-getting-started.md). **Topics** + [Konzepte für Quell-Repositorien](source-concepts.md) + [Einrichtung für die Arbeit mit Quell-Repositorys](source-setting-up.md) + [Erste Schritte mit CodeCatalyst Quell-Repositorys und dem Single-Page-Anwendungs-Blueprint](source-getting-started.md) + [Speichern von Quellcode in Repositorys für ein Projekt in CodeCatalyst](source-repositories.md) + [Organisation Ihrer Quellcode-Arbeit mit Filialen in Amazon CodeCatalyst](source-branches.md) + [Verwaltung von Quellcodedateien in Amazon CodeCatalyst](source-files.md) + [Code mit Pull-Requests in Amazon überprüfen CodeCatalyst](source-pull-requests.md) + [Änderungen im Quellcode mit Commits in Amazon verstehen CodeCatalyst](source-commits.md) + [Kontingente für Quell-Repositorys in CodeCatalyst](source-quotas.md) # Konzepte für Quell-Repositorien Im Folgenden finden Sie einige Konzepte, die Sie bei der Arbeit mit CodeCatalyst Quell-Repositorys kennen sollten. **Topics** + [Projekte](#project-concept) + [Quell-Repositorys](#source-repository-concept) + [Entwicklungsumgebungen](#devenvironment-concept) + [Persönliche Zugriffstoken (PATs)](#personal-access-token-concept) + [Branches](#branches-concept) + [Standardzweige](#default-branch-concept) + [Commits](#commits-concept) + [Pull-Anforderungen](#pull-request-concept) + [Überarbeitungen](#revision-concept) + [Arbeitsabläufe](#workflow-concept) ## Projekte Ein *Projekt* ist ein Gemeinschaftsprojekt CodeCatalyst , das Entwicklungsteams und Aufgaben unterstützt. Sobald Sie ein Projekt erstellt haben, können Sie Benutzer und Ressourcen hinzufügen, aktualisieren oder entfernen, Ihr Projekt-Dashboard anpassen und den Fortschritt der Arbeit Ihres Teams überwachen. Sie können mehrere Projekte in einem Bereich haben. Quell-Repositorys sind spezifisch für die Projekte, in denen Sie sie in einem Space erstellen oder verknüpfen. Sie können ein Repository nicht von mehreren Projekten gemeinsam nutzen und Sie können ein Repository nicht mit mehr als einem Projekt in einem Space verknüpfen. Benutzer mit der Rolle **Mitwirkender oder** **Projektadministrator** in einem Projekt können mit den Quell-Repositorys interagieren, die diesem Projekt zugeordnet sind, je nach den Berechtigungen, die diesen Rollen gewährt wurden. Weitere Informationen finden Sie unter [Zugriff mit Benutzerrollen gewähren](ipa-roles.md). ## Quell-Repositorys In einem *Quell-Repository* speichern Sie Code und Dateien für Ihr Projekt sicher. Es speichert auch den Versionsverlauf Ihrer Dateien. Standardmäßig wird ein Quell-Repository mit den anderen Benutzern in Ihrem CodeCatalyst Projekt geteilt. Sie können mehr als ein Quell-Repository für ein Projekt haben. Sie können Quell-Repositorys für Projekte in erstellen oder ein vorhandenes Quell-Repository verknüpfen CodeCatalyst, das von einem anderen Dienst gehostet wird, sofern dieser Dienst von einer installierten Erweiterung unterstützt wird. Sie können beispielsweise ein GitHub Repository mit einem Projekt verknüpfen, nachdem Sie die **GitHub Repository-Erweiterung** installiert haben. Weitere Informationen erhalten Sie unter [Speichern von Quellcode in Repositorys für ein Projekt in CodeCatalyst](source-repositories.md) und [Schnellstart: Erweiterungen installieren, Anbieter verbinden und Ressourcen verknüpfen in CodeCatalyst](extensions-quickstart.md). ## Entwicklungsumgebungen Eine *Entwicklungsumgebung* ist eine cloudbasierte Entwicklungsumgebung, mit der Sie schnell CodeCatalyst an dem Code arbeiten können, der in den Quell-Repositorys Ihres Projekts gespeichert ist. Die in Ihrer Entwicklungsumgebung enthaltenen Projekttools und Anwendungsbibliotheken werden durch eine Dev-Datei im Quell-Repository Ihres Projekts definiert. Wenn Sie keine Dev-Datei in Ihrem Quell-Repository haben, wird automatisch eine Standard-Dev-Datei angewendet. Die Standard-Devdatei enthält Tools für die am häufigsten verwendeten Programmiersprachen und Frameworks. Standardmäßig ist eine Entwicklungsumgebung so konfiguriert, dass sie über einen 2-Core-Prozessor, 4 GB RAM und 16 GiB persistenten Speicher verfügt. Sie können wählen, ob Sie einen vorhandenen Zweig Ihres Quell-Repositorys in Ihre Entwicklungsumgebung klonen möchten, oder Sie können wählen, ob Sie im Rahmen der Erstellung der Entwicklungsumgebung einen neuen Zweig erstellen möchten. ## Persönliche Zugriffstoken (PATs) Ein *Personal Access Token* (PAT) ähnelt einem Passwort. Es ist mit Ihrer Benutzeridentität verknüpft und kann in allen Bereichen und Projekten in verwendet CodeCatalyst werden. Sie verwenden PATs , um auf CodeCatalyst Ressourcen zuzugreifen, die integrierte Entwicklungsumgebungen (IDEs) und Git-basierte Quell-Repositorys umfassen. PATs vertreten Sie in CodeCatalyst und Sie können sie in Ihren Benutzereinstellungen verwalten. Ein Benutzer kann mehr als eine PAT haben. Persönliche Zugriffstoken werden nur einmal angezeigt. Es hat sich bewährt, sie sicher auf Ihrem lokalen Computer zu speichern. PATs Läuft standardmäßig nach einem Jahr ab. Bei der Arbeit mit integrierten Entwicklungsumgebungen (IDEs) entsprechen PATs sie einem Git-Passwort. Geben Sie die PAT an, wenn Sie nach einem Passwort gefragt werden, wenn Sie Ihre IDE für die Arbeit mit einem Git-Repository einrichten. Weitere Informationen darüber, wie Sie Ihre IDE mit einem Git-basierten Repository verbinden, finden Sie in der Dokumentation zu Ihrer IDE. ## Branches Ein *Branch* ist ein Zeiger oder eine Referenz auf einen Commit in Git und in CodeCatalyst. Du kannst Branches verwenden, um deine Arbeit zu organisieren. Sie können beispielsweise Zweige verwenden, um an einer neuen oder anderen Version von Dateien zu arbeiten, ohne dass sich dies auf Dateien in anderen Verzweigungen auswirkt. Sie können Branches verwenden, um neue Funktionen zu entwickeln, eine bestimmte Version Ihres Projekts zu speichern und vieles mehr. Ein Quell-Repository kann einen Branch oder mehrere Branches haben. Wenn Sie ein Projekt mithilfe einer Vorlage erstellen, enthält das für das Projekt erstellte Quell-Repository Beispieldateien in einem Zweig namens **main**. Der **Hauptzweig** ist der Standardzweig für das Repository. ## Standardzweige Quell-Repositorys CodeCatalyst haben einen Standard-Branch, unabhängig davon, wie Sie sie erstellen. Wenn Sie ein Projekt mithilfe einer Vorlage erstellen möchten, enthält das für dieses Projekt erstellte Quell-Repository neben Beispielcode, Workflow-Definitionen und anderen Ressourcen auch eine README.md-Datei. Wenn Sie ein Quell-Repository erstellen, ohne eine Vorlage zu verwenden, wird als erster Commit eine README.md-Datei für Sie hinzugefügt, und im Rahmen der Erstellung des Repositorys wird ein Standardbranch für Sie erstellt. *Dieser Standardzweig trägt den Namen main.* Dieser Standardzweig wird als Basis- oder Standardzweig in lokalen Repositorys (Repos) verwendet, wenn Benutzer das Repository klonen. Sie können ändern, welcher Branch als Standard-Branch verwendet wird. Weitere Informationen finden Sie unter [Den Standard-Branch für ein Repository verwalten](source-branches-default-branch.md). Sie können den Standardzweig für ein Quell-Repository nicht löschen. Die Suchergebnisse enthalten nur Ergebnisse aus dem Standardzweig. ## Commits Ein *Commit* ist eine Änderung an einer Datei oder einer Gruppe von Dateien. In der CodeCatalyst Amazon-Konsole speichert ein Commit Ihre Änderungen und überträgt sie in ein Quell-Repository. Der Commit enthält Informationen über die Änderung, einschließlich der Identität des Benutzers, der die Änderung vorgenommen hat, Uhrzeit und Datum der Änderung, den Commit-Titel und alle Nachrichten zu der Änderung. Weitere Informationen finden Sie unter [Änderungen im Quellcode mit Commits in Amazon verstehen CodeCatalyst](source-commits.md). Im Kontext eines Quell-Repositorys in CodeCatalyst sind Commits Schnappschüsse der Inhalte und Änderungen an den Inhalten Ihres Repositorys. Du kannst Commits auch Git-Tags hinzufügen, um bestimmte Commits zu identifizieren. ## Pull-Anforderungen Eine *Pull-Anfrage* ist die wichtigste Methode, mit der du und andere Benutzer Codeänderungen von einem Branch zum anderen in einem Quell-Repository überprüfen, kommentieren und zusammenführen. Du kannst Pull Requests verwenden, um Codeänderungen gemeinsam auf kleinere Änderungen oder Korrekturen, wichtige Funktionserweiterungen oder neue Versionen deiner veröffentlichten Software zu überprüfen. In einem Pull Request kannst du die Änderungen zwischen den Quell- und Ziel-Branches oder die Unterschiede zwischen den Versionen dieser Branches überprüfen. Du kannst Kommentare zu einzelnen Codezeilen sowie Kommentare zum gesamten Pull-Request hinzufügen. **Tipp** 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-base](https://git-scm.com/docs/git-merge-base)in der Git-Dokumentation. ## Überarbeitungen Eine *Revision* ist eine aktualisierte Version einer Pull-Anfrage. Jeder Push an den Quell-Branch einer Pull-Anfrage erstellt eine Revision, die die Änderungen enthält, die an den in diesem Push enthaltenen Commits vorgenommen wurden. Du kannst dir die Unterschiede zwischen den Versionen eines Pull-Requests sowie die Unterschiede zwischen den Quell- und Ziel-Branches ansehen. Weitere Informationen finden Sie unter [Code mit Pull-Requests in Amazon überprüfen CodeCatalyst](source-pull-requests.md). ## Arbeitsabläufe Ein *Workflow* ist ein automatisiertes Verfahren, das beschreibt, wie Sie Ihren Code als Teil eines CI/CD-Systems (Continuous Integration and Continuous Delivery) erstellen, testen und bereitstellen. Ein Workflow definiert eine Reihe von Schritten oder *Aktionen*, die während einer Workflow-Ausführung ausgeführt werden sollen. Ein Workflow definiert auch die Ereignisse oder *Auslöser*, die den Start des Workflows auslösen. Um einen Workflow einzurichten, erstellen Sie mit dem [visuellen Editor oder dem YAML-Editor](https://docs.aws.amazon.com//codecatalyst/latest/userguide/flows.html#workflow.editors) der CodeCatalyst Konsole eine *Workflow-Definitionsdatei*. **Tipp** Um einen schnellen Überblick darüber zu erhalten, wie Sie Workflows in einem Projekt verwenden könnten, [erstellen Sie ein Projekt mit einem Blueprint](https://docs.aws.amazon.com//codecatalyst/latest/userguide/projects-create.html#projects-create-console-template). Jeder Blueprint stellt einen funktionierenden Workflow bereit, den Sie überprüfen, ausführen und mit dem Sie experimentieren können. In einem Quell-Repository können auch die Konfigurationsdateien und andere Informationen für Workflows, Benachrichtigungen, Probleme und andere Konfigurationsinformationen für das Projekt gespeichert werden. Die Konfigurationsdateien werden erstellt und im Quell-Repository gespeichert, wenn Sie Ressourcen erstellen, für die Konfigurationsdateien erforderlich sind, oder wenn Sie das Repository als Quellaktion für einen Workflow angeben. Wenn Sie ein Projekt anhand eines Blueprints erstellen, sind die Konfigurationsdateien bereits im Quell-Repository gespeichert, das für Sie als Teil des Projekts erstellt wurde. Diese Konfigurationsinformationen werden in einem Ordner gespeichert, der `.codecatalyst` im Standardzweig Ihres Repositorys benannt ist. Immer wenn Sie einen Zweig des Standardzweigs erstellen, erstellen Sie zusätzlich zu allen anderen Dateien und Ordnern in diesem Zweig eine Kopie dieses Ordners und seiner Konfiguration. # Einrichtung für die Arbeit mit Quell-Repositorys Wenn Sie mit Quell-Repositorys in Amazon CodeCatalyst auf Ihrem lokalen Computer arbeiten, können Sie Git entweder eigenständig oder in einer unterstützten integrierten Entwicklungsumgebung (IDE) verwenden, um Codeänderungen vorzunehmen und Ihren Code zu pushen und abzurufen. Als bewährte Methode empfehlen wir, die neuesten Versionen von Git und anderer Software zu verwenden. **Anmerkung** Wenn Sie Dev Environments verwenden, müssen Sie Git nicht installieren. Eine aktuelle Version von Git ist in Ihrer Entwicklungsumgebung enthalten. **Informationen zur Versionskompatibilität für CodeCatalyst** | Komponente | Version | | --- | --- | | Git | brandneue | ## Installieren Sie Git Um mit Dateien, Commits, Branches und anderen Informationen in Quell-Repositorys von einem Git-Client ohne IDE aus zu arbeiten, installieren Sie Git auf Ihrem lokalen Computer. Um Git zu installieren, empfehlen wir Websites wie [Git Downloads](http://git-scm.com/downloads). ## Erstellen Sie ein persönliches Zugriffstoken Um Quell-Repositorys auf Ihrem lokalen Computer oder in Ihrer bevorzugten IDE zu klonen, müssen Sie ein Personal Access Token (PAT) erstellen. **Um ein Personal Access Token (PAT) zu erstellen** 1. Wählen Sie in der oberen Menüleiste Ihr Profil-Badge und dann **Meine Einstellungen** aus. **Tipp** Du kannst dein Benutzerprofil auch finden, indem du die Mitgliederseite für ein Projekt oder einen Bereich aufrufst und deinen Namen aus der Mitgliederliste auswählst. 1. Geben Sie im Feld **PAT-Name** einen aussagekräftigen Namen für Ihr PAT ein. 1. Behalten Sie im Feld **Ablaufdatum** das Standarddatum bei oder wählen Sie das Kalendersymbol, um ein benutzerdefiniertes Datum auszuwählen. Das Ablaufdatum liegt standardmäßig auf einem Jahr ab dem aktuellen Datum. 1. Wählen Sie **Erstellen** aus. Sie können dieses Token auch erstellen, wenn Sie **Repository klonen** für ein Quell-Repository wählen. 1. Speichern Sie das PAT-Geheimnis an einem sicheren Ort. **Wichtig** Das PAT-Geheimnis wird nur einmal angezeigt. Sie können es nicht abrufen, nachdem Sie das Fenster geschlossen haben. # Erste Schritte mit CodeCatalyst Quell-Repositorys und dem Single-Page-Anwendungs-Blueprint Folgen Sie den Schritten in diesem Tutorial, um zu erfahren, wie Sie mit Quell-Repositorys in Amazon CodeCatalyst arbeiten. Der schnellste Weg, um mit der Arbeit mit Quell-Repositorys in Amazon zu beginnen, CodeCatalyst besteht darin, ein Projekt mithilfe einer Vorlage zu erstellen. Wenn Sie ein Projekt mithilfe einer Vorlage erstellen, werden Ressourcen für Sie erstellt, einschließlich eines Quell-Repositorys, das Beispielcode enthält. Sie können dieses Repository und dieses Codebeispiel verwenden, um zu lernen, wie Sie: + Die Quell-Repositorys eines Projekts anzeigen und deren Inhalt durchsuchen + Erstellen Sie eine Entwicklungsumgebung mit einem neuen Zweig, in dem Sie an Code arbeiten können + Ändern Sie eine Datei und übertragen Sie Ihre Änderungen und übertragen Sie sie + Erstelle einen Pull-Request und überprüfe deine Codeänderungen mit anderen Projektmitgliedern + Sieh dir an, wie der Workflow für dein Projekt die Änderungen automatisch im Quell-Branch des Pull-Requests erstellt und testet + Führe deine Änderungen aus deinem Quell-Branch mit dem Ziel-Branch zusammen und schließe den Pull Request + Sieh dir an, wie die zusammengeführten Änderungen automatisch erstellt und bereitgestellt werden Um das Beste aus diesem Tutorial herauszuholen, laden Sie andere zu Ihrem Projekt ein, damit Sie gemeinsam an einem Pull-Request arbeiten können. Sie können sich auch mit zusätzlichen Funktionen vertraut machen CodeCatalyst, z. B. Probleme erstellen und sie einer Pull-Anfrage zuordnen oder Benachrichtigungen konfigurieren und Benachrichtigungen erhalten, wenn der zugehörige Workflow ausgeführt wird. Eine vollständige Erläuterung von finden Sie CodeCatalyst unter[Tutorials für die ersten Schritte](getting-started-topnode.md). ## Ein Projekt mit einem Blueprint erstellen Die Erstellung eines Projekts ist der erste Schritt, um zusammenarbeiten zu können. Sie können einen Blueprint verwenden, um Ihr Projekt zu erstellen. Dabei wird auch ein Quell-Repository mit Beispielcode und einem Workflow erstellt, der Ihren Code automatisch erstellt und bereitstellt, wenn Sie ihn ändern. In diesem Tutorial führen wir Sie durch ein Projekt, das mit dem **einseitigen Anwendungs-Blueprint** erstellt wurde. Sie können jedoch die Verfahren für jedes Projekt mit einem Quell-Repository befolgen. Stellen Sie sicher, dass Sie eine IAM-Rolle auswählen oder eine IAM-Rolle hinzufügen, falls Sie bei der Erstellung des Projekts noch keine haben. Wir empfehlen, dass Sie die **CodeCatalystWorkflowDevelopmentRole-*spaceName***Servicerolle für dieses Projekt verwenden. Wenn Sie bereits ein Projekt haben, können Sie weitermachen mit[Die Repositorys für ein Projekt anzeigen](#source-getting-started-source-view). **Anmerkung** Nur Benutzer mit der Rolle Space-Administrator oder **Poweruser** können Projekte in erstellen CodeCatalyst. Wenn Sie diese Rolle nicht haben und für dieses Tutorial ein Projekt benötigen, an dem Sie arbeiten können, bitten Sie jemanden mit einer dieser Rollen, ein Projekt für Sie zu erstellen und Sie dem erstellten Projekt hinzuzufügen. Weitere Informationen finden Sie unter [Zugriff mit Benutzerrollen gewähren](ipa-roles.md). **Um ein Projekt mit einem Blueprint zu erstellen** 1. Navigieren Sie in der CodeCatalyst Konsole zu dem Bereich, in dem Sie ein Projekt erstellen möchten. 1. Wählen Sie im Space-Dashboard die Option **Projekt erstellen** aus. 1. Wählen Sie **Mit einem Blueprint beginnen** aus. **Tipp** Sie können sich dafür entscheiden, einen Blueprint hinzuzufügen, indem Sie **Amazon Q** Ihre Projektanforderungen mitteilen, damit Amazon Q Ihnen einen Blueprint vorschlägt. Weitere Informationen erhalten Sie unter [Verwenden von Amazon Q zur Auswahl eines Blueprints beim Erstellen eines Projekts oder beim Hinzufügen von Funktionen](getting-started-project-assistance.md#getting-started-project-assistance-create-apply-bp) und [Bewährte Methoden bei der Verwendung von Amazon Q zum Erstellen von Projekten oder zum Hinzufügen von Funktionen mit Blueprints](projects-create.md#projects-create-amazon-q). Diese Funktion ist nur in der Region USA West (Oregon) verfügbar. Diese Funktionalität setzt voraus, dass generative KI-Funktionen für den Bereich aktiviert sind. Weitere Informationen finden Sie unter [Generative KI-Funktionen verwalten](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html). 1. **Wählen Sie auf der Registerkarte **CodeCatalyst Blueprints** oder **Space-Blueprints** einen Blueprint aus und wählen Sie dann Weiter aus.** 1. Geben Sie unter **Name your project** den Namen ein, den Sie Ihrem Projekt zuweisen möchten, sowie die zugehörigen Ressourcennamen. Der Name muss in Ihrem Bereich eindeutig sein. 1. (Optional) Standardmäßig wird der durch den Blueprint erstellte Quellcode in einem CodeCatalyst Repository gespeichert. Sie können sich auch dafür entscheiden, den Quellcode des Blueprints in einem Drittanbieter-Repository zu speichern. Weitere Informationen finden Sie unter [Fügen Sie Funktionen zu Projekten mit Erweiterungen hinzu in CodeCatalystFügen Sie Funktionen zu Projekten mit Erweiterungen hinzu](extensions.md). **Wichtig** CodeCatalyst unterstützt nicht die Erkennung von Änderungen im Standardzweig für verknüpfte Repositorys. Um den Standardzweig für ein verknüpftes Repository zu ändern, müssen Sie zuerst die Verknüpfung mit dem Repository CodeCatalyst aufheben, den Standardzweig ändern und ihn dann erneut verknüpfen. Weitere Informationen finden Sie unter [Verknüpfen von GitHub Repositorys, Bitbucket-Repositorys, GitLab Projekt-Repositorys und Jira-Projekten in CodeCatalyst](extensions-link.md). Als bewährte Methode sollten Sie immer sicherstellen, dass Sie über die neueste Version der Erweiterung verfügen, bevor Sie ein Repository verknüpfen. Führen Sie je nach Repository-Drittanbieter, den Sie verwenden möchten, einen der folgenden Schritte aus: + **GitHub Repositorien**: Connect ein GitHub Konto. Wählen Sie das Dropdownmenü **Erweitert**, wählen Sie GitHub als Repository-Anbieter aus und wählen Sie dann das GitHub Konto aus, in dem Sie den durch den Blueprint erstellten Quellcode speichern möchten. **Anmerkung** Wenn Sie ein GitHub Konto verbinden, müssen Sie eine persönliche Verbindung herstellen, um eine Identitätszuordnung zwischen Ihrer Identität und Ihrer CodeCatalyst GitHub Identität herzustellen. Weitere Informationen erhalten Sie unter [Persönliche Verbindungen](concepts.md#personal-connection-concept) und [Zugreifen auf GitHub Ressourcen mit persönlichen Verbindungen](ipa-settings-connections.md). + **Bitbucket-Repositorys**: Connect einen Bitbucket-Workspace. Wähle das Dropdownmenü „**Erweitert**“, wähle Bitbucket als Repository-Anbieter und wähle dann den Bitbucket-Workspace aus, in dem du den durch den Blueprint erstellten Quellcode speichern möchtest. + **GitLab Repositorien**: Verbindet einen GitLab Benutzer. Wählen Sie das Dropdownmenü „**Erweitert**“, wählen Sie GitLab als Repository-Anbieter aus und wählen Sie dann den GitLab Benutzer aus, für den Sie den durch den Blueprint erstellten Quellcode speichern möchten. 1. Konfigurieren Sie unter **Projektressourcen** die Blueprint-Parameter. Je nach Blueprint haben Sie möglicherweise die Möglichkeit, den Namen des Quell-Repositorys zu benennen. 1. (Optional) Um Definitionsdateien mit Aktualisierungen auf der Grundlage der von Ihnen ausgewählten Projektparameter **anzuzeigen, wählen Sie unter **Projektvorschau generieren** die Option Code** **anzeigen oder Workflow anzeigen** aus. 1. (Optional) Wählen Sie **auf der Karte des Blueprints die Option Details** anzeigen aus, um spezifische Details zum Blueprint anzuzeigen, z. B. einen Überblick über die Architektur des Blueprints, die erforderlichen Verbindungen und Berechtigungen sowie die Art der Ressourcen, die der Blueprint erstellt. 1. Wählen Sie **Create project** (Projekt erstellen) aus. Die Seite mit der Projektübersicht wird geöffnet, sobald Sie ein Projekt erstellen oder eine Einladung zu einem Projekt annehmen und den Anmeldevorgang abgeschlossen haben. Die Projektübersichtsseite für ein neues Projekt enthält keine offenen Probleme oder Pull-Requests. Du kannst dich optional dafür entscheiden, ein Problem zu erstellen und es dir selbst zuzuweisen. Sie können sich auch dafür entscheiden, eine andere Person zu Ihrem Projekt einzuladen. Weitere Informationen erhalten Sie unter [Ein Problem erstellen in CodeCatalyst](issues-create-issue.md) und [Einen Benutzer zu einem Projekt einladen](projects-members.md#projects-members-add). ## Die Repositorys für ein Projekt anzeigen Als Mitglied eines Projekts können Sie die Quell-Repositorys für das Projekt einsehen. Sie können sich auch dafür entscheiden, zusätzliche Repositorys zu erstellen. **Wenn jemand mit der **Space-Administratorrolle** die **GitHub Repositorys, Bitbucket-Repositorys** **oder GitLab die Repository-Erweiterung** installiert und konfiguriert hat, kannst du den GitHub Konten, Bitbucket-Workspaces oder Benutzern, die für die Erweiterung konfiguriert sind, auch Links zu Repositorys von Drittanbietern hinzufügen.** GitLab Weitere Informationen erhalten Sie unter [Erstellen eines Quell-Repositorys](source-repositories-create.md) und [Schnellstart: Erweiterungen installieren, Anbieter verbinden und Ressourcen verknüpfen in CodeCatalyst](extensions-quickstart.md). **Anmerkung** Für Projekte, die mit dem Blueprint für einseitige Anwendungen erstellt wurden, lautet der Standardname für das Quell-Repository, das den Beispielcode enthält. ***spa-app*** **Um zu den Quell-Repositorys für ein Projekt zu navigieren** 1. Navigieren Sie zu Ihrem Projekt und führen Sie einen der folgenden Schritte aus: + Wählen Sie auf der Übersichtsseite für Ihr Projekt das gewünschte Repository aus der Liste aus und klicken Sie dann **auf Repository anzeigen**. + Wählen Sie im Navigationsbereich **Code** und dann **Quell-Repositorys** aus. Wählen Sie unter **Quell-Repositorys** den Namen des Repositorys aus der Liste aus. Sie können die Liste der Repositorys filtern, indem Sie einen Teil des Repository-Namens in die Filterleiste eingeben. 1. Sehen Sie sich auf der Startseite des Repositorys den Inhalt des Repositorys und Informationen zu den zugehörigen Ressourcen an, z. B. die Anzahl der Pull-Requests und Workflows. Standardmäßig werden die Inhalte für den Standard-Branch angezeigt. Sie können die Ansicht ändern, indem Sie einen anderen Zweig aus der Dropdownliste auswählen. Die Übersichtsseite für das Repository enthält Informationen zu den Workflows und Pull-Requests, die für die Branches dieses Repositorys und dessen Dateien konfiguriert sind. Wenn Sie das Projekt gerade erst erstellt haben, werden die ersten Workflows zum Erstellen, Testen und Bereitstellen des Codes weiterhin ausgeführt, da sie einige Minuten in Anspruch nehmen. Sie können die zugehörigen Workflows und ihren Status anzeigen, indem Sie die Nummer unter **Verwandte Workflows** auswählen. Dadurch wird jedoch die Seite **Workflows** in **CI/CD** geöffnet. Bleiben Sie für dieses Tutorial auf der Übersichtsseite und erkunden Sie den Code im Repository. Der Inhalt der `README.md` Datei wird auf dieser Seite unter den Repository-Dateien gerendert. Unter **Dateien** wird der Inhalt des Standardzweigs angezeigt. Sie können die Dateiansicht so ändern, dass der Inhalt eines anderen Zweigs angezeigt wird, falls Sie einen haben. Der `.codecatalyst` Ordner enthält Code, der für andere Teile des Projekts verwendet wird, z. B. für Workflow-YAML-Dateien. Um den Inhalt von Ordnern anzuzeigen, klicken Sie auf den Pfeil neben dem Ordnernamen, um ihn zu erweitern. Wählen Sie beispielsweise den Pfeil neben, `src` um die Dateien für die einseitige Webanwendung anzuzeigen, die in diesem Ordner enthalten sind. Um den Inhalt einer Datei anzuzeigen, wählen Sie sie in der Liste aus. Dadurch wird **Dateien anzeigen** geöffnet, in dem Sie den Inhalt mehrerer Dateien durchsuchen können. Sie können auch einzelne Dateien in der Konsole bearbeiten, aber um mehrere Dateien zu bearbeiten, sollten Sie eine Entwicklungsumgebung erstellen. ## Erstellen einer Entwicklungsumgebung Sie können Dateien in einem Quell-Repository in der CodeCatalyst Amazon-Konsole hinzufügen und ändern. Um effektiv mit mehreren Dateien und Branches arbeiten zu können, empfehlen wir jedoch, eine Entwicklungsumgebung zu verwenden oder das Repository auf Ihren lokalen Computer zu klonen. In diesem Tutorial erstellen wir eine AWS Cloud9 Entwicklungsumgebung mit einem Zweig namens**develop**. Sie können einen anderen Branch-Namen wählen, aber wenn Sie den Branch benennen**develop**, wird automatisch ein Workflow ausgeführt, um Ihren Code zu erstellen und zu testen, wenn Sie später in diesem Tutorial eine Pull-Anfrage erstellen. **Tipp** Wenn Sie sich dafür entscheiden, ein Repository lokal zu klonen, anstatt eine Entwicklungsumgebung zu verwenden oder zusätzlich zu verwenden, stellen Sie sicher, dass Sie Git auf Ihrem lokalen Computer haben oder dass Ihre IDE Git enthält. Weitere Informationen finden Sie unter [Einrichtung für die Arbeit mit Quell-Repositorys](source-setting-up.md). **Um eine Entwicklungsumgebung mit einem neuen Zweig zu erstellen** 1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/). 1. Navigieren Sie zu dem Projekt, in dem Sie eine Entwicklungsumgebung erstellen möchten. 1. Wählen Sie den Namen des Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. Sie können auch im Navigationsbereich **Code**, dann **Quell-Repositories** und dann das Repository auswählen, für das Sie eine Entwicklungsumgebung erstellen möchten. 1. Wählen Sie auf der Repository-Startseite die Option **Create Dev Environment** aus. 1. Wählen Sie eine unterstützte IDE aus dem Drop-down-Menü aus. Weitere Informationen finden Sie unter [Unterstützte integrierte Entwicklungsumgebungen für Entwicklungsumgebungen](devenvironment-create.md#devenvironment-supported-ide). 1. Wählen Sie das zu klonende Repository aus, wählen Sie **In neuem Zweig arbeiten** aus, geben Sie einen Branch-Namen in das Feld **Branch-Name** ein und wählen Sie im Drop-down-Menü Branch erstellen einen Branch aus, aus dem der neue **Branch erstellt** werden soll. 1. Fügen Sie optional einen Alias für die Entwicklungsumgebung hinzu. 1. Wählen Sie optional die Schaltfläche „**Konfiguration der Entwicklungsumgebung** bearbeiten“, um die Rechen-, Speicher- oder Timeout-Konfiguration der Entwicklungsumgebung zu bearbeiten. 1. Wählen Sie **Erstellen** aus. Während Ihre Entwicklungsumgebung erstellt wird, wird in der Statusspalte Entwicklungsumgebung der Wert Wird **gestartet** angezeigt, und in der Statusspalte wird nach der Erstellung der Entwicklungsumgebung die Meldung Wird **ausgeführt** angezeigt. Es öffnet sich ein neuer Tab mit Ihrer Entwicklungsumgebung in der IDE Ihrer Wahl. Sie können Code bearbeiten und Ihre Änderungen übernehmen und pushen. Sobald Sie die Entwicklungsumgebung erstellt haben, können Sie Dateien bearbeiten, Ihre Änderungen übernehmen und Ihre Änderungen an den **test** Branch übertragen. Bearbeiten Sie für dieses Tutorial den Inhalt zwischen den `

` Tags in der `App.tsx` Datei im `src` Ordner, um den Text zu ändern, der auf der Webseite angezeigt wird. Bestätigen und übertragen Sie Ihre Änderung und kehren Sie dann zur CodeCatalyst Registerkarte zurück. ## Um eine Änderung in einer AWS Cloud9 Entwicklungsumgebung vorzunehmen und zu pushen 1. Erweitern Sie in AWS Cloud9 das seitliche Navigationsmenü, um die Dateien zu durchsuchen. Erweitern `src` und öffnen`App.tsx`. 1. Nehmen Sie eine Änderung am Text in den `

` Tags vor. 1. Speichern Sie die Datei und übertragen Sie dann Ihre Änderungen mithilfe des Git-Menüs. Alternativ können Sie Ihre Änderungen im Terminalfenster mit den **git push** Befehlen **git commit** und übertragen. ``` git commit -am "Making an example change" git push ``` **Tipp** Möglicherweise müssen Sie die Verzeichnisse im Terminal in das Git-Repository-Verzeichnis ändern, bevor Sie die Git-Befehle erfolgreich ausführen können. ## Erstellen einer Pull-Anforderung Sie können Pull Requests verwenden, um Codeänderungen gemeinsam auf kleinere Änderungen oder Korrekturen, wichtige Funktionserweiterungen oder neue Versionen Ihrer veröffentlichten Software zu überprüfen. In diesem Tutorial erstellen Sie einen Pull-Request, um die Änderungen, die Sie am Branch vorgenommen haben, im Vergleich zum *test* **Haupt-Branch** zu überprüfen. Wenn Sie in einem Projekt, das mit einer Vorlage erstellt wurde, einen Pull Request erstellen, wird auch die Ausführung der zugehörigen Workflows gestartet, falls vorhanden. **So erstellen Sie eine Pull-Anforderung** 1. Navigiere zu deinem Projekt. 1. 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. 1. 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. 1. Wählen Sie im **Ziel-Branch** den Branch aus, in den der Code nach der Überprüfung zusammengeführt werden soll. 1. Wählen Sie im **Quellzweig** den Zweig aus, der den festgeschriebenen Code enthält. 1. Geben **Sie im Feld Titel der Pull-Anfrage** einen Titel ein, der anderen Benutzern hilft zu verstehen, was überprüft werden muss und warum. 1. (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](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html). 1. (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“. 1. (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. 1. (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. 1. Ü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. 1. 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. Sie können Informationen zu den zugehörigen Workflows anzeigen, die bei der Erstellung dieses Pull-Requests gestartet wurden, indem Sie **Überblick** wählen und dann die Informationen im Bereich **Pull-Request-Details** unter **Workflow-Läufe** überprüfen. Um die Workflow-Ausführung anzuzeigen, wählen Sie die Ausführung aus. **Tipp** Wenn Sie Ihrem Branch einen anderen Namen gegeben haben als**develop**, wird nicht automatisch ein Workflow ausgeführt, um Ihre Änderungen zu erstellen und zu testen. Wenn Sie das konfigurieren möchten, bearbeiten Sie die YAML-Datei für den **onPullRequestBuildAndTest**Workflow. Weitere Informationen finden Sie unter [Einen Workflow erstellen](workflows-create-workflow.md). Sie können diesen Pull-Request kommentieren und andere Projektmitglieder bitten, ihn zu kommentieren. Du kannst dich auch dafür entscheiden, optionale oder erforderliche Prüfer hinzuzufügen oder zu ändern. Du kannst entscheiden, ob du weitere Änderungen am Quell-Branch für das Repository vornehmen möchtest, und dir ansehen, wie diese festgeschriebenen Änderungen zu Revisionen für den Pull Request führen. Weitere Informationen finden Sie unter[Überprüfen einer Pull-Anforderung](pull-requests-review.md), [Aktualisieren einer Pull-Anforderung](pull-requests-update.md)[Code mit Pull-Requests in Amazon überprüfen CodeCatalyst](source-pull-requests.md), und[Status und Details der Workflow-Ausführung anzeigen](workflows-view-run.md). ## Zusammenführen einer Pull-Anforderung Sobald ein Pull Request geprüft wurde und Genehmigungen von den erforderlichen Prüfern erhalten hat, kannst du seinen Quell-Branch in der Konsole mit dem Ziel-Branch zusammenführen. CodeCatalyst Durch das Zusammenführen eines Pull-Requests wird außerdem eine Ausführung der Änderungen in allen Workflows gestartet, die dem Ziel-Branch zugeordnet sind. In diesem Tutorial führen Sie den Testzweig mit dem Hauptzweig zusammen, wodurch eine Ausführung des **onPushToMainDeployPipeline**Workflows gestartet wird. **Um einen Pull-Request zusammenzuführen (Konsole)** 1. Wählen **Sie unter Pull-Anfragen** die Pull-Anfrage aus, die Sie im vorherigen Schritt erstellt haben. Wähle in der Pull-Anfrage **Merge** aus. 1. Wählen Sie aus den verfügbaren Merge-Strategien für den Pull Request aus. **Aktiviere oder deaktiviere optional die Option, den Quell-Branch nach dem Zusammenführen des Pull-Requests zu löschen, oder deaktiviere sie und wähle dann Merge.** Nach Abschluss der Zusammenführung ändert sich der Status des Pull-Requests in **Zusammengeführt** und wird nicht mehr in der Standardansicht der Pull Requests angezeigt. In der Standardansicht werden Pull-Requests mit dem Status **Offen** angezeigt. Du kannst einen zusammengeführten Pull Request immer noch ansehen, aber du kannst ihn nicht genehmigen oder seinen Status ändern. **Anmerkung** Wenn die Schaltfläche **Zusammenführen** nicht aktiv ist oder du die Bezeichnung **Nicht zusammenführbar** siehst, hat entweder ein erforderlicher Prüfer den Pull Request noch nicht genehmigt, oder der Pull Request kann nicht in der CodeCatalyst Konsole zusammengeführt werden. Ein Prüfer, der eine Pull-Anfrage nicht genehmigt hat, wird in der **Übersicht** im Bereich **Pull-Request-Details** durch ein Uhrensymbol gekennzeichnet. Wenn alle erforderlichen Reviewer den Pull Request genehmigt haben, aber die Schaltfläche **Zusammenführen** immer noch nicht aktiv ist, liegt möglicherweise ein Mergekonflikt vor, oder Sie haben das Speicherkontingent für den Speicherplatz überschritten. Sie können Merge-Konflikte für den Ziel-Branch in einer Entwicklungsumgebung lösen, die Änderungen per Push übertragen und dann den Pull-Request zusammenführen, oder Sie können Konflikte lösen und lokal zusammenführen und dann den Commit, der die Zusammenführung enthält, per Push übertragen. CodeCatalyst Weitere Informationen finden Sie unter [Eine Pull-Anfrage zusammenführen (Git)](pull-requests-merge.md#pull-requests-merge-git) und in Ihrer Git-Dokumentation. ## Den bereitgestellten Code anzeigen Jetzt ist es an der Zeit, sich den ursprünglich bereitgestellten Code anzusehen, der sich im Standard-Branch befand, sowie Ihre zusammengeführten Änderungen, sobald sie automatisch erstellt, getestet und bereitgestellt wurden. **Dazu können Sie zur Übersichtsseite für das Repository zurückkehren und die Zahl neben dem Symbol für zugehörige Workflows auswählen oder im Navigationsbereich **CI/CD** und dann Workflows auswählen.** **Um den bereitgestellten Code anzuzeigen** 1. Erweitern Sie unter **Workflows** in `onPushToMainDeployPipeline` **den Bereich Letzte Ausführungen**. **Anmerkung** Dies ist der Standardname des Workflows für Projekte, die mit dem Blueprint für **einseitige Anwendungen** erstellt wurden. 1. Bei der letzten Ausführung handelt es sich um die Ausführung, die mit Ihrem zusammengeführten Pull-Request-Commit an den `main` Branch gestartet wurde. Wahrscheinlich wird der Status **In** Bearbeitung angezeigt. Wählen Sie einen erfolgreich abgeschlossenen Lauf aus der Liste aus, um die Details dieses Laufs zu öffnen. 1. Wählen Sie **Variablen**. Kopieren Sie den Wert für **AppUrl**. Dies ist die URL für die bereitgestellte einseitige Webanwendung. Öffnen Sie einen neuen Browser-Tab und fügen Sie den Wert ein, um den erstellten und bereitgestellten Code anzuzeigen. Lassen Sie die Registerkarte geöffnet. 1. Kehren Sie zur Liste der Workflow-Ausführungen zurück und warten Sie, bis die letzte Ausführung abgeschlossen ist. Wenn dies der Fall ist, kehren Sie zu der Registerkarte zurück, die Sie geöffnet haben, um die Webanwendung anzuzeigen, und aktualisieren Sie Ihren Browser. Sie sollten die Änderungen sehen, die Sie in Ihrer zusammengeführten Pull-Anfrage vorgenommen haben. ## Bereinigen von Ressourcen Nachdem du dich mit der Arbeit mit einem Quell-Repository und einer Pull-Anfrage befasst hast, möchtest du vielleicht alle Ressourcen entfernen, die du nicht benötigst. Sie können Pull-Requests nicht löschen, aber Sie können sie schließen. Du kannst alle Branches löschen, die du erstellt hast. Wenn Sie das Quell-Repository oder das Projekt nicht mehr benötigen, können Sie diese Ressourcen auch löschen. Weitere Informationen erhalten Sie unter [Löschen eines Quell-Repositorys](source-repositories-delete.md) und [Löschen eines Projekts](projects-delete.md). # Speichern von Quellcode in Repositorys für ein Projekt in CodeCatalyst In einem Quell-Repository speichern Sie Code und Dateien für Ihr Projekt sicher. Es speichert auch deinen Quellverlauf, vom ersten Commit bis zu den letzten Änderungen. Wenn Sie einen Blueprint wählen, der ein Quell-Repository enthält, enthält dieses Repository auch die Konfigurationsdateien und andere Informationen für Workflows und Benachrichtigungen für das Projekt. Diese Konfigurationsinformationen werden in einem Ordner namens **.codecatalyst** gespeichert. Sie können ein Quell-Repository erstellen, indem Sie CodeCatalyst entweder ein Projekt mit einem Blueprint erstellen, der im Rahmen der Erstellung eines Projekts ein Quell-Repository erstellt, oder indem Sie ein Quell-Repository in einem vorhandenen Projekt erstellen. Projektbenutzer sehen automatisch die Repositorys, die Sie für ein Projekt erstellen, und können sie verwenden. Sie können auch wählen, ob Sie ein auf GitHub Bibucket gehostetes Git-Repository oder mit Ihrem Projekt verknüpfen GitLab möchten. Wenn du das tust, können deine Projektbenutzer das verknüpfte Repository in der Liste der Repositorys für das Projekt einsehen und darauf zugreifen. **Anmerkung** Bevor Sie das Repository verknüpfen können, müssen Sie die Erweiterung für den Dienst installieren, der es hostet. Sie können ein archiviertes Repository nicht verknüpfen. Sie können zwar ein leeres Repository verknüpfen, aber Sie können es CodeCatalyst erst verwenden, wenn Sie es mit einem ersten Commit initialisiert haben, das einen Standard-Branch erstellt. Weitere Informationen finden Sie unter [Eine Erweiterung in einem Space installieren](install-extension.md). Standardmäßig wird ein Quell-Repository mit anderen Mitgliedern Ihres CodeCatalyst Amazon-Projekts geteilt. Sie können zusätzliche Quell-Repositorys für ein Projekt erstellen oder Repositorys mit dem Projekt verknüpfen. Alle Mitglieder eines Projekts können Dateien und Ordner in den Quell-Repositorys des Projekts anzeigen, hinzufügen, bearbeiten und löschen. Um schnell an Code in einem Quell-Repository zu arbeiten, können Sie eine Entwicklungsumgebung erstellen, die ein bestimmtes Repository klont und in dieses verzweigt, wo Sie in der integrierten Entwicklungsumgebung (IDE), die Sie für die Entwicklungsumgebung auswählen, an dem Code arbeiten können. Sie können ein Quell-Repository auf Ihrem lokalen Computer klonen und Änderungen zwischen Ihrem lokalen Repository und dem Remote-Repository per Pull and Push übertragen. CodeCatalyst Sie können auch mit Quell-Repositorys arbeiten, indem Sie den Zugriff darauf in Ihrer bevorzugten IDE konfigurieren, sofern diese IDE die Verwaltung von Anmeldeinformationen unterstützt. Repository-Namen müssen innerhalb eines CodeCatalyst Projekts eindeutig sein. **Topics** + [Erstellen eines Quell-Repositorys](source-repositories-create.md) + [Ein vorhandenes Git-Repository in ein Quell-Repository klonen](source-repositories-add-existing.md) + [Ein Quell-Repository verlinken](source-repositories-link.md) + [Anzeigen eines Quell-Repositorys](source-repositories-view.md) + [Einstellungen für ein Quell-Repository bearbeiten](source-repositories-edit.md) + [Klonen eines Quell-Repositorys](source-repositories-clone.md) + [Löschen eines Quell-Repositorys](source-repositories-delete.md) # Erstellen eines Quell-Repositorys Wenn Sie ein Projekt mithilfe eines Blueprints in Amazon erstellen CodeCatalyst, CodeCatalyst erstellt ein Quell-Repository für Sie. Dieses Quell-Repository enthält zusätzlich zu den Konfigurationsinformationen für die Workflows und andere Ressourcen, die für Sie erstellt wurden, Beispielcode. Dies ist die empfohlene Methode, um mit Repositorys in CodeCatalyst zu beginnen. Sie können wählen, ob Sie Repositorys für ein Projekt erstellen möchten. Diese Repositorys enthalten eine **README.md-Datei**, die Sie jederzeit bearbeiten oder löschen können. Abhängig von Ihren Optionen beim Erstellen eines Quell-Repositorys können Repositorys auch eine Datei enthalten. `.gitignore` Wenn du ein vorhandenes Git-Repository in ein CodeCatalyst Quell-Repository klonen möchtest, erwäge stattdessen, ein leeres Repository zu erstellen. Dieses Repository kann nicht verwendet werden, CodeCatalyst bis du Inhalte hinzufügst, was du mit ein paar einfachen Git-Befehlen tun kannst. Alternativ kannst du Inhalte direkt von der CodeCatalyst Konsole aus zum leeren Repository hinzufügen. Alternativ können Sie ein Quell-Repository in einem unterstützten Git-Repository-Anbieter verlinken. Weitere Informationen finden Sie unter [Ein Quell-Repository verlinken](source-repositories-link.md). **Um ein Quell-Repository zu erstellen** 1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/). 1. Navigieren Sie zu Ihrem Projekt. 1. Wählen Sie im Navigationsbereich **Code** und dann **Quell-Repositories** aus. 1. Wählen **Sie Repository hinzufügen** und anschließend **Repository erstellen** aus. 1. Geben Sie im **Feld Repository-Name** einen Namen für das Repository ein. In diesem Handbuch verwenden wir einen anderen Namen*codecatalyst-source-repository*, aber Sie können einen anderen Namen wählen. Repository-Namen müssen innerhalb eines Projekts eindeutig sein. Weitere Hinweise zu den Anforderungen für Repository-Namen finden Sie unter[Kontingente für Quell-Repositorys in CodeCatalyst](source-quotas.md). 1. (Optional) Fügen Sie unter **Beschreibung** eine Beschreibung für das Repository hinzu, damit andere Benutzer im Projekt verstehen, wofür das Repository verwendet wird. 1. Wählen Sie **Repository erstellen (Standard)** aus. Diese Option erstellt ein Repository, das einen Standard-Branch und eine README.md-Datei enthält. Im Gegensatz zu einem leeren Repository können Sie dieses Repository verwenden, sobald es erstellt wurde. 1. Belassen Sie im **Standard-Zweig** den Namen *main*, es sei denn, Sie haben einen Grund, einen anderen Namen zu wählen. Die Beispiele in diesem Handbuch verwenden alle den Namen *main* für den Standardzweig. 1. (Optional) Fügen Sie eine `.gitignore` Datei für den Codetyp hinzu, den Sie pushen möchten. 1. Wählen Sie **Erstellen** aus. **Anmerkung** CodeCatalyst fügt Ihrem Repository eine `README.md` Datei hinzu, wenn Sie sie erstellen. CodeCatalysterstellt außerdem einen ersten Commit für das Repository in einem Standard-Branch namens **main**. Sie können die Datei README.md bearbeiten oder löschen, aber Sie können den Standard-Branch nicht löschen. **Um ein leeres Quell-Repository zu erstellen** 1. Navigieren Sie in der CodeCatalyst Konsole zu dem Projekt, in dem Sie ein leeres Repository erstellen möchten. 1. Wählen Sie auf der Übersichtsseite Ihres Projekts unter **Quell-Repositorys** die Option **Repository hinzufügen** und anschließend **Repository erstellen** aus. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositorys** auswählen. Wählen **Sie Repository hinzufügen** und anschließend **Repository erstellen** aus. 1. Geben Sie im **Feld Repository-Name** einen Namen für das Repository ein. In diesem Handbuch verwenden wir einen anderen Namen*codecatalyst-source-repository*, aber Sie können einen anderen Namen wählen. Repository-Namen müssen innerhalb eines Projekts eindeutig sein. Weitere Hinweise zu den Anforderungen für Repository-Namen finden Sie unter[Kontingente für Quell-Repositorys in CodeCatalyst](source-quotas.md). 1. (Optional) Fügen Sie unter **Beschreibung** eine Beschreibung für das Repository hinzu, damit andere Benutzer im Projekt verstehen, wofür das Repository verwendet wird. 1. Wählen Sie **Leeres Repository erstellen** und anschließend **Erstellen** aus. # Ein vorhandenes Git-Repository in ein Quell-Repository klonen Sie können ein vorhandenes Git-Repository in ein leeres Quell-Repository in Amazon klonen CodeCatalyst. Dies ist eine schnelle Möglichkeit, CodeCatalyst mit Code zu beginnen, der zuvor in einem anderen Git-Repository-Anbieter gehostet wurde. Du kannst den Inhalt des Repositorys klonen, indem du einen Spiegelklon erstellst und den Spiegel dann per Push dorthin verschiebst CodeCatalyst. Wenn Sie ein lokales Repo des Repositorys haben, dessen Inhalt Sie hinzufügen möchten CodeCatalyst, können Sie alternativ das CodeCatalyst Quell-Repository als weiteres Remote-Repository zum lokalen Repository hinzufügen und dann in das leere Quell-Repository pushen. Beide Ansätze sind gleichermaßen gültig. Bei der Verwendung eines Spiegelklons werden nicht nur Zweige, sondern auch alle Referenzen zugeordnet. Es ist eine einfache und saubere Methode, eine Arbeitskopie des Projektarchivs in CodeCatalyst zu erstellen. Wenn Sie ein Remote-Repository zu einem lokalen Repo hinzufügen, das auf ein leeres CodeCatalyst Quell-Repository verweist, wird der Inhalt des Repositorys hinzugefügt CodeCatalyst, aber Sie können damit auch Pushs vom lokalen Repo sowohl zum CodeCatalyst Quell-Repository als auch zum ursprünglichen Git-Remote-Repository durchführen. Dies kann nützlich sein, wenn Sie den Code in verschiedenen Remote-Repositorys verwalten möchten, kann aber zu Konflikten führen, wenn andere Entwickler den Code nur an eines der Remote-Repositorys übertragen. Die folgenden Verfahren verwenden grundlegende Git-Befehle, um diese Aufgabe auszuführen. Es gibt viele Möglichkeiten, Aufgaben in Git zu erledigen, einschließlich des Klonens. Weitere Informationen finden Sie in der [Git-Dokumentation.](https://git-scm.com/docs/git-clone) **Wichtig** Sie müssen ein leeres Repository in erstellen, CodeCatalyst bevor Sie Inhalte in dieses Repository klonen können. Sie benötigen außerdem ein persönliches Zugriffstoken. Weitere Informationen erhalten Sie unter [Um ein leeres Quell-Repository zu erstellen](source-repositories-create.md#source-repositories-create-empty) und [Erstellen Sie ein persönliches Zugriffstoken](source-setting-up.md#source-setting-up-pat). **Um ein vorhandenes Git-Repository `git clone --mirror` zu klonen CodeCatalyst** 1. Navigieren Sie in der CodeCatalyst Konsole zu dem Projekt, in dem Sie ein leeres Repository erstellt haben. 1. Wählen Sie auf der Übersichtsseite Ihres Projekts das leere Repository aus der Liste aus und klicken Sie dann **auf Repository anzeigen**. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositorys** auswählen. Wählen Sie den Namen des leeren Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. 1. Kopieren Sie die HTTPS-Klon-URL des leeren Repositorys. Sie benötigen dies, um den Mirror-Clone zu pushen. Wenn Sie beispielsweise das Quell-Repository MyExampleRepo im MyExampleProject Projekt in dem ExampleCorp Bereich benannt haben und Ihr Benutzername lautet LiJuan, könnte Ihre Klon-URL wie folgt aussehen: ``` https://LiJuan@git.us-west-2.codecatalyst.aws/v1/ExampleCorp/MyExampleProject/MyExampleRepo ``` 1. Verwenden Sie den Befehl in einer Befehlszeile oder einem Terminalfenster, um einen Spiegelklon des Git-Repositorys zu erstellen, in das Sie klonen möchten CodeCatalyst. `git clone --mirror` Wenn Sie beispielsweise einen Spiegelklon des Codecatalyst-Blueprints-Repositorys erstellen möchten GitHub, geben Sie den folgenden Befehl ein: ``` git clone --mirror https://github.com/aws/codecatalyst-blueprints.git ``` 1. Ändern Sie die Verzeichnisse in das Verzeichnis, in dem Sie den Klon erstellt haben. ``` cd codecatalyst-blueprints.git ``` 1. Führen Sie den **git push** Befehl aus und geben Sie die URL und den Namen des CodeCatalyst Ziel-Quell-Repositorys sowie die Option an. **--all** (Dies ist die URL, die Sie in Schritt 3 kopiert haben.) Beispiel: ``` git push https://LiJuan@git.us-west-2.codecatalyst.aws/v1/ExampleCorp/MyExampleProject/MyExampleRepo --all ``` **Um ein Remote-Repo hinzuzufügen und ein lokales Repo in CodeCatalyst** 1. Navigieren Sie in der CodeCatalyst Konsole zu dem Projekt, in dem Sie ein leeres Repository erstellt haben. 1. Wählen Sie auf der Übersichtsseite Ihres Projekts das leere Repository aus der Liste aus und klicken Sie dann **auf Repository anzeigen**. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositorys** auswählen. Wählen Sie den Namen des leeren Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. 1. Kopieren Sie die HTTPS-Klon-URL des leeren Repositorys. Sie benötigen dies, um den Mirror-Clone zu pushen. Wenn Sie beispielsweise das Quell-Repository MyExampleRepo im MyExampleProject Projekt in dem ExampleCorp Bereich benannt haben und Ihr Benutzername lautet LiJuan, könnte Ihre Klon-URL wie folgt aussehen: ``` https://LiJuan@git.us-west-2.codecatalyst.aws/v1/ExampleCorp/MyExampleProject/MyExampleRepo ``` 1. Wechseln Sie in einer Befehlszeile oder einem Terminalfenster in die Verzeichnisse des lokalen Repositorys, zu dem Sie die Übertragung durchführen möchten CodeCatalyst. 1. Führen Sie den Befehl git remote -v aus, um die vorhandenen Fernbedienungen für das lokale Repository zu sehen. Wenn Sie beispielsweise ein lokales AWS CodeCommit Repository eines Repositorys klonen, das **MyDemoRepo** in der Region USA Ost (Ohio) benannt ist, könnte Ihre Befehlsausgabe wie folgt aussehen: ``` origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (fetch) origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (push) ``` Kopieren Sie die Remote-URL, wenn Sie das Repository weiterhin verwenden möchten. 1. Verwenden Sie den `git remote remove` Befehl, um das CodeCommit Repository URLs für Fetch und Push for Origin zu entfernen: ``` git remote remove origin ``` 1. Verwende den Befehl **git remote add**, um die URL des CodeCatalyst Quell-Repositorys als Fetch and Push Remote für dein lokales Repo hinzuzufügen. Beispiel: ``` git remote add origin https://LiJuan@git.us-west-2.codecatalyst.aws/v1/ExampleCorp/MyExampleProject/MyExampleRepo ``` Dadurch wird die CodeCommit Repository-Push-URL durch die CodeCatalyst Quell-Repository-URL ersetzt, die Abruf-URL wird jedoch nicht geändert. Wenn Sie also den Befehl git remote -v erneut ausführen, werden Sie feststellen, dass Sie jetzt Code aus dem CodeCommit Remote-Repository abrufen (abrufen), aber Sie sind so konfiguriert, dass Änderungen von Ihrem lokalen Repository in das Quell-Repository übertragen werden: CodeCatalyst ``` origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (fetch) origin https://LiJuan@git.us-west-2.codecatalyst.aws/v1/ExampleCorp/MyExampleProject/MyExampleRepo (push) ``` Du kannst optional die CodeCommit Remote-URL wieder hinzufügen, wenn du mit dem folgenden Befehl zu beiden Repositorys pushen möchtest: `git remote set-url` ``` git remote set-url --add --push origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo ``` 1. Führen Sie den `git push` Befehl aus, um das lokale Repo auf alle konfigurierten Push-Fernbedienungen zu übertragen. Alternativ können Sie den **git push -u -origin** Befehl ausführen und dabei die **--all** Option angeben, das lokale Repo in beide Repositorys zu übertragen. Beispiel: ``` git push -u -origin --all ``` **Tipp** Abhängig von deiner Version von Git funktioniert --all möglicherweise nicht, um alle Zweige des lokalen Repos in das leere Repository zu verschieben. Möglicherweise musst du jeden Branch einzeln auschecken und pushen. # Ein Quell-Repository verlinken Wenn Sie ein Quell-Repository mit einem Projekt verknüpfen, können Sie Repositorys einbeziehen, die über eine CodeCatalyst Erweiterung für den Dienst verfügen, der das Repository hostet, sofern diese Erweiterung für Ihren Bereich installiert ist. Nur Benutzer mit der Rolle Space-Administrator können Erweiterungen installieren. Sobald die Erweiterung installiert ist, können Sie Links zu Repositorys herstellen, die für den Zugriff durch diese Erweiterung konfiguriert sind. Weitere Informationen finden Sie unter [Eine Erweiterung in einem Space installieren](install-extension.md) oder folgen Sie[Verknüpfen von GitHub Repositorys, Bitbucket-Repositorys, GitLab Projekt-Repositorys und Jira-Projekten in CodeCatalyst](extensions-link.md). **Wichtig** Nachdem Sie eine Repository-Erweiterung installiert haben, CodeCatalyst wird der Code aller Repositorys, auf die Sie verlinken, indexiert und gespeichert. CodeCatalyst Dadurch kann der Code in durchsucht werden. CodeCatalyst Weitere Informationen zum Datenschutz für Ihren Code bei der Verwendung verlinkter Repositorys finden Sie unter [Datenschutz](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html) im * CodeCatalyst Amazon-Benutzerhandbuch*. CodeCatalyst Sie können ein Repository nur mit einem Projekt in einem Bereich verknüpfen. Sie können ein archiviertes Repository nicht verknüpfen. Sie können zwar ein leeres Repository verknüpfen, aber Sie können es CodeCatalyst erst verwenden, wenn Sie es mit einem ersten Commit initialisiert haben, das einen Standard-Branch erstellt. Außerdem gilt Folgendes: + Ein GitHub Repository, Bitbucket-Repository oder GitLab Projekt-Repository kann nur mit einem CodeCatalyst Projekt in einem Space verknüpft werden. + Du kannst keine leeren oder archivierten GitHub Repositorys, Bitbucket-Repositorys oder GitLab Projekt-Repositorys mit Projekten verwenden. CodeCatalyst + Du kannst kein GitHub Repository, Bitbucket-Repository oder GitLab Projekt-Repository verknüpfen, das denselben Namen wie ein Repository in einem Projekt hat. CodeCatalyst + Die **GitHub Repository-Erweiterung** ist nicht mit GitHub Enterprise Server-Repositorys kompatibel. + Die **Bitbucket-Repository-Erweiterung ist nicht mit Bitbucket** Data Center-Repositorys kompatibel. + Die **GitLab Repository-Erweiterung** ist nicht mit selbstverwalteten Projekt-Repositorys kompatibel. GitLab + Sie können die Funktionen „**Beschreibung für mich schreiben**“ oder „**Kommentare zusammenfassen**“ nicht mit verknüpften Repositorys verwenden. Diese Funktionen sind nur in Pull-Requests in verfügbar. CodeCatalyst **Du kannst zwar als **Mitwirkender** ein GitHub Repository, Bitbucket-Repository oder GitLab Projekt-Repository verknüpfen, aber du kannst die Verknüpfung zu einem Drittanbieter-Repository nur als **Space-Administrator oder Projekt-Administrator** aufheben.** Weitere Informationen finden Sie unter [Aufheben der Verknüpfung von GitHub Repositorys, Bitbucket-Repositorys, GitLab Projekt-Repositorys und Jira-Projekten in CodeCatalyst](extensions-unlink.md). **Wichtig** CodeCatalyst unterstützt nicht die Erkennung von Änderungen im Standard-Branch für verknüpfte Repositorys. Um den Standardzweig für ein verknüpftes Repository zu ändern, müssen Sie zuerst die Verknüpfung mit dem Repository CodeCatalyst aufheben, den Standardzweig ändern und ihn dann erneut verknüpfen. Weitere Informationen finden Sie unter [Verknüpfen von GitHub Repositorys, Bitbucket-Repositorys, GitLab Projekt-Repositorys und Jira-Projekten in CodeCatalyst](extensions-link.md). Als bewährte Methode sollten Sie immer sicherstellen, dass Sie über die neueste Version der Erweiterung verfügen, bevor Sie ein Repository verknüpfen. **Um ein Quell-Repository zu verknüpfen** 1. Navigieren Sie zu dem Projekt, mit dem Sie ein Repository verknüpfen möchten. **Anmerkung** Bevor Sie ein Repository verknüpfen können, muss ein Benutzer mit der Space-Administratorrolle zuerst die Erweiterung für den Anbieter installieren, der das Repository hostet. Weitere Informationen finden Sie unter [Eine Erweiterung in einem Space installieren](install-extension.md). 1. Wählen Sie im Navigationsbereich **Code** und anschließend **Quell-Repositories** aus. 1. Wählen **Sie Repository hinzufügen** und anschließend **Repository verknüpfen** aus. 1. Wähle im Dropdownmenü **Repository-Anbieter** einen der folgenden Drittanbieter für Repositorys aus: **GitHub**oder **Bitbucket**. 1. Führe je nach Drittanbieter-Repository-Anbieter, den du für die Verknüpfung ausgewählt hast, einen der folgenden Schritte aus: + **GitHub Repositorien**: Verknüpfen Sie ein GitHub Repository. 1. **Wählen Sie im GitHub Dropdownmenü für das GitHub Konto das Konto aus, das das Repository enthält, das Sie verknüpfen möchten.** 1. Wählen Sie im **GitHub Repository-Dropdownmenü** das GitHub Konto aus, mit dem Sie Ihr CodeCatalyst Projekt verknüpfen möchten. 1. (Optional) Wenn Sie in der Liste der Repositorys kein GitHub Repository sehen, wurde es möglicherweise nicht für den Repository-Zugriff in der CodeCatalyst Amazon-Anwendung in GitHub konfiguriert. Sie können im verbundenen Konto konfigurieren, CodeCatalyst in welchen GitHub Repositorys verwendet werden können. 1. Navigieren Sie zu Ihrem [GitHub](https://github.com/)Konto, wählen Sie **Einstellungen** und dann **Anwendungen**. 1. Wählen Sie auf der Registerkarte **Installierte GitHub Apps** die Option **Konfigurieren** für die CodeCatalyst Amazon-Anwendung aus. 1. Gehen Sie wie folgt vor, um den Zugriff auf die GitHub Repositorys zu konfigurieren, die Sie verknüpfen möchten: CodeCatalyst + Wenn Sie Zugriff auf alle aktuellen und künftigen Repositorys gewähren möchten, wählen Sie **Alle Repositorys** aus. + Um Zugriff auf bestimmte Repositorys zu gewähren, wählen Sie **Nur ausgewählte Repositorys** aus, wählen Sie das Drop-down-Menü **Repositorys auswählen** und wählen Sie dann ein Repository aus, zu dem Sie eine Verknüpfung zulassen möchten. CodeCatalyst + **Bitbucket-Repositorys: Verbinde ein Bitbucket-Repository**. 1. Wähle im Dropdownmenü **Bitbucket-Workspace** den Bitbucket-Workspace aus, der das Repository enthält, das du verknüpfen möchtest. 1. Wähle im Dropdownmenü des **Bitbucket-Repositorys** das Bitbucket-Repository aus, das du mit deinem Projekt verknüpfen möchtest. CodeCatalyst **Tipp** Wenn der Name des Repositorys ausgegraut ist, können Sie dieses Repository nicht verknüpfen, da es bereits mit einem anderen Projekt in Amazon CodeCatalyst verknüpft wurde. 1. Wählen Sie **Verknüpfen**. Wenn du ein GitHub Repository, Bitbucket-Repository oder Projekt-Repository nicht mehr verwenden möchtest, kannst du die Verknüpfung mit einem GitLab Projekt aufheben. CodeCatalyst CodeCatalyst Wenn die Verknüpfung eines Repositorys aufgehoben wird, starten Ereignisse in diesem Repository keine Workflow-Läufe, und du kannst dieses Repository nicht mit CodeCatalyst Entwicklungsumgebungen verwenden. Weitere Informationen finden Sie unter [Aufheben der Verknüpfung von GitHub Repositorys, Bitbucket-Repositorys, GitLab Projekt-Repositorys und Jira-Projekten in CodeCatalyst](extensions-unlink.md). # Anzeigen eines Quell-Repositorys Sie können die mit einem Projekt verknüpften Quell-Repositorys in Amazon CodeCatalyst einsehen. Für Quell-Repositorys in CodeCatalyst bietet die Übersichtsseite für ein Repository einen schnellen Überblick über Informationen und Aktivitäten in diesem Repository, einschließlich: + Die Beschreibung des Repositorys, falls vorhanden + Die Anzahl der Branches im Repository + Die Anzahl der offenen Pull-Requests für das Repository + Die Anzahl verwandter Workflows für das Repository + Die Dateien und Ordner in der Standardverzweigung oder in der Verzweigung, die Sie wählen + Der Titel, der Autor und das Datum der letzten Übertragung in den angezeigten Zweig + Der Inhalt der README.md-Datei wurde in Markdown gerendert, sofern eine README.md-Datei enthalten ist Diese Seite bietet auch Links zu den Commits, Branches und Pull-Requests für das Repository sowie eine schnelle Möglichkeit, einzelne Dateien zu öffnen, anzusehen und zu bearbeiten. **Anmerkung** Sie können diese Informationen zu verknüpften Repositorys nicht in der CodeCatalyst Konsole einsehen. Um Informationen über verknüpfte Repositorys anzuzeigen, wählen Sie den Link in der Liste der Repositorys, um das Repository in dem Dienst zu öffnen, der es hostet. **Um zu den Quell-Repositorys für ein Projekt zu navigieren** 1. Navigieren Sie zu Ihrem Projekt und führen Sie einen der folgenden Schritte aus: + Wählen Sie auf der Übersichtsseite für Ihr Projekt das gewünschte Repository aus der Liste aus und klicken Sie dann **auf Repository anzeigen**. + Wählen Sie im Navigationsbereich **Code** und dann **Quell-Repositorys** aus. Wählen Sie unter **Quell-Repositorys** den Namen des Repositorys aus der Liste aus. Sie können die Liste der Repositorys filtern, indem Sie einen Teil des Repository-Namens in die Filterleiste eingeben. 1. Sehen Sie sich auf der Startseite des Repositorys den Inhalt des Repositorys und Informationen zu den zugehörigen Ressourcen an, z. B. die Anzahl der Pull-Requests und Workflows. Standardmäßig werden die Inhalte für den Standard-Branch angezeigt. Sie können die Ansicht ändern, indem Sie einen anderen Zweig aus der Dropdownliste auswählen. **Tipp** Sie können auch schnell zu den Repositorys Ihres Projekts navigieren, indem Sie auf der Seite mit der **Projektzusammenfassung die Option Projektcode anzeigen** auswählen. # Einstellungen für ein Quell-Repository bearbeiten Du kannst die Einstellungen für dein Repository verwalten, einschließlich der Bearbeitung der Beschreibung eines Repositorys, der Auswahl des Standard-Branches, der Erstellung und Verwaltung von Branch-Regeln und der Erstellung und Verwaltung von Genehmigungsregeln für Pull Requests in CodeCatalyst. Auf diese Weise können die Projektmitglieder verstehen, wofür das Repository verwendet wird, und Sie können die vom Team verwendeten bewährten Methoden und Prozesse durchsetzen. **Anmerkung** Sie können den Namen eines Quell-Repositorys nicht bearbeiten. Sie können den Namen, die Beschreibung oder andere Informationen für ein verknüpftes Repository in nicht bearbeiten CodeCatalyst. Um Informationen über ein verknüpftes Repository zu ändern, müssen Sie sie in dem Anbieter bearbeiten, der das verknüpfte Repository hostet. Weitere Informationen finden Sie in der Dokumentation des Dienstes, der das verknüpfte Repository hostet. **Um die Einstellungen eines Repositorys zu bearbeiten** 1. Navigieren Sie in der CodeCatalyst Konsole zu dem Projekt, das das Quell-Repository enthält, dessen Einstellungen Sie bearbeiten möchten. 1. Wählen Sie auf der Übersichtsseite Ihres Projekts das gewünschte Repository aus der Liste aus und klicken Sie dann **auf Repository anzeigen**. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositorys** auswählen. Wählen Sie den Namen des Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. 1. Wählen Sie auf der Übersichtsseite für das Repository die Option **Mehr** und anschließend **Einstellungen verwalten** aus. 1. Führen Sie eine oder mehrere der folgenden Aktionen aus: + Bearbeiten Sie die Beschreibung des Repositorys und wählen Sie dann **Speichern**. + Um den Standardzweig für das Repository zu ändern, wählen Sie unter **Standardzweig** die Option **Bearbeiten** aus. Weitere Informationen finden Sie unter [Den Standard-Branch für ein Repository verwalten](source-branches-default-branch.md). + Um eine Regel hinzuzufügen, zu entfernen oder zu ändern, nach der Projektrollen berechtigt sind, bestimmte Aktionen in einem Branch auszuführen, zu entfernen oder zu ändern, wählen Sie **unter Branch-Regeln** die Option **Bearbeiten** aus. Weitere Informationen finden Sie unter [Zulässige Aktionen für einen Branch mit Branch-Regeln verwalten](source-branches-branch-rules.md). + **Um eine Genehmigungsregel für das Zusammenführen von Pull-Requests zu einem Branch hinzuzufügen, zu entfernen oder zu ändern, wählen Sie unter **Genehmigungsregeln** die Option Bearbeiten aus.** Weitere Informationen finden Sie unter [Verwaltung der Anforderungen für das Zusammenführen einer Pull-Anfrage mit Genehmigungsregeln](source-pull-requests-approval-rules.md). # Klonen eines Quell-Repositorys Um effektiv mit mehreren Dateien, Branches und Commits in Quell-Repositorys zu arbeiten, klonen Sie das Quell-Repository auf Ihren lokalen Computer und verwenden Sie einen Git-Client oder eine integrierte Entwicklungsumgebung (IDE), um Änderungen vorzunehmen. Übernehmen Sie Ihre Änderungen und übertragen Sie sie in das Quell-Repository, um mit CodeCatalyst Funktionen wie Issues und Pull-Requests arbeiten zu können. Sie können sich auch dafür entscheiden, eine Entwicklungsumgebung zu erstellen, um an Code zu arbeiten. Beim Erstellen einer Entwicklungsumgebung werden das von Ihnen angegebene Repository und die von Ihnen angegebene Verzweigung automatisch in die Entwicklungsumgebung geklont. **Anmerkung** Es ist nicht möglich, verknüpfte Repositorys in der CodeCatalyst Konsole zu klonen oder Entwicklungsumgebungen für sie zu erstellen. Um ein verknüpftes Repository lokal zu klonen, wählen Sie den Link in der Liste der Repositorys aus, um das Repository in dem Dienst zu öffnen, der es hostet, und klonen Sie es dann. Weitere Informationen finden Sie in der Dokumentation des Dienstes, der das verknüpfte Repository hostet. **Um eine Entwicklungsumgebung aus einem Quell-Repository zu erstellen** 1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/). 1. Wählen Sie im Navigationsbereich **Code** und anschließend **Source Repositories** aus. 1. Wählen Sie das Quell-Repository aus, in dem Sie am Code arbeiten möchten. 1. Wählen Sie **Create Dev Environment** aus. 1. Wählen Sie eine unterstützte IDE aus dem Drop-down-Menü aus. Weitere Informationen finden Sie unter [Unterstützte integrierte Entwicklungsumgebungen für Entwicklungsumgebungen](devenvironment-create.md#devenvironment-supported-ide). 1. Führen Sie eine der folgenden Aktionen aus: + Wählen Sie **In vorhandenem Zweig arbeiten** und wählen Sie dann einen Zweig aus dem Drop-down-Menü **Bestehender Zweig** aus. + Wählen Sie **In neuer Filiale arbeiten** aus, geben Sie einen Filialnamen in das Feld **Filialname** ein und wählen Sie aus dem Drop-down-Menü Filiale erstellen aus eine Filiale aus, aus der die neue **Filiale erstellt** werden soll. 1. Fügen Sie optional einen Namen für die Entwicklungsumgebung hinzu oder bearbeiten Sie deren Konfiguration. 1. Wählen Sie **Erstellen** aus. **Um ein Quell-Repository zu klonen** 1. Navigiere zu deinem Projekt. 1. Wählen Sie auf der Übersichtsseite Ihres Projekts das gewünschte Repository aus der Liste aus und klicken Sie dann **auf Repository anzeigen**. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositorys** auswählen. Wählen Sie den Namen des Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. Sie können die Liste der Repositorys filtern, indem Sie einen Teil des Repository-Namens in die Filterleiste eingeben. 1. 1. Wählen Sie **Repository klonen**. Kopieren Sie die Klon-URL für das Repository. **Anmerkung** Wenn Sie kein Personal Access Token (PAT) haben, wählen Sie **Create token**. Kopieren Sie das Token und speichern Sie es an einem sicheren Ort. Sie verwenden diese PAT, wenn Sie von Ihrem Git-Client oder Ihrer integrierten Entwicklungsumgebung (IDE) zur Eingabe eines Kennworts aufgefordert werden. 1. Führen Sie eine der folgenden Aktionen aus: + Um ein Repository auf Ihren lokalen Computer zu klonen, öffnen Sie ein Terminal oder eine Befehlszeile und führen Sie den **git clone** Befehl mit der Klon-URL nach dem Befehl aus. Beispiel: ``` git clone https://LiJuan@git.us-west-2.codecatalyst.aws/v1/ExampleCorp/MyExampleProject/MyExampleRepo ``` Wenn Sie zur Eingabe eines Kennworts aufgefordert werden, fügen Sie die zuvor gespeicherte PAT ein. **Anmerkung** Wenn Ihr Betriebssystem die Verwaltung von Anmeldeinformationen unterstützt oder Sie ein Anmeldeinformationsverwaltungssystem installiert haben, müssen Sie die PAT nur einmal angeben. Wenn nicht, müssen Sie möglicherweise die PAT für jede Git-Operation angeben. Als bewährte Methode sollten Sie sicherstellen, dass Ihr Anmeldeinformationsverwaltungssystem Ihre PAT sicher speichert. Nehmen Sie die PAT nicht als Teil der Klon-URL-Zeichenfolge auf. + Um ein Repository mit einer IDE zu klonen, folgen Sie der Dokumentation für Ihre IDE. Wählen Sie die Option zum Klonen eines Git-Repositorys und geben Sie die URL an. Wenn Sie zur Eingabe eines Passworts aufgefordert werden, geben Sie das PAT an. # Löschen eines Quell-Repositorys Wenn ein Quell-Repository für ein CodeCatalyst Amazon-Projekt nicht mehr benötigt wird, können Sie es löschen. Durch das Löschen eines Quell-Repositorys werden auch alle im Repository gespeicherten Projektinformationen gelöscht. Wenn Workflows vom Quell-Repository abhängen, werden diese Workflows nach dem Löschen des Repositorys aus der Liste der Projekt-Workflows gelöscht. Probleme, die auf das Quell-Repository verweisen, werden nicht gelöscht oder geändert, aber alle Links zum Quell-Repository, die zu Issues hinzugefügt wurden, schlagen fehl, sobald das Repository gelöscht wird. **Wichtig** Das Löschen eines Quell-Repositorys kann nicht rückgängig gemacht werden. Nachdem Sie ein Quell-Repository gelöscht haben, können Sie es nicht mehr klonen, Daten daraus abrufen oder Daten dorthin übertragen. Durch das Löschen eines Quell-Repositorys werden keine lokalen Kopien dieses Repositorys (lokale Repos) gelöscht. Verwenden Sie die Verzeichnis- und Dateiverwaltungstools Ihres lokalen Computers, um ein lokales Repository zu löschen. **Anmerkung** Sie können ein verknüpftes Repository nicht in der CodeCatalyst Konsole löschen. Um ein verknüpftes Repository zu löschen, wählen Sie den Link in der Liste der Repositorys aus, um das Repository in dem Dienst zu öffnen, der es hostet, und löschen Sie es dann. Weitere Informationen finden Sie in der Dokumentation des Dienstes, der das verknüpfte Repository hostet. Informationen zum Entfernen eines verknüpften Repositorys aus einem Projekt finden Sie unter[Aufheben der Verknüpfung von GitHub Repositorys, Bitbucket-Repositorys, GitLab Projekt-Repositorys und Jira-Projekten in CodeCatalyst](extensions-unlink.md). **Um ein Quell-Repository zu löschen** 1. Navigieren Sie zu dem Projekt, das das Quell-Repository enthält, das Sie löschen möchten. 1. Wählen Sie auf der Übersichtsseite für Ihr Projekt das gewünschte Repository aus der Liste aus und klicken Sie dann **auf Repository anzeigen**. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositorys** auswählen. Wählen Sie den Namen des Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. 1. Wählen Sie auf der Startseite des Repositorys die Option **Mehr**, dann **Einstellungen verwalten** und anschließend **Repository löschen** aus. 1. Überprüfe den Branch, den Pull Request und die zugehörigen Workflow-Informationen, um sicherzustellen, dass du kein Repository löschst, das noch verwendet wird oder dessen Arbeit noch nicht abgeschlossen ist. Wenn Sie fortfahren möchten, geben Sie **Löschen** ein und wählen Sie dann **Löschen** aus. # Organisation Ihrer Quellcode-Arbeit mit Filialen in Amazon CodeCatalyst In Git sind Branches Zeiger oder Verweise auf einen Commit. In der Entwicklung sind sie eine praktische Möglichkeit, die Arbeit zu organisieren. Du kannst Branches verwenden, um die Arbeit an einer neuen oder anderen Version von Dateien voneinander zu trennen, ohne die Arbeit in anderen Branches zu beeinträchtigen. Sie können Verzweigungen verwenden, um neue Funktionen zu entwickeln, eine bestimmte Version Ihres Projekts zu speichern und vieles mehr. Sie können Regeln für Branches in Quell-Repositorys konfigurieren, um bestimmte Aktionen in einem Branch auf bestimmte Rollen in diesem Projekt zu beschränken. Quell-Repositorys in Amazon CodeCatalyst haben Inhalte und einen Standardzweig, unabhängig davon, wie Sie sie erstellen. Verknüpfte Repositorys haben möglicherweise keinen Standard-Branch oder Inhalt, sind aber CodeCatalyst erst nutzbar, wenn Sie sie initialisieren und einen Standard-Branch erstellen. Wenn Sie ein Projekt mithilfe eines Blueprints erstellen, CodeCatalyst wird ein Quell-Repository für dieses Projekt erstellt, das eine README.md-Datei, Beispielcode, Workflow-Definitionen und andere Ressourcen enthält. *Wenn Sie ein Quell-Repository erstellen, ohne einen Blueprint zu verwenden, wird als erster Commit eine README.md-Datei für Sie hinzugefügt, und ein Standardzweig wird für Sie erstellt.* *Dieser Standardzweig heißt main.* Dieser Standardzweig wird als Basis- oder Standardzweig in lokalen Repositorys (Repos) verwendet, wenn Benutzer das Repository klonen. **Anmerkung** Sie können den Standardzweig nicht löschen. Der erste Branch, der für ein Quell-Repository erstellt wurde, ist der Standard-Branch für dieses Repository. Darüber hinaus zeigt die Suche nur Ergebnisse aus dem Standardzweig an. Sie können in anderen Branchen nicht nach Code suchen. Beim Erstellen eines Repositorys in wird CodeCatalyst auch ein erster Commit erstellt, der einen *Standard-Branch* mit einer darin enthaltenen README.md-Datei erstellt. *Der Name dieses Standardzweigs ist main.* Dies ist der Standard-Zweigname, der in den Beispielen in diesem Handbuch verwendet wird. **Topics** + [Eine Filiale erstellen](source-create-delete-branch.md) + [Den Standard-Branch für ein Repository verwalten](source-branches-default-branch.md) + [Zulässige Aktionen für einen Branch mit Branch-Regeln verwalten](source-branches-branch-rules.md) + [Git-Befehle für Branches](source-branches-git.md) + [Filialen und Details anzeigen](source-branches-view.md) + [Löschen eines Zweigs](source-branches-delete.md) # Eine Filiale erstellen Sie können die CodeCatalyst Konsole verwenden, um Branches in einem CodeCatalyst Repository zu erstellen. Die von Ihnen erstellten Branches sind für andere Benutzer sichtbar, wenn sie das nächste Mal Änderungen aus dem Repository abrufen. **Tipp** Sie können im Rahmen der Erstellung einer Entwicklungsumgebung auch Branches erstellen, um an Ihrem Code zu arbeiten. Weitere Informationen finden Sie unter [Erstellen einer Entwicklungsumgebung](devenvironment-create.md). Du kannst Git auch verwenden, um Branches zu erstellen. Weitere Informationen finden Sie unter [Allgemeine Git-Befehle für Branches](source-branches-git.md#source-branches-git-table). **Um einen Zweig (Konsole) zu erstellen** 1. Navigieren Sie in der CodeCatalyst Konsole zu dem Projekt, in dem sich Ihr Quell-Repository befindet. 1. Wählen Sie den Namen des Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositories** auswählen. 1. Wählen Sie das Repository aus, in dem Sie einen Branch erstellen möchten. 1. Wählen Sie auf der Übersichtsseite des Repositorys die Option **Mehr** und dann **Zweig erstellen** aus. 1. Geben Sie einen Namen für den Branch ein. 1. Wählen Sie einen Zweig aus, aus dem der Zweig erstellt werden soll, und klicken Sie dann auf **Erstellen**. # Den Standard-Branch für ein Repository verwalten Sie können angeben, welcher Branch als *Standard-Branch* in einem Quell-Repository in Amazon verwendet werden soll CodeCatalyst. Alle Quell-Repositorys in CodeCatalyst haben Inhalte und einen Standardzweig, unabhängig davon, wie Sie sie erstellen. *Wenn Sie einen Blueprint verwenden, um ein Projekt zu erstellen, heißt der Standardzweig im Quell-Repository, der für dieses Projekt erstellt wurde, main.* Der Inhalt des Standardzweigs wird automatisch auf der Übersichtsseite für dieses Repository angezeigt. **Wichtig** CodeCatalyst unterstützt nicht die Erkennung von Änderungen im Standard-Branch für verknüpfte Repositorys. Um den Standardzweig für ein verknüpftes Repository zu ändern, müssen Sie zuerst die Verknüpfung mit dem Repository CodeCatalyst aufheben, den Standardzweig ändern und ihn dann erneut verknüpfen. Weitere Informationen finden Sie unter [Verknüpfen von GitHub Repositorys, Bitbucket-Repositorys, GitLab Projekt-Repositorys und Jira-Projekten in CodeCatalyst](extensions-link.md). Als bewährte Methode sollten Sie immer sicherstellen, dass Sie über die neueste Version der Erweiterung verfügen, bevor Sie ein Repository verknüpfen. Der Standard-Branch wird etwas anders behandelt als alle anderen Branches in einem Quell-Repository. Neben seinem Namen steht ein spezielles Label, **Default**. Der Standard-Branch wird als Basis- oder Standard-Branch in lokalen Repositorys (Repos) verwendet, wenn Benutzer das Repository mit einem Git-Client auf lokale Computer klonen. Er ist auch der Standard, der bei der Erstellung von Workflows zum Speichern von Workflow-YAML-Dateien und zum Speichern von Informationen für Probleme verwendet wird. Wenn Sie „Suchen in“ verwenden CodeCatalyst, wird nur der Standardzweig eines Repositorys durchsucht. Da der Standardzweig für so viele Aspekte von Projekten von grundlegender Bedeutung ist, können Sie einen Branch nicht löschen, wenn er als Standard-Branch angegeben ist. Sie können sich jedoch dafür entscheiden, einen anderen Zweig als Standardzweig zu verwenden. Wenn Sie dies tun, werden alle [Zweigregeln](source-branches-branch-rules.md), die auf den früheren Standardzweig angewendet wurden, automatisch auf den Zweig angewendet, den Sie als Standardzweig angeben. **Anmerkung** Sie benötigen die Rolle eines Projektadministrators, um den Standardzweig für Quell-Repositorys in CodeCatalyst Projekten ändern zu können. Dies gilt nicht für verknüpfte Repositorys. **Um den Standard-Branch für ein Repository anzuzeigen und zu ändern** 1. Navigieren Sie zu dem Projekt, in dem sich Ihr Repository befindet. 1. Wählen Sie den Namen des Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositories** auswählen. Wählen Sie das Repository aus, in dem Sie die Einstellungen, einschließlich des Standardzweigs, anzeigen möchten. 1. Wählen Sie auf der Übersichtsseite des Repositorys die Option **Mehr** und anschließend **Einstellungen verwalten** aus. 1. Im **Standardzweig** wird der Name des als Standardverzweigung angegebenen Zweigs zusammen mit der Bezeichnung **Standard** neben dem Namen angezeigt. Dieselbe Bezeichnung wird neben dem Zweignamen in der Liste der Zweige unter **Zweige** angezeigt. 1. Um den Standardzweig zu ändern, wählen Sie **Bearbeiten**. **Anmerkung** Sie müssen im Projekt über die Rolle des Projektadministrators verfügen, um den Standardzweig ändern zu können. 1. Wählen Sie aus der Dropdownliste den Namen des Zweigs aus, den Sie zum Standardzweig machen möchten, und wählen Sie dann **Speichern** aus. # Zulässige Aktionen für einen Branch mit Branch-Regeln verwalten Wenn Sie einen Branch erstellen, sind je nach den Berechtigungen für diese Rolle bestimmte Aktionen für diesen Branch zulässig. Sie können ändern, welche Aktionen für einen bestimmten Zweig zulässig sind, indem Sie Zweigregeln konfigurieren. Branch-Regeln basieren auf der Rolle, die ein Benutzer in Ihrem Projekt innehat. Sie können sich dafür entscheiden, einige vordefinierte Aktionen, wie das Übertragen von Commits an einen Branch, auf Benutzer mit einer bestimmten Rolle in einem Projekt zu beschränken. Auf diese Weise können Sie bestimmte Branches in einem Projekt schützen, indem Sie einschränken, welche Rollen bestimmte Aktionen ausführen dürfen. Wenn Sie beispielsweise eine Verzweigungsregel so konfigurieren, dass nur Benutzer mit der Rolle des **Projektadministrators** diesen Zweig zusammenführen oder zu diesem Zweig wechseln können, können Benutzer mit anderen Rollen im Projekt keine Änderungen am Code in diesem Zweig vornehmen. Sie sollten alle Auswirkungen der Erstellung einer Regel für einen Zweig sorgfältig abwägen. Wenn Sie sich beispielsweise dafür entscheiden, Pushs auf einen Branch auf Benutzer mit der Rolle **Project Administrator** zu beschränken, können Benutzer mit der Rolle **Contributor** keine Workflows in diesem Branch erstellen oder bearbeiten, da das Workflow-YAML in diesem Branch gespeichert ist und diese Benutzer keine Änderungen an der YAML festschreiben und per Push übertragen können. Es hat sich bewährt, alle Branch-Regeln zu testen, nachdem Sie sie erstellt haben, um sicherzustellen, dass sie keine Auswirkungen haben, die Sie nicht beabsichtigt haben. Sie können Branch-Regeln auch in Verbindung mit Genehmigungsregeln für Pull Requests verwenden. Weitere Informationen finden Sie unter [Verwaltung der Anforderungen für das Zusammenführen einer Pull-Anfrage mit Genehmigungsregeln](source-pull-requests-approval-rules.md). **Anmerkung** Sie benötigen die Rolle eines Projektadministrators, um Branch-Regeln für Quell-Repositorys in CodeCatalyst Projekten verwalten zu können. Sie können keine Branch-Regeln für verknüpfte Repositorys erstellen. Sie können nur Branch-Regeln erstellen, die restriktiver sind als die Standardberechtigungen für die Rolle. Sie können keine Verzweigungsregeln erstellen, die freizügiger sind, als es die Rolle eines Benutzers im Projekt zulässt. Sie können beispielsweise keine Branch-Regel erstellen, die es Benutzern mit der Rolle Reviewer ermöglicht, Push in den Branch zu übertragen. Branch-Regeln, die auf den Standard-Branch Ihres Quell-Repositorys angewendet werden, verhalten sich etwas anders als Branch-Regeln, die auf andere Branches angewendet werden. Jede Regel, die auf den Standard-Branch angewendet wird, wird automatisch auf jeden Branch angewendet, den Sie als Standard-Branch angeben. Der Zweig, der zuvor als Standardzweig festgelegt wurde, behält weiterhin die Regeln bei, die auf ihn angewendet wurden, mit der Ausnahme, dass er nicht mehr vor dem Löschen geschützt ist. Dieser Schutz wird nur auf den aktuellen Standardzweig angewendet. Zweigregeln haben zwei Status: **Standard** und **Benutzerdefiniert**. **Standard** gibt an, dass die in einem Branch zulässigen Aktionen den Berechtigungen entsprechen, die der Benutzer für Branch-Aktionen in CodeCatalyst der Rolle hat, über die der Benutzer verfügt. Weitere Informationen darüber, welche Rollen welche Berechtigungen haben, finden Sie unter[Zugriff mit Benutzerrollen gewähren](ipa-roles.md). **Benutzerdefiniert** gibt an, dass eine oder mehrere Branch-Aktionen Aktionen mit einer bestimmten Liste von Rollen haben, die diese Aktion ausführen dürfen. Diese Liste unterscheidet sich von den Standardberechtigungen, die durch die Rolle eines Benutzers im Projekt gewährt werden. **Anmerkung** Wenn Sie eine Verzweigungsregel erstellen, um eine oder mehrere Aktionen für einen Zweig einzuschränken, wird **die Aktion Verzweigung löschen** automatisch so eingestellt, dass nur Benutzer mit der Projektadministratorrolle diesen Zweig löschen können. In der folgenden Tabelle sind die Aktionen und die Standardeinstellungen für Rollen aufgeführt, die diese Aktionen in einem Zweig ausführen dürfen. **Aktionen und Rollen in Zweigen** | **Maßnahmen in der Branche** | Rollen, die diese Aktion ausführen dürfen, wenn keine Branch-Regeln angewendet werden | | --- | --- | | Mit dem Branch zusammenführen (dazu gehört auch das Zusammenführen einer Pull-Anfrage mit dem Branch) | Projektadministrator, Mitwirkender | | Gehen Sie zur Filiale | Projektadministrator, Mitwirkender | | Löschen Sie den Zweig | Projektadministrator, Mitwirkender | | Löschen Sie den Zweig (Standardzweig) | Nicht zulässig | Sie können Branch-Regeln nicht löschen, aber Sie können sie so aktualisieren, dass Aktionen von allen Rollen zugelassen werden, die diese Aktion in einem Branch ausführen dürfen, wodurch die Regel effektiv entfernt wird. **Anmerkung** Sie benötigen die Rolle eines Projektadministrators, um Verzweigungsregeln für Quell-Repositorys in CodeCatalyst Projekten konfigurieren zu können. Dies gilt nicht für verknüpfte Repositorys. Verknüpfte Repositorys unterstützen die Branch-Regeln in nicht. CodeCatalyst **Um Branch-Regeln für ein Repository anzuzeigen und zu bearbeiten** 1. Navigieren Sie zu dem Projekt, in dem sich Ihr Repository befindet. 1. Wählen Sie den Namen des Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositorys** auswählen. Wählen Sie das Repository aus, in dem Sie Branch-Regeln anzeigen möchten. 1. Wählen Sie auf der Übersichtsseite des Repositorys die Option **Branches** aus. 1. Sehen Sie sich in der Spalte **Branch-Regeln** den Status der Regeln für jeden Branch des Repositorys an. **Standard** gibt an, dass die Regeln für Branch-Aktionen die Standardregeln für alle Branches sind, die in einem Quell-Repository erstellt wurden, und dass sie den Berechtigungen entsprechen, die diesen Rollen in einem Projekt gewährt wurden. **Benutzerdefiniert** gibt an, dass für eine oder mehrere Branch-Aktionen Regeln gelten, die eine oder mehrere Aktionen, die für diesen Branch zulässig sind, auf eine andere Gruppe von Rollen beschränken. Um die Einzelheiten der Branch-Regeln für einen Branch einzusehen, wählen Sie neben dem Zweig, den Sie überprüfen möchten, das Wort **Standard** oder **Benutzerdefiniert** aus. 1. Um eine Zweigregel zu erstellen oder zu ändern, wählen Sie **Einstellungen verwalten**. Wählen Sie auf der Einstellungsseite für das Quell-Repository unter **Branch-Regeln die** Option **Bearbeiten** aus. 1. Wählen Sie unter **Branch** den Namen des Branches, für den Sie eine Regel konfigurieren möchten, aus der Dropdownliste aus. Wählen Sie für jeden der zulässigen Aktionstypen aus der Dropdownliste die Rollen aus, denen Sie die Aktion zuweisen möchten, und wählen Sie dann **Speichern** aus. # Git-Befehle für Branches Du kannst Git verwenden, um Branches im Clone des Quell-Repositorys, das du auf deinem Computer (deinem lokalen Repo) oder in deinen Entwicklungsumgebungen hast, zu erstellen, zu verwalten und zu löschen. Anschließend kannst du deine Änderungen in dein CodeCatalyst Quell-Repository (das Remote-Repository) übertragen und per Push übertragen. Beispiel: **Allgemeine Git-Befehle für Branches** | | | | --- |--- | | Listet alle Branches im lokalen Repository auf, wobei neben deinem aktuellen Branch ein Sternchen (`*`) angezeigt wird. | `git branch` | | Ruft Informationen über alle vorhandenen Branches im Remote-Repository in das lokale Repository ab. | `git fetch` | | Listet alle Branches im lokalen Repo und alle Remote-Tracking-Zweige im lokalen Repo auf. | `git branch -a` | | Listet nur Remote-Tracking-Zweige im lokalen Repo auf. | `git branch -r` | | Erstellt einen Zweig im lokalen Repository unter Verwendung des angegebenen Zweignamens. Dieser Branch wird erst im Remote-Repository angezeigt, wenn Sie die Änderung festschreiben und übertragen. | `git branch branch-name` | | Erstellt einen Branch im lokalen Repository unter Verwendung des angegebenen Branch-Namens und wechselt dann zu diesem. | `git checkout -b branch-name` | | Wechselt unter Verwendung des angegebenen Zweignamens zu einem anderen Zweig im lokalen Repository. | `git checkout other-branch-name` | | Verschiebt einen Branch vom lokalen Repository zum Remote-Repository und verwendet dabei den im lokalen Repository angegebenen Spitznamen für das Remote-Repository und den angegebenen Branch-Namen. Richtet außerdem Upstream-Tracking-Informationen für den Branch im lokalen Repository ein. | `git push -u remote-name branch-name` | | Führt Änderungen von einem anderen Zweig im lokalen Repository mit dem aktuellen Zweig im lokalen Repository zusammen. | `git merge from-other-branch-name` | | Löscht einen Zweig im lokalen Repository, es sei denn, er enthält Werke, die noch nicht zusammengeführt wurden. | `git branch -d branch-name` | | Löscht einen Branch im Remote-Repository mit dem angegebenen Spitznamen, den das lokale Repository für das Remote-Repository hat, und dem angegebenen Branch-Namen. (Beachten Sie die Verwendung des Doppelpunkts (`:`).) Sie können dies auch `--delete` als Teil des Befehls angeben. | `git push remote-name :branch-name` `git push remote-name --delete branch-name` | Weitere Informationen findest du in deiner Git-Dokumentation. # Filialen und Details anzeigen In der CodeCatalyst Amazon-Konsole können Sie Informationen zu Remote-Branches in Amazon einsehen CodeCatalyst, einschließlich Einzelheiten zu den Dateien, Ordnern und dem letzten Commit für eine bestimmte Filiale. Sie können auch Git-Befehle und Ihr lokales Betriebssystem verwenden, um diese Informationen für entfernte und lokale Niederlassungen anzuzeigen. **Um Branches anzuzeigen (Konsole)** 1. Navigieren Sie in der CodeCatalyst Konsole zu dem Projekt, das das Quell-Repository enthält, in dem Sie die Branches anzeigen möchten. Wählen Sie **Code**, dann **Quell-Repositories** und anschließend das Quell-Repository aus. 1. Wählen Sie den Namen des Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositories** auswählen. Wählen Sie das Repository aus, in dem Sie einen Branch anzeigen möchten. 1. Der Standardzweig des Repositorys wird angezeigt. Sie können eine Liste der Dateien und Ordner im Branch, Informationen über den letzten Commit und den Inhalt der README.md-Datei, falls sie im Branch vorhanden ist, sehen. Um die Informationen für einen anderen Branch anzuzeigen, wählen Sie ihn aus der Dropdownliste der Branches für das Repository aus. 1. Um alle Branches für ein Repository anzuzeigen, wählen Sie **Alle anzeigen**. Auf der Seite „Branches“ werden Informationen zum Namen, zum letzten Commit und zu den Regeln für jeden Branch angezeigt. Informationen dazu, wie du Git und dein Betriebssystem zum Anzeigen von Branches und Details verwendest, findest du unter [Allgemeine Git-Befehle für Branches](source-branches-git.md#source-branches-git-table), in deiner Git-Dokumentation und in deiner Betriebssystemdokumentation. # Löschen eines Zweigs Wenn Sie einen Branch nicht mehr benötigen, können Sie ihn löschen. Wenn Sie beispielsweise einen Branch mit einer Feature-Änderung mit dem Standard-Branch zusammengeführt haben und dieses Feature veröffentlicht wurde, möchten Sie vielleicht den ursprünglichen Feature-Branch löschen, da die Änderungen bereits Teil des Standard-Branches sind. Wenn Sie die Anzahl der Zweige gering halten, können Benutzer den Zweig leichter finden, der die Änderungen enthält, an denen sie arbeiten möchten. Wenn Sie einen Zweig löschen, verbleiben Kopien dieses Zweigs in den Klonen des Repositorys auf lokalen Computern, bis Benutzer diese Änderungen abrufen und synchronisieren. **Um einen Branch zu löschen (Konsole)** 1. Navigieren Sie zu dem Projekt, in dem sich Ihr Repository befindet. 1. Wählen Sie den Namen des Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositorys** auswählen. Wählen Sie das Repository aus, in dem Sie einen Branch löschen möchten. 1. Wählen Sie auf der Übersichtsseite des Repositorys die Dropdownauswahl neben dem Branch-Namen und wählen Sie dann **Alle anzeigen** aus. 1. Wählen Sie den Zweig aus, den Sie löschen möchten, und klicken Sie dann auf **Zweig löschen**. **Anmerkung** Sie können den Standardzweig für ein Repository nicht löschen. 1. Ein Bestätigungsdialogfeld wird angezeigt. Es zeigt das Repository, die Anzahl der geöffneten Pull-Requests und die Anzahl der Workflows, die dem Branch zugeordnet sind. 1. Um das Löschen des Branches zu bestätigen, geben **Sie Löschen** in das Textfeld ein und wählen Sie dann **Löschen** aus. Du kannst Git auch verwenden, um Branches zu löschen. Weitere Informationen finden Sie unter [Allgemeine Git-Befehle für Branches](source-branches-git.md#source-branches-git-table). # Verwaltung von Quellcodedateien in Amazon CodeCatalyst Bei Amazon CodeCatalyst ist eine Datei eine versionsgesteuerte, eigenständige Information, die Ihnen und anderen Benutzern des Quell-Repositorys und Zweigs, in dem die Datei gespeichert ist, zur Verfügung steht. Sie können Ihre Repository-Dateien mit einer Verzeichnisstruktur organisieren. CodeCatalystverfolgt automatisch jede festgeschriebene Änderung an einer Datei. Sie können verschiedene Versionen einer Datei in verschiedenen Repository-Zweigen speichern. Um mehrere Dateien in einem Quell-Repository hinzuzufügen oder zu bearbeiten, können Sie einen Git-Client, eine Entwicklungsumgebung oder eine integrierte Entwicklungsumgebung (IDE) verwenden. Um eine einzelne Datei hinzuzufügen oder zu bearbeiten, können Sie die CodeCatalyst Konsole verwenden. **Topics** + [Eine Datei erstellen oder hinzufügen](source-files-create.md) + [Eine Datei ansehen](source-files-view.md) + [Den Verlauf der Änderungen an einer Datei anzeigen](source-files-view-history.md) + [Bearbeiten einer Datei](source-files-edit.md) + [Eine Datei umbenennen oder löschen](source-files-delete.md) # Eine Datei erstellen oder hinzufügen Um Dateien zu erstellen und einem Quell-Repository hinzuzufügen, können Sie die CodeCatalyst Amazon-Konsole, eine Entwicklungsumgebung, eine verbundene integrierte Entwicklungsumgebung (IDE) oder einen Git-Client verwenden. Die CodeCatalyst Konsole enthält einen Code-Editor zum Erstellen von Dateien. Dieser Editor ist eine bequeme Möglichkeit, eine einfache Datei, z. B. eine README.md-Datei, in einem Zweig eines Repositorys zu erstellen oder zu bearbeiten. Wenn Sie an mehr als einer Datei arbeiten, sollten Sie erwägen, eine Entwicklungsumgebung [zu erstellen](devenvironment-create.md). **Um eine Entwicklungsumgebung aus einem Quell-Repository zu erstellen** 1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/). 1. Wählen Sie im Navigationsbereich **Code** und anschließend **Source Repositories** aus. 1. Wählen Sie das Quell-Repository aus, in dem Sie am Code arbeiten möchten. 1. Wählen Sie **Create Dev Environment** aus. 1. Wählen Sie eine unterstützte IDE aus dem Drop-down-Menü aus. Weitere Informationen finden Sie unter [Unterstützte integrierte Entwicklungsumgebungen für Entwicklungsumgebungen](devenvironment-create.md#devenvironment-supported-ide). 1. Führen Sie eine der folgenden Aktionen aus: + Wählen Sie **In vorhandenem Zweig arbeiten** und wählen Sie dann im Dropdownmenü **Bestehender Zweig** einen Zweig aus. + Wählen Sie **In neuer Filiale arbeiten** aus, geben Sie einen Filialnamen in das Feld **Filialname** ein und wählen Sie aus dem Drop-down-Menü Filiale erstellen aus eine Filiale aus, aus der die neue **Filiale erstellt** werden soll. 1. Fügen Sie optional einen Namen für die Entwicklungsumgebung hinzu oder bearbeiten Sie deren Konfiguration. 1. Wählen Sie **Erstellen** aus. **Um eine Datei in der CodeCatalyst Konsole zu erstellen** 1. Navigieren Sie zu dem Projekt, in dem Sie eine Datei erstellen möchten. Weitere Informationen zum Navigieren zu einem Repository finden Sie unter[Anzeigen eines Quell-Repositorys](source-repositories-view.md). 1. Wählen Sie den Namen des Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositorys** auswählen. Wählen Sie das Repository aus, in dem Sie die Datei erstellen möchten. 1. (Optional) Wählen Sie den Zweig aus, in dem Sie die Datei erstellen möchten, wenn Sie die Datei in einem anderen Zweig als dem Standardzweig erstellen möchten. 1. Wählen Sie „**Datei erstellen**“. 1. Geben Sie im Feld Dateiname den **Namen der Datei ein**. Fügen Sie den Inhalt der Datei im Editor hinzu. **Tipp** Wenn Sie die Datei in einem Unterordner oder Unterverzeichnis im Stammverzeichnis des Zweigs erstellen möchten, fügen Sie diese Struktur als Teil des Dateinamens hinzu. **Wenn Sie mit Ihren Änderungen zufrieden sind, wählen Sie Commit.** 1. Überprüfen Sie unter **Dateiname** den Namen der Datei und nehmen Sie die gewünschten Änderungen daran vor. Wählen Sie optional aus der Liste der verfügbaren Zweige in Branch den **Zweig** aus, in dem Sie die Datei erstellen möchten. Geben Sie im Feld **Commit-Nachricht** optional eine kurze, aber informative Beschreibung ein, warum Sie diese Änderung vorgenommen haben. Dies wird als grundlegende Commit-Information für den Commit angezeigt, der die Datei zum Quell-Repository hinzufügt. 1. Wählen Sie **Commit**, um die Datei zu übertragen und in das Quell-Repository zu übertragen. Du kannst auch Dateien zu einem Quell-Repository hinzufügen, indem du sie auf deinen lokalen Computer klonst und einen Git-Client oder eine verbundene integrierte Entwicklungsumgebung (IDE) verwendest, um deine Dateien und Änderungen zu übertragen. **Anmerkung** Wenn Sie ein Git-Submodul hinzufügen möchten, müssen Sie einen Git-Client oder eine Entwicklungsumgebung verwenden und den **git submodule add** Befehl ausführen. Sie können Git-Submodule nicht in der CodeCatalyst Konsole hinzufügen oder anzeigen oder die Unterschiede zwischen Git-Submodulen in Pull-Requests anzeigen. Weitere Informationen zu Git-Submodulen finden Sie in der [Git-Dokumentation](https://git-scm.com/book/en/v2/Git-Tools-Submodules). **Um eine Datei mit einem Git-Client oder einer verbundenen integrierten Entwicklungsumgebung (IDE) hinzuzufügen** 1. Klonen Sie Ihr Quell-Repository auf Ihren lokalen Computer. Weitere Informationen finden Sie unter [Klonen eines Quell-Repositorys](source-repositories-clone.md). 1. Erstellen Sie Dateien in Ihrem lokalen Repo oder kopieren Sie Dateien in Ihr lokales Repo. 1. Erstelle und pushe einen Commit, indem du einen der folgenden Schritte ausführst: + Wenn Sie einen Git-Client verwenden, führen Sie den Befehl im Terminal oder in der **git add** Befehlszeile aus und geben Sie die Namen der Dateien an, die Sie hinzufügen möchten. Um alle hinzugefügten oder geänderten Dateien hinzuzufügen, führen Sie alternativ den **git add** Befehl gefolgt von einem einzelnen oder einem doppelten Punkt aus, um anzugeben, ob Sie alle Änderungen auf der aktuellen Verzeichnisebene (einzelne Periode) oder alle Änderungen im aktuellen Verzeichnis und allen Unterverzeichnissen (doppelter Punkt) einbeziehen möchten. Um die Änderungen zu übernehmen, führen Sie den **git commit -m** Befehl aus und geben Sie eine Commit-Nachricht ein. Führen Sie den Befehl aus, um Ihre Änderungen in CodeCatalyst das Quell-Repository zu übertragen**git push**. Weitere Informationen zu Git-Befehlen finden Sie in Ihrer Git-Dokumentation und[Git-Befehle für Branches](source-branches-git.md). + Wenn Sie eine Entwicklungsumgebung oder eine IDE verwenden, erstellen Sie Dateien in der IDE und fügen Sie Dateien hinzu. Übergeben Sie dann Ihre Änderungen und übertragen Sie sie. Weitere Informationen finden Sie in [Schreiben und ändern Sie Code mit Dev Environments in CodeCatalystSchreiben und ändern Sie Code mit Dev Environments](devenvironment.md) oder in Ihrer IDE-Dokumentation. # Eine Datei ansehen Sie können die Dateien in Ihrem Quell-Repository in der CodeCatalyst Amazon-Konsole anzeigen. Sie können die Dateien im Standardzweig und in allen anderen Zweigen anzeigen. Der Dateiinhalt kann je nach Zweig, den Sie anzeigen möchten, variieren. **Um Dateien in der CodeCatalyst Konsole anzuzeigen** 1. Navigieren Sie zu dem Projekt, in dem Sie Dateien anzeigen möchten. Weitere Informationen finden Sie unter [Anzeigen eines Quell-Repositorys](source-repositories-view.md). 1. Wählen Sie den Namen des Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositorys** auswählen. Wählen Sie das Repository aus, in dem Sie Dateien anzeigen möchten. 1. Für den Standardzweig wird eine Liste von Dateien und Ordnern angezeigt. Dateien werden durch ein Papiersymbol gekennzeichnet, während Ordner durch ein Ordnersymbol gekennzeichnet sind. 1. Führen Sie eine der folgenden Aktionen aus: + Um Dateien und Ordner in einem anderen Zweig anzuzeigen, wählen Sie ihn aus der Liste der Zweige aus. + Um einen Ordner zu erweitern, wählen Sie ihn aus der Liste aus. 1. Um den Inhalt einer bestimmten Datei anzuzeigen, wählen Sie sie aus der Liste aus. Der Inhalt der Datei wird im Zweig angezeigt. Um den Inhalt der Datei in einem anderen Zweig anzuzeigen, wählen Sie den gewünschten Zweig aus der Verzweigungsauswahl aus. **Tipp** Wenn Sie sich den Inhalt einer Datei ansehen, können Sie unter Dateien anzeigen weitere **Dateien** auswählen. Um eine Datei zu bearbeiten, wählen Sie **Bearbeiten**. Sie können mehrere Dateien in der Konsole anzeigen. Sie können auch Dateien anzeigen, die Sie mit einem Git-Client oder einer integrierten Entwicklungsumgebung (IDE) auf Ihren lokalen Computer geklont haben. Weitere Informationen finden Sie in der Dokumentation für Ihren Git-Client oder Ihre Git-IDE. **Anmerkung** Sie können Git-Submodule nicht in der CodeCatalyst Konsole anzeigen. Weitere Informationen zu Git-Submodulen finden Sie in der [Git-Dokumentation](https://git-scm.com/book/en/v2/Git-Tools-Submodules). # Den Verlauf der Änderungen an einer Datei anzeigen Sie können den Verlauf der Änderungen an einer Datei in Ihrem Quell-Repository in der CodeCatalyst Amazon-Konsole einsehen. Auf diese Weise können Sie besser nachvollziehen, welche Änderungen an der Datei durch verschiedene Commits in dem Branch vorgenommen wurden, in dem Sie den Verlauf der Datei einsehen möchten. Wenn Sie sich beispielsweise den Verlauf der Änderungen an der **readme.md** Datei im **main** Zweig des Quell-Repositorys ansehen, wird Ihnen eine Liste von Commits angezeigt, die Änderungen an dieser Datei in diesem Zweig enthielten. **Anmerkung** Sie können den Verlauf einer Datei in einem verknüpften Repository nicht in der CodeCatalyst Konsole anzeigen. # Um den Verlauf einer Datei in der CodeCatalyst Konsole anzuzeigen 1. Navigieren Sie zu dem Projekt, in dem Sie den Verlauf einer Datei anzeigen möchten. Weitere Informationen finden Sie unter [Anzeigen eines Quell-Repositorys](source-repositories-view.md). 1. Wählen Sie den Namen des Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositories** auswählen. 1. Wählen Sie das Repository aus, in dem Sie den Verlauf einer Datei anzeigen möchten. Wählen Sie den Zweig aus, in dem Sie den Verlauf der Datei anzeigen möchten, und wählen Sie dann die Datei aus der Liste aus. Wählen Sie **View history (Verlauf anzeigen)**. 1. Überprüfe die Liste der Commits, die Änderungen an dieser Datei im angegebenen Branch enthielten. Um die Details der in einem bestimmten Commit enthaltenen Änderungen anzuzeigen, wählen Sie die Commit-Nachricht für diesen Commit in der Liste aus. Die Unterschiede zwischen diesem Commit und seinem übergeordneten Commit werden angezeigt. 1. Um den Verlauf der Änderungen an der Datei in einem anderen Zweig zu überprüfen, verwenden Sie die Verzweigungsauswahl, um die Ansicht dieses Zweigs zu ändern, wählen Sie die Datei aus der Dateiliste aus und klicken Sie dann **auf Verlauf anzeigen**. **Anmerkung** Sie können den Verlauf der Änderungen an Git-Submodulen nicht in der CodeCatalyst Konsole anzeigen. Weitere Informationen zu Git-Submodulen finden Sie in der [Git-Dokumentation](https://git-scm.com/book/en/v2/Git-Tools-Submodules). # Bearbeiten einer Datei Sie können einzelne Dateien in der CodeCatalyst Amazon-Konsole bearbeiten. Um mehrere Dateien gleichzeitig zu bearbeiten, erstellen Sie entweder eine Entwicklungsumgebung oder klonen Sie das Repository und nehmen Sie Ihre Änderungen mit einem Git-Client oder einer integrierten Entwicklungsumgebung (IDE) vor. Für weitere Informationen siehe [Schreiben und ändern Sie Code mit Dev Environments in CodeCatalystSchreiben und ändern Sie Code mit Dev Environments](devenvironment.md) oder [Klonen eines Quell-Repositorys](source-repositories-clone.md). **Um eine Datei in der CodeCatalyst Konsole zu bearbeiten** 1. Navigieren Sie zu dem Projekt, in dem Sie eine Datei bearbeiten möchten. Weitere Informationen zum Navigieren zu einem Repository finden Sie unter[Anzeigen eines Quell-Repositorys](source-repositories-view.md). 1. Wählen Sie das Repository aus, in dem Sie die Datei bearbeiten möchten. Wählen Sie **Zweige anzeigen** und wählen Sie dann den Zweig aus, in dem Sie arbeiten möchten. Wählen Sie die Datei aus der Liste der Dateien und Ordner in diesem Zweig aus. Der Inhalt der Datei wird angezeigt. 1. Wählen Sie **Bearbeiten** aus. 1. Bearbeiten Sie im Editor den Inhalt der Datei und wählen Sie dann **Commit**. Fügen Sie optional **unter Änderungen übernehmen** weitere Informationen zur Änderung in der **Nachricht bestätigen** hinzu. Wenn Sie mit Ihren Änderungen zufrieden sind, wählen Sie **Commit** aus. # Eine Datei umbenennen oder löschen Sie können Dateien in einer Entwicklungsumgebung, lokal auf Ihrem Computer oder in einer integrierten Entwicklungsumgebung (IDE) umbenennen oder löschen. Sobald Sie die Dateien umbenannt oder gelöscht haben, übertragen Sie diese Änderungen und übertragen Sie sie in das Quell-Repository. Sie können Dateien in der CodeCatalyst Amazon-Konsole nicht umbenennen oder löschen. # Code mit Pull-Requests in Amazon überprüfen CodeCatalyst Ein Pull Request ist die wichtigste Methode, mit der du und andere Projektmitglieder Codeänderungen von einem Branch zum anderen überprüfen, kommentieren und zusammenführen können. Sie können Pull Requests verwenden, um Codeänderungen gemeinsam auf kleinere Änderungen oder Korrekturen, wichtige Funktionserweiterungen oder neue Versionen Ihrer veröffentlichten Software zu überprüfen. Wenn du Issues verwendest, um die Arbeit an deinem Projekt nachzuverfolgen, kannst du bestimmte Issues mit Pull Requests verknüpfen, um nachzuverfolgen, welche Probleme durch die Codeänderungen im Pull Request behoben werden. Wenn du einen Pull Request erstellst, aktualisierst, kommentierst, zusammenführst oder schließt, wird automatisch eine E-Mail an den Autor des Pull Requests sowie an alle erforderlichen oder optionalen Überprüfer für den Pull Request gesendet. **Tipp** Du kannst in deinem Profil konfigurieren, über welche Pull-Request-Ereignisse du E-Mails erhältst. Weitere Informationen finden Sie unter [Senden von Slack- und E-Mail-Benachrichtigungen von CodeCatalyst](notifications-manage.md). Für Pull-Requests sind zwei Branches in einem Quell-Repository erforderlich: ein Quell-Branch, der den Code enthält, den Sie überprüfen möchten, und ein Ziel-Branch, in dem Sie den überprüften Code zusammenführen möchten. 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. **Anmerkung** Während Sie einen Pull-Request erstellen, ist der angezeigte Unterschied der Unterschied zwischen der Spitze des Quell-Branches und der Spitze des Ziel-Branches. Sobald du den Pull Request erstellt hast, 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-base](https://git-scm.com/docs/git-merge-base)in der Git-Dokumentation. Ein Pull-Request wird zwar für ein bestimmtes Quell-Repository und Branches erstellt, aber du kannst sie im Rahmen der Arbeit mit deinem Projekt erstellen, ansehen, überprüfen und schließen. Sie müssen das Quell-Repository nicht aufrufen, um Pull-Requests anzeigen und damit arbeiten zu können. Ein Pull-Request-Status wird auf **Offen** gesetzt, wenn du ihn erstellst. Der Pull-Request bleibt geöffnet, bis Sie ihn entweder in der CodeCatalyst Konsole zusammenführen, wodurch der Status in **Zusammengeführt** geändert wird, oder bis Sie ihn schließen, wodurch der Status in **Geschlossen geändert wird**. Wenn dein Code überprüft wurde, kannst du den Status der Pull-Anfrage auf eine von mehreren Arten ändern: + Führen Sie den Pull-Request in der CodeCatalyst Konsole zusammen. Der Code im Quellzweig des Pull-Requests wird mit dem Ziel-Branch zusammengeführt. Der Status der Pull-Anfrage wird auf **Zusammengeführt** geändert. Er kann nicht wieder auf „**Offen“ zurückgesetzt** werden. + Führen Sie die Branches lokal zusammen, übertragen Sie Ihre Änderungen und schließen Sie dann den Pull-Request in der CodeCatalyst Konsole. + Verwenden Sie die CodeCatalyst Konsole, um den Pull-Request ohne Zusammenführung zu schließen. Dadurch wird der Status auf **Geschlossen** geändert, und der Code aus dem Quell-Branch wird nicht mit dem Ziel-Branch zusammengeführt. Bevor Sie eine Pull-Anforderung erstellen, müssen Sie folgende Schritte ausführen: + Übergeben Sie die Codeänderungen, die Sie überprüfen möchten, und übertragen Sie sie in einen Branch (den Quell-Branch). + Richten Sie Benachrichtigungen für Ihr Projekt ein, damit andere Benutzer über alle Workflows informiert werden können, die ausgeführt werden, wenn Sie eine Pull-Anfrage erstellen. (Dieser Schritt ist optional, wird aber empfohlen.) **Topics** + [Erstellen einer Pull-Anforderung](pull-requests-create.md) + [Pull-Requests anzeigen](pull-requests-view.md) + [Verwaltung der Anforderungen für das Zusammenführen einer Pull-Anfrage mit Genehmigungsregeln](source-pull-requests-approval-rules.md) + [Überprüfen einer Pull-Anforderung](pull-requests-review.md) + [Aktualisieren einer Pull-Anforderung](pull-requests-update.md) + [Zusammenführen einer Pull-Anforderung](pull-requests-merge.md) + [Einen Pull-Request schließen](pull-requests-close.md) # 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-base](https://git-scm.com/docs/git-merge-base)in 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](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html). 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. 1. 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. 1. 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. 1. Wählen Sie im **Ziel-Branch** den Branch aus, in den der Code nach der Überprüfung zusammengeführt werden soll. 1. Wählen Sie im **Quellzweig** den Zweig aus, der den festgeschriebenen Code enthält. 1. Geben **Sie im Feld Titel der Pull-Anfrage** einen Titel ein, der anderen Benutzern hilft zu verstehen, was überprüft werden muss und warum. 1. (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](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html). 1. (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“. 1. (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. 1. (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. 1. Ü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. 1. 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. 1. 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. 1. 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. 1. Wähle **Mehr** und dann **Pull-Request erstellen** aus. 1. 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. 1. Ü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. 1. (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“. 1. (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. 1. (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. 1. **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 von Triggern zu Workflows](workflows-add-trigger-add.md). # Pull-Requests anzeigen Sie können Pull-Requests für ein Projekt in der CodeCatalyst Amazon-Konsole anzeigen. Auf der Seite mit der Projektzusammenfassung werden alle offenen Pull Requests für ein Projekt angezeigt. Um alle Pull Requests unabhängig von ihrem Status anzuzeigen, navigieren Sie zur Seite mit den Pull Requests für Ihr Projekt. Wenn du dir einen Pull Request ansiehst, kannst du wählen, ob du eine Zusammenfassung aller Kommentare zu den für dich erstellten Änderungen an dem Pull Request erhalten möchtest. **Anmerkung** **Bereitgestellt von Amazon Bedrock**: AWS implementiert [automatisierte Missbrauchserkennung](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html). 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. **Um offene Pull-Requests anzusehen** 1. Navigiere zu dem Projekt, in dem du Pull Requests ansehen möchtest. 1. Auf der Projektseite werden offene Pull Requests angezeigt, einschließlich Informationen darüber, wer den Pull Request erstellt hat, welches Repository die Branches für den Pull Request enthält und an welchem Datum der Pull Request erstellt wurde. Sie können die Ansicht der geöffneten Pull-Requests nach dem Quell-Repository filtern. 1. Um alle Pull-Requests **anzuzeigen, wähle Alle anzeigen**. Du kannst die Selektoren verwenden, um zwischen den Optionen zu wählen. Um beispielsweise alle Pull-Requests anzuzeigen, wähle **Beliebiger Status und Beliebiger** **Autor** aus. Sie können auch im Navigationsbereich **Code** und dann **Pull Requests** auswählen und dann mithilfe der Selektoren Ihre Ansicht verfeinern. 1. Auf der Seite **Pull Requests** kannst du Pull Requests nach ID, Titel, Status und mehr sortieren. Um anzupassen, welche Informationen und wie viele Informationen auf der Pull-Requests-Seite angezeigt werden, wähle das Zahnradsymbol. 1. Um einen bestimmten Pull Request anzuzeigen, wähle ihn aus der Liste aus. 1. Um den Status der mit diesem Pull Request verknüpften Workflow-Ausführungen, falls vorhanden, anzuzeigen, wähle **Übersicht** und überprüfe die Informationen im Bereich **Pull-Request-Details** des Pull Requests unter **Workflow-Ausführungen**. Ein Workflow-Lauf findet statt, wenn der Workflow mit Ereignissen zum Erstellen oder Überarbeiten von Pull-Requests konfiguriert ist und wenn die Anforderungen für den Ziel-Branch im Workflow mit dem im Pull Request angegebenen Ziel-Branch übereinstimmen. Weitere Informationen finden Sie unter [Hinzufügen von Triggern zu Workflows](workflows-add-trigger-add.md). 1. Um gegebenenfalls verknüpfte Probleme anzuzeigen, wählen Sie **Übersicht** und überprüfen Sie die Informationen in den **Pull-Request-Details** unter **Probleme**. Wenn du ein verknüpftes Problem anzeigen möchtest, wähle dessen ID aus der Liste aus. 1. (Optional) Um eine Zusammenfassung der Kommentare zu erstellen, die zu den Codeänderungen in Überarbeitungen des Pull-Requests hinterlassen wurden, wähle **Inhaltszusammenfassung erstellen** aus. Die Zusammenfassung wird keine Kommentare enthalten, die zum gesamten Pull-Request hinterlassen wurden. **Anmerkung** Diese Funktion setzt voraus, dass generative KI-Funktionen für den Space aktiviert sind. Sie ist für verknüpfte Repositorys nicht verfügbar und ist nur in der Region USA West (Oregon) verfügbar. Weitere Informationen finden Sie unter [Generative KI-Funktionen verwalten](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html). 1. Um die Codeänderungen im Pull Request anzuzeigen, wähle **Changes** aus. Unter **Geänderte Dateien kannst du schnell einsehen, wie viele Dateien Änderungen im Pull Request enthalten haben und zu welchen Dateien im Pull Request Kommentare hinzugefügt wurden**. Die Anzahl der Kommentare, die neben einem Ordner angezeigt werden, gibt die Anzahl der Kommentare zu Dateien in diesem Ordner an. Erweitern Sie den Ordner, um die Anzahl der Kommentare für jede Datei im Ordner anzuzeigen. Sie können sich auch alle Kommentare ansehen, die zu bestimmten Codezeilen hinterlassen wurden. **Anmerkung** Nicht alle Änderungen in einer Pull-Anfrage können in der Konsole angezeigt werden. Sie können beispielsweise keine Git-Submodule in der Konsole anzeigen, sodass Sie auch keine Unterschiede in einem Submodul in einer Pull-Anfrage anzeigen können. Einige Unterschiede sind möglicherweise zu groß, um angezeigt zu werden. Weitere Informationen erhalten Sie unter [Kontingente für Quell-Repositorys in CodeCatalyst](source-quotas.md) und [Eine Datei ansehenDen Verlauf der Änderungen an einer Datei anzeigen](source-files-view.md). 1. Um Qualitätsberichte für diesen Pull Request anzuzeigen, wähle **Berichte** aus. **Anmerkung** Ein Workflow muss so konfiguriert sein, dass er Berichte generiert, damit sie in Ihren Pull Requests angezeigt werden. Weitere Informationen finden Sie unter [Testen mit WorkflowsTesten mit Workflows](test-workflow-actions.md). # Verwaltung der Anforderungen für das Zusammenführen einer Pull-Anfrage mit Genehmigungsregeln Wenn du einen Pull Request erstellst, kannst du wählen, ob du diesem einzelnen Pull Request erforderliche oder optionale Reviewer hinzufügen möchtest. Du kannst jedoch auch Anforderungen erstellen, die alle Pull Requests erfüllen müssen, wenn sie mit einem bestimmten Ziel-Branch zusammengeführt werden. Diese Anforderungen werden als Genehmigungsregeln bezeichnet. Genehmigungsregeln werden für Branches in einem Repository konfiguriert. Wenn Sie einen Pull Request erstellen, für dessen Ziel-Branch eine Genehmigungsregel konfiguriert ist, müssen die Anforderungen für diese Regel zusätzlich zu den Genehmigungen aller erforderlichen Prüfer erfüllt sein, bevor Sie den Pull Request mit diesem Branch zusammenführen können. Durch das Erstellen von Genehmigungsregeln können Sie die Qualitätsstandards für Zusammenführungen mit Branches wie Ihrem Standard-Branch aufrechterhalten. Genehmigungsregeln, die auf den Standard-Branch Ihres Quell-Repositorys angewendet werden, verhalten sich etwas anders als Genehmigungsregeln, die auf andere Branches angewendet werden. Jede Regel, die auf den Standard-Branch angewendet wird, wird automatisch auf jeden Branch angewendet, den Sie als Standard-Branch angeben. Der Zweig, der zuvor als Standardzweig festgelegt wurde, behält weiterhin die Regeln bei, die auf ihn angewendet wurden. Wenn Sie Genehmigungsregeln erstellen, sollten Sie berücksichtigen, wie diese Regel von Ihren Projektbenutzern sowohl in der Gegenwart als auch in future eingehalten wird. Wenn Sie beispielsweise sechs Benutzer in Ihrem Projekt haben und Sie eine Genehmigungsregel erstellen, die fünf Genehmigungen erfordert, bevor sie mit dem Ziel-Branch zusammengeführt werden kann, haben Sie effektiv eine Regel erstellt, nach der alle außer der Person, die die Pull Requests erstellt hat, diese Pull Request genehmigen müssen, bevor sie zusammengeführt werden kann. **Anmerkung** Sie benötigen die Rolle des Projektadministrators, um Genehmigungsregeln in CodeCatalyst Projekten erstellen und verwalten zu können. Sie können keine Genehmigungsregeln für verknüpfte Repositorys erstellen. Sie können Genehmigungsregeln nicht löschen, aber Sie können sie so aktualisieren, dass keine Genehmigungen mehr erforderlich sind, wodurch die Regel effektiv entfernt wird. **Um Genehmigungsregeln für Ziel-Branches für Pull Requests anzuzeigen und zu bearbeiten** 1. Navigieren Sie zu dem Projekt, in dem sich Ihr Repository befindet. 1. Wählen Sie den Namen des Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositorys** auswählen. Wählen Sie das Repository aus, in dem Sie die Genehmigungsregeln anzeigen möchten. 1. Wählen Sie auf der Übersichtsseite des Repositorys die Option **Branches** aus. 1. Wählen Sie in der Spalte **Genehmigungsregeln** die Option **Anzeigen** aus, um den Status aller Regeln für jeden Zweig des Repositorys anzuzeigen. Im **Feld Mindestanzahl von Genehmigungen entspricht die Anzahl der Genehmigungen**, die erforderlich sind, bevor ein Pull Request mit diesem Branch zusammengeführt werden kann. 1. Um eine Genehmigungsregel zu erstellen oder zu ändern, wählen Sie Einstellungen **verwalten** aus. Wählen Sie auf der Einstellungsseite für das Quell-Repository unter **Genehmigungsregeln die** Option **Bearbeiten** aus. **Anmerkung** Sie benötigen die Rolle **eines Projektadministrators**, um Genehmigungsregeln bearbeiten zu können. 1. Wählen Sie unter **Branch** aus der Dropdownliste den Namen der Filiale aus, für die Sie eine Genehmigungsregel konfigurieren möchten. Geben Sie im Feld **Mindestanzahl von Genehmigungen** eine Zahl ein, und wählen Sie dann **Speichern** aus. # Überprüfen einer Pull-Anforderung Sie können die CodeCatalyst Amazon-Konsole verwenden, um die in einer Pull-Anfrage enthaltenen Änderungen gemeinsam zu überprüfen und zu kommentieren. Sie können Kommentare zu einzelnen Codezeilen hinzufügen, die den Unterschied zwischen den Quell- und Zielbranches oder den Unterschied zwischen den Versionen des Pull-Requests betreffen. Sie können sich dafür entscheiden, eine Zusammenfassung der Kommentare zu den Codeänderungen im Pull Request zu erstellen, um das Feedback anderer Benutzer schnell zu verstehen. Du kannst dich auch dafür entscheiden, eine Entwicklungsumgebung zu erstellen, um an Code zu arbeiten. **Anmerkung** **Bereitgestellt von Amazon Bedrock**: AWS implementiert [automatisierte Missbrauchserkennung](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html). 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. **Tipp** Sie können in Ihrem Profil konfigurieren, über welche Pull-Request-Ereignisse Sie E-Mails erhalten. Weitere Informationen finden Sie unter [Senden von Slack- und E-Mail-Benachrichtigungen von CodeCatalyst](notifications-manage.md). Pull-Requests zeigen, was der Unterschied zwischen der Revision des Pull-Requests und dem Commit sein wird, das bei der Erstellung des Pull-Requests der Tipp des Ziel-Branches war. Dies wird als Merge-Base bezeichnet. Weitere Informationen zu Unterschieden und Merge-Bases in Git finden Sie [git-merge-base](https://git-scm.com/docs/git-merge-base)in der Git-Dokumentation. **Tipp** Wenn du in der Konsole arbeitest, insbesondere wenn du eine Zeit lang eine Pull-Anfrage geöffnet hast, solltest du erwägen, deinen Browser zu aktualisieren, um sicherzustellen, dass du die neueste Version für eine Pull-Anfrage zur Verfügung hast, bevor du mit der Überprüfung beginnst. **Um einen Pull-Request in der CodeCatalyst Konsole zu überprüfen** 1. Navigiere zu deinem Projekt. 1. Navigiere zu den Pull Requests, indem du einen der folgenden Schritte ausführst: + Wenn der Pull Request auf der Projektseite aufgeführt ist, wählen Sie ihn aus der Liste aus. + Wenn der Pull Request nicht auf der Projektseite aufgeführt ist, wähle **Alle anzeigen** aus. Verwende die Filter und die Sortierung, um den Pull Request zu finden, und wähle ihn dann aus der Liste aus. + Wählen Sie im Navigationsbereich **Code** und dann **Pull Requests** aus. 1. Wählen Sie die Pull-Anfrage, die Sie überprüfen möchten, aus der Liste aus. Du kannst die Liste der Pull-Requests filtern, indem du einen Teil des Namens in die Filterleiste eingibst. 1. In der **Übersicht** kannst du den Namen und den Titel des Pull Requests überprüfen. Du kannst Kommentare, die zum Pull Request selbst hinterlassen wurden, erstellen und ansehen. Du kannst dir auch die Details des Pull-Requests ansehen, einschließlich Informationen über Workflow-Ausführungen, verknüpfte Probleme, Prüfer, den Autor des Pull-Requests und mögliche Merge-Strategien. **Anmerkung** Kommentare, die zu bestimmten Codezeilen hinterlassen wurden, werden unter **Änderungen** angezeigt. 1. (Optional) Um einen Kommentar hinzuzufügen, der für die gesamte Pull-Anfrage gilt, erweitern Sie **Kommentare zur Pull-Anfrage** und wählen Sie dann **Kommentar erstellen** aus. 1. (Optional) Um eine Zusammenfassung aller Kommentare zu Änderungen in Revisionen dieses Pull-Requests anzuzeigen, wähle **Kommentarzusammenfassung erstellen** aus. **Anmerkung** Diese Funktion setzt voraus, dass generative KI-Funktionen für den Space aktiviert sind und ist nur in der Region USA West (Oregon) verfügbar. Weitere Informationen finden Sie unter [Generative KI-Funktionen verwalten](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html). 1. Unter **Änderungen** kannst du die Unterschiede zwischen dem Ziel-Branch und der neuesten Version des Pull-Requests sehen. Wenn es mehr als eine Revision gibt, kannst du ändern, welche Revisionen im Unterschied zwischen ihnen verglichen werden. Weitere Informationen zu Revisionen finden Sie unter [Überarbeitungen](source-concepts.md#revision-concept). **Tipp** Unter **Geänderte** Dateien kannst du schnell einsehen, wie viele Dateien Änderungen im Pull Request enthalten haben und zu welchen Dateien im Pull Request Kommentare hinzugefügt wurden. Die Anzahl der Kommentare, die neben einem Ordner angezeigt werden, gibt die Anzahl der Kommentare zu Dateien in diesem Ordner an. Erweitern Sie den Ordner, um die Anzahl der Kommentare für jede Datei im Ordner anzuzeigen. 1. Um zu ändern, wie Unterschiede angezeigt werden, wählen Sie zwischen **Vereinheitlicht** und **Geteilt**. 1. Um einer Zeile im Pull Request einen Kommentar hinzuzufügen, gehe zu der Zeile, die du kommentieren möchtest. Wähle das Kommentarsymbol, das für diese Zeile angezeigt wird, gib einen Kommentar ein und wähle dann **Speichern**. 1. Um Änderungen zwischen den Versionen eines Pull-Requests oder zwischen dessen Quell- und Ziel-Branches anzuzeigen, wähle eine der verfügbaren Optionen unter **Vergleichen** aus. Kommentare zu Zeilen in Revisionen bleiben in diesen Revisionen erhalten. 1. Wenn Sie Ihren Workflow so konfiguriert haben, dass ein Bericht zur Codeabdeckung über Pull-Request-Trigger generiert wird, können Sie die Ergebnisse der Leitungs- und Zweigabdeckung im entsprechenden Pull Request einsehen. Um die Ergebnisse der Codeabdeckung auszublenden, wähle „**Codeabdeckung ausblenden**“. Weitere Informationen finden Sie unter [Code-Abdeckungsberichte](test-workflow-actions.md#test-code-coverage-reports). 1. Wenn du Codeänderungen an der Pull-Anfrage vornehmen möchtest, kannst du aus der Pull-Anfrage eine Entwicklungsumgebung erstellen. Wähle **Entwicklungsumgebung erstellen**. Fügen Sie optional einen Namen für die Entwicklungsumgebung hinzu oder bearbeiten Sie deren Konfiguration und wählen Sie dann **Create**. 1. Unter **Berichte** kannst du die Qualitätsberichte in dieser Pull-Anfrage einsehen. Wenn es mehr als eine Revision gibt, kannst du ändern, welche Revisionen verglichen werden, was den Unterschied zwischen ihnen angeht. Sie können die Berichte nach Name, Status, Arbeitsablauf, Aktion und Typ filtern. **Anmerkung** Ein Workflow muss so konfiguriert sein, dass er Berichte generiert, damit sie in Ihren Pull-Requests angezeigt werden. Weitere Informationen finden Sie unter [Qualitätsberichte in einer Aktion konfigurieren](test-config-action.md). 1. Um einen bestimmten Bericht anzuzeigen, wählen Sie ihn aus der Liste aus. Weitere Informationen finden Sie unter [Testen mit WorkflowsTesten mit Workflows](test-workflow-actions.md). 1. Wenn Sie als Prüfer für diesen Pull Request aufgeführt sind und die Änderungen genehmigen möchten, stellen Sie sicher, dass Sie sich die neueste Version ansehen, und wählen Sie dann **Genehmigen** aus. **Anmerkung** Alle erforderlichen Reviewer müssen einen Pull Request genehmigen, bevor er zusammengeführt werden kann. # Aktualisieren einer Pull-Anforderung Du kannst es anderen Projektmitgliedern erleichtern, Code zu überprüfen, indem du den Pull Request aktualisierst. Du kannst einen Pull Request aktualisieren, um seine Reviewer, seine Links zu Issues, den Titel des Pull Requests oder seine Beschreibung zu ändern. Beispielsweise möchtest du vielleicht die erforderlichen Reviewer für einen Pull Request ändern, um jemanden zu entfernen, der im Urlaub ist, und eine weitere Person hinzuzufügen. Du kannst einen Pull Request auch mit weiteren Codeänderungen aktualisieren, indem du Commits in den Quell-Branch eines geöffneten Pull Requests überträgst. Jeder Push an den Quell-Branch einer Pull-Anfrage im CodeCatalyst Quell-Repository erzeugt eine Revision. Projektmitglieder können die Unterschiede zwischen den Revisionen in einem Pull Request einsehen. **Um die Reviewer für einen Pull Request zu aktualisieren** 1. Navigiere zu dem Projekt, in dem du die Reviewer eines Pull Requests aktualisieren möchtest. 1. Wählen Sie auf der Projektseite unter **Pull Requests öffnen** den Pull Request aus, für den Sie die Reviewer aktualisieren möchten. Sie können auch im Navigationsbereich **Code**, dann **Pull Requests** und dann den Pull Request auswählen, den Sie aktualisieren möchten. 1. (Optional) Wählen Sie **unter Übersicht** im Bereich **Pull-Request-Details** das Pluszeichen aus, um erforderliche oder optionale Reviewer hinzuzufügen. Wählen Sie das **X** neben einem Prüfer aus, um ihn als optionalen oder erforderlichen Prüfer zu entfernen. 1. (Optional) Wählen Sie **unter Übersicht** im Bereich **Details zur Pull-Anfrage** die Option **Probleme verknüpfen** aus, um ein Problem mit der Pull-Anfrage zu verknüpfen, und wählen Sie dann entweder ein Problem aus der Liste aus oder geben Sie dessen ID ein. Um die Verknüpfung eines Issues aufzuheben, wähle das Symbol „Verknüpfung aufheben“ neben dem Issue, dessen Verknüpfung du aufheben möchtest. **Um Dateien und Code im Quell-Branch einer Pull-Anfrage zu aktualisieren** 1. Um mehrere Dateien zu aktualisieren, [erstellen Sie entweder eine Entwicklungsumgebung](devenvironment-create.md) oder klonen Sie das Repository und seinen Quellzweig und verwenden Sie einen Git-Client oder eine integrierte Entwicklungsumgebung (IDE), um Änderungen an den Dateien im Quellzweig vorzunehmen. Übernehmen Sie die Änderungen und übertragen Sie sie in den Quell-Branch im CodeCatalyst Quell-Repository, um die Pull-Anfrage automatisch mit den Änderungen zu aktualisieren. Weitere Informationen erhalten Sie unter [Klonen eines Quell-Repositorys](source-repositories-clone.md) und [Änderungen im Quellcode mit Commits in Amazon verstehen CodeCatalyst](source-commits.md). 1. Um eine einzelne Datei in einem Quellzweig zu aktualisieren, können Sie einen Git-Client oder eine Git-IDE verwenden, wie Sie es für mehrere Dateien tun würden. Sie können es auch direkt in der CodeCatalyst Konsole bearbeiten. Weitere Informationen finden Sie unter [Bearbeiten einer Datei](source-files-edit.md). **Um den Titel und die Beschreibung einer Pull-Anfrage zu aktualisieren** 1. Navigiere zu dem Projekt, in dem du den Titel oder die Beschreibung eines Pull Requests aktualisieren möchtest. 1. Auf der Projektseite werden offene Pull Requests angezeigt, einschließlich Informationen darüber, wer den Pull Request erstellt hat, welches Repository die Branches für den Pull Request enthält und wann der Pull Request erstellt wurde. Sie können die Ansicht der geöffneten Pull-Requests nach dem Quell-Repository filtern. Wählen Sie den Pull-Request, den Sie ändern möchten, aus der Liste aus. 1. Um alle Pull Requests **anzuzeigen, wähle Alle anzeigen**. Wählen Sie alternativ im Navigationsbereich **Code** und dann **Pull Requests** aus. Verwenden Sie das Filterfeld oder die Sortierfunktionen, um den Pull Request zu finden, den Sie ändern möchten, und wählen Sie ihn dann aus. 1. Wähle in der **Übersicht** die Option **Bearbeiten** aus. 1. Ändern Sie den Titel oder die Beschreibung und wählen Sie dann **Speichern**. # Zusammenführen einer Pull-Anforderung Nachdem Ihr Code überprüft und von allen erforderlichen Reviewern genehmigt wurde, können Sie einen Pull-Request in der CodeCatalyst Konsole zusammenführen, indem Sie eine unterstützte Merge-Strategie verwenden, z. B. Fast-Forward. Nicht alle in der CodeCatalyst Konsole unterstützten Merge-Strategien stehen als Auswahlmöglichkeiten für alle Pull-Requests zur Verfügung. CodeCatalyst wertet die Zusammenführung aus und ermöglicht es Ihnen nur, zwischen Merge-Strategien zu wählen, die in der Konsole verfügbar sind und den Quell-Branch mit dem Ziel-Branch zusammenführen können. Du kannst auch eine Pull-Anfrage mit einer Git-Merge-Strategie deiner Wahl zusammenführen, indem du den **git merge** Befehl auf deinem lokalen Computer oder in einer Entwicklungsumgebung ausführst, um den Quell-Branch mit dem Ziel-Branch zusammenzuführen. Sie können diese Änderungen dann im Ziel-Branch in das Quell-Repository in übertragen CodeCatalyst. **Anmerkung** Durch das Zusammenführen des Branches und das Pushen der Änderungen in Git wird der Pull-Request nicht automatisch geschlossen. Wenn du die Rolle eines Projektadministrators hast, kannst du dich auch dafür entscheiden, einen Pull-Request zusammenzuführen, der noch nicht alle Anforderungen für Genehmigungen und Genehmigungsregeln erfüllt hat. ## Einen Pull-Request zusammenführen (Konsole) Du kannst einen Pull Request in der CodeCatalyst Konsole zusammenführen, wenn es keine Merge-Konflikte zwischen Quell- und Ziel-Branches gibt und wenn alle erforderlichen Reviewer den Pull Request genehmigt haben. Wenn es Konflikte gibt oder wenn die Zusammenführung nicht abgeschlossen werden kann, ist die Schaltfläche zum Zusammenführen inaktiv und die Bezeichnung **Nicht zusammenführbar wird** angezeigt. In diesem Fall müssen Sie die Genehmigung aller erforderlichen Genehmiger einholen, Konflikte gegebenenfalls lokal lösen und diese Änderungen übertragen, bevor Sie die Zusammenführung durchführen können. Durch das Zusammenführen eines Pull-Requests wird automatisch eine E-Mail an den Ersteller des Pull-Requests sowie an alle erforderlichen oder optionalen Prüfer gesendet. Probleme im Zusammenhang mit dem Pull-Request werden dadurch nicht automatisch geschlossen oder ihr Status geändert. **Tipp** Du kannst im Rahmen deines Profils konfigurieren, über welche Pull-Request-Ereignisse du E-Mails erhältst. Weitere Informationen finden Sie unter [Senden von Slack- und E-Mail-Benachrichtigungen von CodeCatalyst](notifications-manage.md). **Um einen Pull-Request zusammenzuführen** 1. Navigiere zu dem Projekt, in dem du einen Pull Request zusammenführen möchtest. 1. Wähle auf der Projektseite unter **Pull Requests öffnen** den Pull Request aus, den du zusammenführen möchtest. Wenn du den Pull Request nicht siehst, wähle **Alle Pull Requests anzeigen** und wähle ihn dann aus der Liste aus. Sie können auch im Navigationsbereich **Code**, dann **Pull Requests** und dann den Pull Request auswählen, den Sie zusammenführen möchten. Wählen Sie **Merge (Zusammenführen)**. 1. Wählen Sie aus den verfügbaren Merge-Strategien für den Pull Request aus. **Aktivieren oder deaktivieren Sie optional die Option, den Quell-Branch nach dem Zusammenführen des Pull-Requests zu löschen, und wählen Sie dann Merge aus.** **Anmerkung** Wenn die Schaltfläche **Zusammenführen** inaktiv ist oder dir die Bezeichnung **Nicht zusammenführbar** angezeigt wird, haben entweder die erforderlichen Prüfer den Pull Request noch nicht genehmigt, oder der Pull Request kann nicht in der Konsole zusammengeführt werden. CodeCatalyst **Ein Prüfer, der eine Pull-Anfrage nicht genehmigt hat, wird im Bereich mit den **Pull-Request-Details** in der Übersicht durch ein Uhrsymbol gekennzeichnet.** Wenn alle erforderlichen Reviewer den Pull Request genehmigt haben, die Schaltfläche **Zusammenführen** aber immer noch inaktiv ist, liegt möglicherweise ein Merge-Konflikt vor. Wähle das unterstrichene Label **Nicht zusammenführbar aus**, um weitere Informationen darüber zu erhalten, warum der Pull Request nicht zusammengeführt werden kann. Sie können Merge-Konflikte für den Ziel-Branch in einer Entwicklungsumgebung oder in der CodeCatalyst Konsole lösen und dann den Pull-Request zusammenführen, oder Sie können Konflikte lösen und lokal zusammenführen und dann den Commit, der den Merge enthält, in den Quell-Branch in übertragen. CodeCatalyst Weitere Informationen finden Sie unter [Eine Pull-Anfrage zusammenführen (Git)](#pull-requests-merge-git) und in Ihrer Git-Dokumentation. ## Überschreibe die Anforderungen für Zusammenführungen Wenn Sie die Rolle eines **Projektadministrators** haben, können Sie einen Pull-Request zusammenführen, der noch nicht alle Anforderungen für die erforderlichen Genehmigungen und Genehmigungsregeln erfüllt hat. Dies wird als Außerkraftsetzen der Anforderungen für einen Pull-Request bezeichnet. Sie können sich dafür entscheiden, wenn ein erforderlicher Prüfer nicht verfügbar ist oder wenn es dringend erforderlich ist, einen bestimmten Pull-Request mit einem Branch zusammenzuführen, dessen Genehmigungsregeln nicht schnell erfüllt werden können. **Um einen Pull Request zusammenzuführen** 1. Wähle in der Pull-Anfrage, in der du Anforderungen überschreiben und zusammenführen möchtest, den Dropdown-Pfeil neben der Schaltfläche **Zusammenführen** aus. Wähle **Genehmigungsanforderungen außer Kraft setzen**. 1. Geben Sie **unter Grund außer Kraft setzen** Einzelheiten dazu an, warum Sie diesen Pull-Request zusammenführen, ohne dass er die Genehmigungsregeln und die erforderlichen Prüferanforderungen erfüllt. Dies ist zwar optional, wird aber dringend empfohlen. 1. Wählen Sie optional eine Merge-Strategie oder akzeptieren Sie die Standardeinstellung. Sie können sich auch dafür entscheiden, die automatisch generierte Commit-Nachricht mit weiteren Details zu aktualisieren. 1. Aktivieren oder deaktivieren Sie die Option, mit der der Quell-Branch beim Zusammenführen gelöscht werden soll. Wir empfehlen, den Quell-Branch beizubehalten, wenn Sie die Anforderungen für das Zusammenführen eines Pull-Requests außer Kraft setzen, bis Sie die Möglichkeit hatten, die Entscheidung mit anderen Teammitgliedern zu überprüfen. 1. Wählen Sie **Merge (Zusammenführen)**. ## Eine Pull-Anfrage zusammenführen (Git) Git unterstützt viele Optionen zum Zusammenführen und Verwalten von Branches. Die folgenden Befehle sind einige der Optionen, die du verwenden kannst. Weitere Informationen finden Sie in der verfügbaren Dokumentation auf der [Git-Website](https://git-scm.com/doc). Sobald du deine Änderungen zusammengeführt und übertragen hast, schließe den Pull-Request manuell. Weitere Informationen finden Sie unter [Einen Pull-Request schließen](pull-requests-close.md). **Allgemeine Git-Befehle zum Zusammenführen von Branches** | | | | --- |--- | | Führt Änderungen vom Quell-Branch im lokalen Repo mit dem Ziel-Branch im lokalen Repo zusammen. | `git checkout destination-branch-name` `git merge source-branch-name` | | Führt den Quellzweig mit dem Zielzweig zusammen und gibt dabei eine Schnellvorwärtszusammenführung an. Dadurch werden die Zweige zusammengeführt und der Zeiger des Zielzweigs an die Spitze des Quellzweigs bewegt. | `git checkout destination-branch-name` `git merge --ff-only source-branch-name` | | Führt den Quellzweig mit dem Zielzweig zusammen und gibt eine Squash-Merge an. Dadurch werden alle Commits aus dem Quell-Branch zu einem einzigen Merge-Commit im Ziel-Branch zusammengefasst. | `git checkout destination-branch-name` `git merge --squash source-branch-name` | | Führt den Quell-Branch mit dem Ziel-Branch zusammen und gibt dabei eine Drei-Wege-Merge an. Dadurch wird ein Merge-Commit erstellt und die einzelnen Commits aus dem Quell-Branch zum Ziel-Branch hinzugefügt. | `git checkout destination-branch-name` `git merge --no-ff source-branch-name` | | Löscht den Quellzweig im lokalen Repository. Dies ist nützlich, um Ihr lokales Repository zu bereinigen, nachdem Sie es mit dem Ziel-Branch zusammengeführt und die Änderungen in das Quell-Repository übertragen haben. | `git branch -d source-branch-name` | | Löscht den Quell-Branch im Remote-Repository (das Quell-Repository in CodeCatalyst) unter Verwendung des im lokalen Repo angegebenen Nicknamens für das Remote-Repository. (Beachten Sie die Verwendung des Doppelpunkts (`:`).) Sie können dies auch `--delete` als Teil des Befehls angeben. | `git push remote-name :source-branch-name` `git push remote-name --delete source-branch-name` | # Einen Pull-Request schließen Du kannst einen Pull Request als **Geschlossen** markieren. Dadurch wird der Pull-Request nicht zusammengeführt, aber es kann dir helfen festzustellen, welche Pull-Requests eine Aktion erfordern und welche Pull-Requests nicht mehr relevant sind. Wir empfehlen, einen Pull Request zu schließen, wenn du nicht mehr vorhast, diese Änderungen zusammenzuführen, oder wenn die Änderungen durch einen anderen Pull Request zusammengeführt wurden. Beim Schließen eines Pull-Requests wird automatisch eine E-Mail an den Ersteller des Pull-Requests sowie an alle erforderlichen oder optionalen Reviewer gesendet. Der Status von Problemen im Zusammenhang mit dem Pull-Request wird dadurch nicht automatisch geändert. **Anmerkung** Sie können einen Pull-Request nicht erneut öffnen, nachdem er geschlossen wurde. **Um einen Pull-Request zu schließen** 1. Navigiere zu dem Projekt, in dem du einen Pull Request schließen möchtest. 1. Auf der Projektseite werden offene Pull Requests angezeigt. Wählen Sie den Pull Request aus, den Sie schließen möchten. 1. Klicken Sie auf **Schließen**. 1. Überprüfe die Informationen und wähle dann **Pull-Request schließen** aus. # Änderungen im Quellcode mit Commits in Amazon verstehen CodeCatalyst Commits sind Snapshots der Inhalte und der Änderungen, die an den Inhalten des Repositorys vorgenommen wurden. Jedes Mal, wenn ein Benutzer eine Änderung festschreibt und an einen Branch weitergibt, werden diese Informationen gespeichert. Zu den Git-Commit-Informationen gehören der Commit-Autor, die Person, die die Änderung vorgenommen hat, Datum und Uhrzeit sowie die vorgenommenen Änderungen. Ähnliche Informationen sind automatisch enthalten, wenn Sie eine Datei in der CodeCatalyst Amazon-Konsole erstellen oder bearbeiten, aber der Autorenname ist Ihr CodeCatalyst Benutzername. Du kannst Commits auch Git-Tags hinzufügen, um dir zu helfen, bestimmte Commits zu identifizieren. Bei Amazon CodeCatalyst können Sie: + Eine Liste der Commits für einen Branch anzeigen. + Sehen Sie sich einzelne Commits an, einschließlich der Änderungen, die in einem Commit im Vergleich zu seinem übergeordneten Commit oder seinen übergeordneten Commits vorgenommen wurden. Sie können auch Dateien und Ordner anzeigen. Weitere Informationen finden Sie unter [Verwaltung von Quellcodedateien in Amazon CodeCatalyst](source-files.md). **Topics** + [Commits für einen Branch anzeigen](#source-commits-view) + [Ändern der Anzeige von Commits (CodeCatalyst Konsole)](#source-commits-settings) ## Commits für einen Branch anzeigen Sie können den Verlauf der an einem Branch vorgenommenen Änderungen einsehen, indem Sie die Commits des Branches in der CodeCatalyst Konsole überprüfen. Auf diese Weise können Sie besser nachvollziehen, wer wann Änderungen an dem Branch vorgenommen hat. Sie können auch die Änderungen überprüfen, die in einem bestimmten Commit vorgenommen wurden. **Tipp** Sie können auch den Verlauf der Commits einsehen, die Änderungen an einer bestimmten Datei vorgenommen haben. Weitere Informationen finden Sie unter [Eine Datei ansehenDen Verlauf der Änderungen an einer Datei anzeigen](source-files-view-history.md). Du kannst Commits auch mit deinem Git-Client anzeigen. Weitere Informationen findest du in deiner Git-Dokumentation. **Um Commits anzusehen (Konsole)** 1. Navigieren Sie zu dem Projekt, das das Quell-Repository enthält, in dem Sie Commits anzeigen möchten. 1. Wählen Sie den Namen des Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositorys** auswählen. Wählen Sie das Repository aus, in dem Sie Commits für einen Branch anzeigen möchten. 1. Der Standard-Branch des Repositorys wird angezeigt, einschließlich Informationen über den letzten Commit für den Branch. Wählen Sie **Commits** aus. Wählen Sie alternativ **Mehr** und dann **Commits anzeigen** aus. 1. Um Commits für einen anderen Branch anzuzeigen, wählen Sie den Branch-Selektor und dann den Namen des Branches aus. 1. Um Details zu einem bestimmten Commit anzuzeigen, wählen Sie seinen Titel aus dem Feld **Commit-Titel** aus. Es werden Details zum Commit angezeigt, einschließlich Informationen über den übergeordneten Commit und die Änderungen, die am Code vorgenommen wurden, indem der übergeordnete Commit mit dem angegebenen Commit verglichen wurde. **Tipp** Wenn ein Commit mehr als einen übergeordneten Commit hat, können Sie auswählen, für welchen übergeordneten Commit Sie Informationen und Änderungen anzeigen möchten, indem Sie das Dropdown-Symbol neben der übergeordneten Commit-ID auswählen. ## Ändern der Anzeige von Commits (CodeCatalyst Konsole) Sie können ändern, welche Informationen in der **Commits-Ansicht** angezeigt werden. Sie können wählen, ob Spalten wie Autor und Commit-ID ein- oder ausgeblendet werden sollen. **Um zu ändern, wie Commits angezeigt werden (Konsole)** 1. Navigieren Sie zu dem Projekt, das das Quell-Repository enthält, in dem Sie Commits anzeigen möchten. 1. Wählen Sie den Namen des Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. Sie können auch im Navigationsbereich **Code** und dann **Quell-Repositorys** auswählen. Wählen Sie das Repository aus, in dem Sie ändern möchten, wie Commits angezeigt werden. 1. Der Standard-Branch des Repositorys wird angezeigt, einschließlich Informationen über den letzten Commit für den Branch. Wählen Sie **Commits** aus. 1. Wählen Sie das Zahnradsymbol aus. 1. Wählen Sie in den **Einstellungen** die Anzahl der anzuzeigenden Commits aus und legen Sie fest, ob Informationen zum Commit-Autor, zum Commit-Datum und zur Commit-ID angezeigt werden sollen. **Anmerkung** Sie können den Commit-Titel nicht in der Informationsanzeige ausblenden. 1. Wenn Sie Ihre Änderungen vorgenommen haben, wählen Sie **Speichern**, um sie zu speichern, oder **Abbrechen**, um sie zu verwerfen. # Kontingente für Quell-Repositorys in CodeCatalyst In der folgenden Tabelle werden Kontingente und Beschränkungen für Quell-Repositorys in Amazon CodeCatalyst beschrieben. Weitere Informationen zu Kontingenten bei Amazon CodeCatalyst finden Sie unter[Kontingente für CodeCatalyst](quotas.md). | Ressource | Informationen | | --- | --- | | Branch-Namen | Jede Kombination von zulässigen Zeichen mit einer Länge zwischen 1 und 256 Zeichen, die innerhalb eines Repositorys eindeutig sein muss. Branch-Namen dürfen nicht: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/codecatalyst/latest/userguide/source-quotas.html) Branch-Namen sind Referenzen. Viele der Einschränkungen für Branch-Namen basieren auf dem Git-Referenzstandard. Weitere Informationen finden Sie unter [Git Internals](https://git-scm.com/book/en/v2/Git-Internals-Git-References) und [git-check-ref-format](https://git-scm.com/docs/git-check-ref-format). | | Kommentare zu einer Pull-Anfrage | Maximal 1.000 bei einer Pull-Anfrage. | | Nachricht übertragen | Maximal 1024 Zeichen. | | Dateipfade | Beliebige Kombination aus zulässigen Zeichen und mit einer Länge zwischen 1 und 4,096 Zeichen. Dateipfade müssen einen eindeutigen Namen haben, in dem die Datei und der genaue Speicherort der Datei angegeben sind. Dateipfade dürfen nicht mehr als 20 Verzeichnisse umfassen. Außerdem gelten für Dateipfade folgende Regeln:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/codecatalyst/latest/userguide/source-quotas.html) Dateinamen und -pfade müssen vollständig qualifiziert sein. Der Dateiname und der Pfad zu einer Datei auf Ihrem lokalen Computer müssen den Standards für das Betriebssystem entsprechen. Verwenden Sie bei der Angabe des Pfads zu einer Datei in einem Repository die Standards für Amazon Linux. | | Dateigröße | Maximal 6 MB für jede einzelne Datei bei Verwendung der CodeCatalyst Konsole. | | In der CodeCatalyst Konsole sichtbare Dateigröße | Maximal 6 MB für jede einzelne Datei bei Verwendung der CodeCatalyst Konsole. | | Größe des Git-Blobs | Maximal 2 GB Die Anzahl oder die Gesamtgröße aller Dateien in einem einzelnen Commit ist nicht begrenzt, sofern die Metadaten den Maximalwert von 6 MB nicht übersteigen und ein einzelner Blob nicht größer ist als 2 GB. Als bewährte Methode sollten Sie jedoch mehrere kleinere Commits anstelle eines großen Commits in Betracht ziehen. | | Metadaten für Commit | Maximal 6 MB für die kombinierten [Metadaten für einen Commit](https://git-scm.com/book/en/v2/Git-Internals-Git-Objects) (z. B. die Kombination aus Autoreninformationen, Datum, übergeordneter Commit-Liste und Commit-Nachrichten). Die Anzahl oder die Gesamtgröße aller Dateien in einem einzelnen Commit ist nicht begrenzt, sofern die Daten den Maximalwert von 20 MB nicht übersteigen und eine einzelne Datei nicht größer als 6 MB und ein einzelner Blob nicht größer als 2 GB ist. | | Anzahl der CodeCatalyst Probleme, die mit einer Pull-Anfrage verknüpft werden können | 50 | | Anzahl der Jira-Issues, die mit einer Pull-Anfrage verknüpft werden können | 50 | | Anzahl der offenen Pull-Requests in einem Space | Maximal 1.000 für einen CodeCatalyst Amazon-Bereich. | | Gesamtzahl der Pull-Anfragen in einem Space | Maximal 10.000 für einen CodeCatalyst Amazon-Bereich. | | Anzahl Referenzen für einzelnen Push | Maximal 4 000 (einschließlich Erstellen, Löschen und Aktualisieren). Für die Gesamtanzahl der Referenzen im Repository ist keine Einschränkung vorhanden. | | Anzahl der Repositorys in einem Space | Maximal 5.000 für einen CodeCatalyst Amazon-Bereich. | | Repository-Beschreibungen | Beliebige Zeichenkombination und mit einer Länge zwischen 0 und 1 000 Zeichen. Repository-Beschreibungen sind optional. | | Repository-Namen | Repository-Namen müssen innerhalb eines Projekts eindeutig sein. Sie können eine beliebige Kombination aus Buchstaben, Zahlen, Punkten, Unterstrichen und Bindestrichen mit einer Länge von 1 bis 100 Zeichen enthalten. Bei Namen wird nicht zwischen Groß- und Kleinschreibung unterschieden. Repository-Namen dürfen nicht auf .git enden, dürfen keine Leerzeichen enthalten und dürfen keines der folgenden Zeichen enthalten: `! ? @ # $ % ^ & * ( ) + = { } [ ] \| \ / > < ~ ` ' " ; : ` | | Größe des Repositoriums | Die Größe des Repositorys wird von den allgemeinen Speicherlimits für Ihren Speicherplatz beeinflusst. Weitere Informationen finden Sie unter [-Preise](https://codecatalyst.aws/explore/pricing) und [Behebung von Problemen mit Quell-Repositorys](troubleshooting-source.md). | | Prüfer für einen Pull-Request | Insgesamt maximal 100 Reviewer (optional oder erforderlich) für einen Pull-Request. | | Schriftliche Zusammenfassungen für Pull-Requests | Die maximale Anzahl schriftlicher Zusammenfassungen für Pull Requests hängt von der Abrechnungsstufe für deinen Bereich ab. Weitere Informationen finden Sie unter [- Preise](https://codecatalyst.aws/explore/pricing). |