View a markdown version of this page

Konzepte des Quellrepositorys - Amazon CodeCatalyst

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

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

Konzepte des Quellrepositorys

Im Folgenden finden Sie einige Konzepte, die Sie bei der Arbeit mit CodeCatalyst Quell-Repositorys kennen sollten.

Projekte

Ein Projekt ist ein Gemeinschaftsprojekt CodeCatalyst , das Entwicklungsteams und Aufgaben unterstützt. Nachdem Sie ein Projekt abgeschlossen 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. Du kannst ein Repository nicht mit mehreren Projekten teilen, und du kannst 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 mit diesem Projekt verknüpft sind, entsprechend den für diese Rollen erteilten Berechtigungen. Weitere Informationen finden Sie unter Zugriff mit Benutzerrollen gewähren.

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. Beispielsweise können Sie 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 und Schnellstart: Erweiterungen installieren, Anbieter verbinden und Ressourcen verknüpfen in CodeCatalyst.

Entwickler-Umgebungen

Eine Entwicklungsumgebung ist eine Cloud-basierte Entwicklungsumgebung, in 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 Entwicklungsdatei im Quell-Repository Ihres Projekts definiert. Wenn Sie keine Dev-Datei in Ihrem Quell-Repository haben, wird automatisch eine Standard-Devfile angewendet. Die Standard-Devfile 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 sich dafür entscheiden, im Rahmen der Erstellung der Entwicklungsumgebung einen neuen Zweig zu erstellen.

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 verwendet CodeCatalyst werden. Sie verwenden PATs, um auf CodeCatalyst Ressourcen zuzugreifen, zu denen integrierte Entwicklungsumgebungen (IDEs) und Git-based Quell-Repositorys gehören. PATs repräsentieren 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 empfiehlt sich, sie sicher auf Ihrem lokalen Computer aufzubewahren. PATs laufen standardmäßig nach einem Jahr ab.

Bei der Arbeit mit integrierten Entwicklungsumgebungen (IDEs) entsprechen PATs einem Git-Passwort. Geben Sie das PAT an, wenn Sie bei der Einrichtung Ihrer IDE für die Arbeit mit einem Git-Repository nach einem Passwort gefragt werden. Weitere Informationen darüber, wie Sie Ihre IDE mit einem Git-based 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. Beispielsweise können Sie Zweige verwenden, um an einer neuen oder anderen Version von Dateien zu arbeiten, ohne dass sich dies auf Dateien in anderen Zweigen 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 Standard-Branch für das Repository.

Standard-Zweige

Quell-Repositorys in CodeCatalyst haben einen Standard-Branch, unabhängig davon, wie Sie sie erstellen. Wenn Sie sich dafür entscheiden, ein Projekt mithilfe einer Vorlage zu erstellen, enthält das für dieses Projekt erstellte Quell-Repository zusätzlich zu Beispielcode, Workflow-Definitionen und anderen Ressourcen eine README.md Datei. Wenn Sie ein Quell-Repository erstellen, ohne eine Vorlage zu verwenden, wird eine README.md Datei für Sie als erstes Commit hinzugefügt und im Rahmen der Erstellung des Repositorys wird ein Standard-Branch für Sie erstellt. Dieser Standard-Branch heißt main. Dieser Standard-Branch wird als Basis- oder Standard-Branch 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.

Du kannst den Standard-Branch für ein Quell-Repository nicht löschen. Die Suchergebnisse enthalten nur Ergebnisse aus dem Standard-Branch.

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. Das Commit enthält Informationen über die Änderung, einschließlich der Identität des Benutzers, der die Änderung vorgenommen hat, Uhrzeit und Datum der Änderung, des Commit-Titels und aller Nachrichten zu der Änderung. Weitere Informationen finden Sie unter Änderungen im Quellcode mit Commits in Amazon verstehen CodeCatalyst.

Im Kontext eines Quell-Repositorys in CodeCatalyst sind Commits Schnappschüsse des Inhalts und der Änderungen am Inhalt deines Repositorys. Du kannst Commits auch Git-Tags hinzufügen, um bestimmte Commits zu identifizieren.

Pull-Anforderungen

Ein Pull-Request ist die primäre Methode, mit der du und andere Nutzer 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 hin zu überprüfen. In einem Pull Request kannst du die Änderungen zwischen den Quell- und Ziel-Branches oder die Unterschiede zwischen den Revisionen 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, wird der angezeigte Unterschied zwischen der Revision des Pull Requests, den du ausgewählt hast, und dem Commit, der der Tipp des Ziel-Branches war, als du den Pull Request erstellt hast, angezeigt. Weitere Informationen zu Unterschieden und Merge-Basen in Git findest du unter git-merge-base in der Git-Dokumentation.

Überarbeitungen

Eine Revision ist eine aktualisierte Version eines Pull-Requests. Bei jedem Push zum Quell-Branch eines Pull-Requests wird eine Revision erstellt, die die Änderungen enthält, die in den Commits vorgenommen wurden, die in diesem Push enthalten sind. Du kannst dir die Unterschiede zwischen den Revisionen eines Pull Requests zusätzlich zu den Unterschieden zwischen den Quell- und Ziel-Branches ansehen. Weitere Informationen finden Sie unter Code mit Pull-Requests in Amazon überprüfen CodeCatalyst.

Arbeitsabläufe

Ein Workflow ist ein automatisiertes Verfahren, das beschreibt, wie Sie Ihren Code als Teil eines Systems für kontinuierliche Integration und kontinuierliche Bereitstellung (CI/CD) erstellen, testen und bereitstellen. Ein Workflow definiert eine Reihe von Schritten oder Aktionen, die während einer Workflow-Ausführung durchzuführen sind. Ein Workflow definiert auch die Ereignisse oder Auslöser, die zum Starten des Workflows führen. Um einen Workflow einzurichten, erstellen Sie eine Workflow-Definitionsdatei mit dem visuellen Editor oder dem YAML-Editor der CodeCatalyst Konsole.

Tipp

Um einen kurzen Überblick darüber zu erhalten, wie Sie Workflows in einem Projekt verwenden können, erstellen Sie ein Projekt mit einem Blueprint. Jeder Blueprint stellt einen funktionierenden Workflow bereit, den Sie überprüfen, ausführen und mit dem Sie experimentieren können.

Ein Quell-Repository kann auch die Konfigurationsdateien und andere Informationen für Workflows, Benachrichtigungen, Probleme und andere Konfigurationsinformationen für das Projekt speichern. Die Konfigurationsdateien werden im Quell-Repository erstellt und 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 aus einem Blueprint erstellen, sind die Konfigurationsdateien bereits im Quell-Repository gespeichert, das als Teil des Projekts für Sie erstellt wurde. Diese Konfigurationsinformationen werden in einem Ordner gespeichert, der .codecatalyst im Standard-Zweig Ihres Repositorys benannt ist. Immer wenn du einen Zweig des Standard-Branches erstellst, erstellst du zusätzlich zu allen anderen Dateien und Ordnern in diesem Zweig eine Kopie dieses Ordners und seiner Konfiguration.