Herstellen einer Verbindung mit einem AWS CodeCommit-Repository

Wenn Sie zum ersten Mal eine Verbindung zu einem CodeCommit Repository herstellen, klonen Sie in der Regel seinen Inhalt auf Ihren lokalen Computer. Sie können Dateien auch direkt über die Konsole zu einem Repository hinzufügen und in einem Repository bearbeiten. CodeCommit Wenn Sie bereits ein lokales Repository besitzen, können Sie ein CodeCommit-Repository auch als Remote-Repository hinzufügen. Dieses Thema enthält Anweisungen zum Herstellen einer Verbindung mit einem CodeCommit Repository. Wenn Sie ein vorhandenes Repository zu migrieren möchten CodeCommit, finden Sie weitere Informationen unter Migration zu CodeCommit.

Anmerkung

Abhängig von Ihrer Nutzung wird Ihnen möglicherweise das Erstellen oder Zugreifen auf ein Repository in Rechnung gestellt. Weitere Informationen finden Sie unter Preise auf der CodeCommit Produktinformationsseite.

Voraussetzungen für die Verbindung mit einem CodeCommit Repository

Bevor Sie ein CodeCommit Repository klonen oder ein lokales Repository mit einem CodeCommit -Repository verbinden können:

• Der lokale Computer muss mit der entsprechenden Software und den Einstellungen konfiguriert sein, die eine Verbindung mit CodeCommit zulassen. Dazu gehört die Installation und Konfiguration von Git. Weitere Informationen finden Sie unter Einrichtung und Erste Schritte mit Git und AWS CodeCommit.

• Sie müssen über die Klon-URL des CodeCommit Repositorys verfügen, mit dem Sie eine Verbindung herstellen möchten. Weitere Informationen finden Sie unter Anzeigen von Repository-Details.

  Wenn Sie noch kein CodeCommit Repository erstellt haben, folgen Sie den Anweisungen unter Erstellen eines -Repositorys, kopieren Sie die Klon-URL des CodeCommit Repositorys und kehren Sie zu dieser Seite zurück.

  Wenn Sie ein CodeCommit Repository haben, dessen Namen aber nicht kennen, folgen Sie den Anweisungen unter Anzeigen von Repository-Details.

• Sie müssen einen Speicherort auf Ihrem lokalen Computer haben, um eine lokale Kopie des CodeCommit Repositorys zu speichern, mit dem Sie eine Verbindung herstellen. (Diese lokale Kopie des CodeCommit Repositorys wird als lokales Repository bezeichnet.) Sie wechseln dann zu Git-Befehlen, die Sie an diesem Ort ausführen. Sie können beispielsweise /tmp (für Linux, macOS oder Unix) oder c:\temp (für Windows) verwenden, wenn Sie zu Testzwecken einen temporären Klon erstellen. Dies ist der Verzeichnispfad, der in diesen Beispielen verwendet wird.

  Anmerkung

  Sie können jedes beliebige Verzeichnis verwenden. Wenn Sie ein Repository für eine langfristige Nutzung klonen, sollten Sie den Klon aus einem Arbeitsverzeichnis erstellen, das nicht für temporäre Dateien genutzt wird. Bei Verwendung eines anderen Verzeichnisses als /tmp oder c:\temp müssen Sie das von uns angegebene Verzeichnis in diesen Anweisungen mit diesem Verzeichnis ersetzen.

Herstellen einer Verbindung mit dem CodeCommit Repository durch Klonen des Repositorys

Wenn Sie noch kein lokales Repository haben, führen Sie die Schritte in diesem Verfahren aus, um das CodeCommit Repository auf Ihren lokalen Computer zu klonen.

1. Sorgen Sie dafür, dass die Voraussetzungen erfüllt sind, einschließlich Einrichtung .

   Wichtig

   Wenn Sie die Einrichtung nicht abgeschlossen haben, können Sie weder eine Verbindung herstellen noch das Repository klonen.

2. Verwenden Sie im Verzeichnis /tmp oder c:\temp Git, um den Befehl clone auszuführen. Die folgenden Beispiele zeigen, wie Sie ein Repository mit dem Namen MyDemoRepo in der Region USA Ost (Ohio) klonen.

   Für HTTPS mit Git-Anmeldeinformationen oder dem Hilfsprogramm für Anmeldeinformationen, der in der AWS CLI enthalten ist:

   git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

   Für HTTPS mit wird das Standardprofil git-remote-codecommitangenommen und in der AWS-Region konfiguriertAWS CLI:

   git clone codecommit://MyDemoRepo my-demo-repo

   Für SSH:

   git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

   In diesem Beispiel git-codecommit.us-east-2.amazonaws.com ist der Git-Verbindungspunkt für die Region USA Ost (Ohio), in der sich das Repository befindet, MyDemoRepo repräsentiert den Namen Ihres CodeCommit Repositorys und my-demo-repo repräsentiert den Namen des Verzeichnisses, das Git im /tmp Verzeichnis oder im c:\temp Verzeichnis erstellt. Weitere Informationen zu den AWS-Regionen, die unterstützen, CodeCommit und zu den Git-AWS-RegionenVerbindungen für diese finden Sie unter Regionen und Git-Verbindungsendpunkte.

   Anmerkung

   Beim Klonen eines Repositorys mit SSH auf Windows-Betriebssystemen müssen Sie gegebenenfalls die SSH-Schlüssel-ID wie folgt der Verbindungszeichenfolge hinzufügen:

   git clone ssh://[e-mail]/v1/repos/MyDemoRepo my-demo-repo

   Weitere Informationen finden Sie unter Für SSH-Verbindungen unter Windows und Fehlerbehebung.

   Nachdem Git das Verzeichnis erstellt hat, ruft es eine Kopie Ihres CodeCommit Repositorys in das neu erstellte Verzeichnis ab.

   Wenn das CodeCommit Repository neu oder anderweitig leer ist, wird eine Meldung angezeigt, dass Sie ein leeres Repository klonen. Das ist normal.

   Anmerkung

   Wenn Sie die Fehlermeldung erhalten, dass Git das CodeCommit Repository nicht finden kann oder dass Sie nicht über die Berechtigung zum Herstellen einer Verbindung mit dem CodeCommit Repository verfügen, stellen Sie sicher, dass Sie die Voraussetzungen erfüllen, einschließlich der Zuweisung von Berechtigungen für den IAM-Benutzer und der Einrichtung Ihrer IAM-Benutzeranmeldeinformationen für Git und CodeCommit auf dem lokalen Computer. Einrichten für AWS CodeCommit Vergewissern Sie sich auch, dass der Repository-Name stimmt.

Nachdem Sie Ihr lokales Repository erfolgreich mit Ihrem CodeCommit Repository verbunden haben, können Sie jetzt Git-Befehle aus dem lokalen Repository ausführen, um Commits, Verzweigungen und Tags zu erstellen und an das CodeCommit Repository zu übertragen und daraus zu ziehen.

Verbinden eines lokalen Repositorys mit dem CodeCommit Repository

Führen Sie die folgenden Schritte aus, wenn Sie bereits ein lokales Repository besitzen und ein CodeCommit-Repository als Remote-Repository hinzufügen möchten. Wenn Sie bereits über ein Remote-Repository verfügen und Ihre Commits an CodeCommit und dieses andere Remote-Repository übertragen möchten, führen Sie die Schritte unter ausPush-Commits an zwei Repositorys.

1. Sorgen Sie dafür, dass die Voraussetzungen erfüllt sind.

2. Wechseln Sie von der Eingabeaufforderung oder dem Terminal zu Ihrem lokalen Repo-Verzeichnis und führen Sie den git remote add Befehl aus, um das CodeCommit Repository als Remote-Repository für Ihr lokales Repo hinzuzufügen.

   Mit dem folgenden Befehl wird beispielsweise der Remote-Hitname origin zu https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo hinzugefügt:

   Für HTTPS:

   git remote add origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo

   Für SSH:

   git remote add origin ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo

   Mit diesem Befehl wird kein Inhalt zurückgegeben.

3. Um zu überprüfen, ob Sie das CodeCommit Repository als Remote für Ihr lokales Repository hinzugefügt haben, führen Sie den git remote -v Befehl aus, der eine Ausgabe ähnlich der folgenden erstellen soll:

   Für HTTPS:

   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)      

   Für SSH:

   origin  ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (fetch)       
   origin  ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (push)

Nachdem Sie Ihr lokales Repository erfolgreich mit Ihrem CodeCommit Repository verbunden haben, können Sie mit der Ausführung von Git-Befehlen aus dem lokalen Repository beginnen, um Commits, Verzweigungen und Tags zu erstellen und an das CodeCommit Repository zu übertragen und daraus zu ziehen.