Konzepte für Quell-Repositorien

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. 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.

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

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 und 16 GiB persistenten Speicher verfügt. RAM

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 persönliches Zugriffstoken (PAT) ähnelt einem Passwort. Es ist mit Ihrer Benutzeridentität verknüpft und kann in allen Bereichen und Projekten in verwendet CodeCatalyst werden. Sie verwendenPATs, um auf CodeCatalyst Ressourcen zuzugreifen, die integrierte Entwicklungsumgebungen (IDEs) und Git-basierte Quell-Repositorys umfassen. PATsvertreten Sie in CodeCatalyst und Sie können sie in Ihren Benutzereinstellungen verwalten. Ein Benutzer kann mehr als einen habenPAT. Persönliche Zugriffstoken werden nur einmal angezeigt. Es hat sich bewährt, sie sicher auf Ihrem lokalen Computer zu speichern. PATsVerfallen standardmäßig nach einem Jahr.

Bei der Arbeit mit integrierten Entwicklungsumgebungen (IDEs) entsprechen PATs sie einem Git-Passwort. Geben Sie das anPAT, wenn Sie nach einem Passwort gefragt werden, wenn Sie Ihr Konto für IDE die Arbeit mit einem Git-Repository einrichten. Weitere Informationen darüber, wie Sie Ihr IDE mit einem Git-basierten Repository verbinden, finden Sie in der Dokumentation zu IhremIDE.

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 Zweig oder mehrere Zweige 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 sich dafür entscheiden, ein Projekt mithilfe einer Vorlage zu erstellen, 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 für Sie als erstes Commit eine README .md-Datei hinzugefügt, und im Rahmen der Erstellung des Repositorys wird ein Standardbranch 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. Sie können ändern, welcher Zweig als Standardzweig verwendet wird. Weitere Informationen finden Sie unter Den Standard-Branch für ein Repository verwalten.

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.

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-basein 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.

Workflows

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 eine Workflow-Definitionsdatei mithilfe der visuellen Benutzeroberfläche oder des YAML Editors der CodeCatalyst Konsole.

Tipp

Um einen schnellen Ü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.

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.