View a markdown version of this page

Einrichtungsschritte für SSH-Verbindungen zu AWS CodeCommit Repositorys unter Windows - AWS CodeCommit

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.

Einrichtungsschritte für SSH-Verbindungen zu AWS CodeCommit Repositorys unter Windows

Bevor Sie AWS CodeCommit zum ersten Mal eine Verbindung herstellen können, müssen Sie einige Schritte zur Erstkonfiguration ausführen. Nachdem Sie Ihren Computer und Ihr AWS Profil eingerichtet haben, können Sie eine Verbindung zu einem CodeCommit Repository herstellen und dieses Repository auf Ihren Computer klonen (auch bekannt als Erstellen eines lokalen Repos). Wenn Sie mit Git noch nicht vertraut sind, finden Sie unter Wo kann ich mehr über Git erfahren? genauere Informationen.

Schritt 1: Erstkonfiguration für CodeCommit

Folgen Sie diesen Schritten, um ein Amazon Web Services-Konto einzurichten, einen IAM-Benutzer zu erstellen und den Zugriff auf zu CodeCommit konfigurieren.

So erstellen und konfigurieren Sie einen IAM-Benutzer für den Zugriff CodeCommit
  1. Erstellen Sie ein Amazon Web Services-Konto, indem Sie zu Sign Up gehen http://aws.amazon.com und dort Sign Up auswählen.

  2. Erstellen Sie in Ihrem Amazon Web Services-Konto einen IAM-Benutzer oder verwenden Sie einen vorhandenen. Stellen Sie sicher, dass Sie über eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel verfügen, die diesem IAM-Benutzer zugeordnet sind. Weitere Informationen finden Sie unter Einen IAM-Benutzer in Ihrem Amazon Web Services-Konto erstellen.

    Anmerkung

    CodeCommit benötigt AWS Key Management Service. Wenn Sie einen vorhandenen IAM-Benutzer verwenden, stellen Sie sicher, dass dem Benutzer keine Richtlinien zugeordnet sind, die die von CodeCommit erforderlichen AWS KMS Aktionen ausdrücklich verweigern. Weitere Informationen finden Sie unter AWS KMS und Verschlüsselung.

  3. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter. https://console.aws.amazon.com/iam/

  4. Wählen Sie in der IAM-Konsole im Navigationsbereich die Option Benutzer und dann den IAM-Benutzer aus, den Sie für den Zugriff konfigurieren möchten. CodeCommit

  5. Wählen Sie auf der Registerkarte Permissions die Option Add Permissions.

  6. Wählen Sie unter Grant permissions die Option Attach existing policies directly aus.

  7. Wählen Sie AWSCodeCommitPowerUser aus der Liste der Richtlinien eine andere verwaltete Richtlinie für CodeCommit den Zugriff aus. Weitere Informationen finden Sie unter AWS verwaltete Richtlinien für CodeCommit.

    Nachdem Sie die Richtlinie ausgewählt haben, die Sie anhängen möchten, wählen Sie Weiter: Überprüfen, um die Liste der Richtlinien zu überprüfen, die an den IAM-Benutzer angehängt werden sollen. Ist die Liste korrekt, wählen Sie Add permissions aus.

    Weitere Informationen zu CodeCommit verwalteten Richtlinien und zur gemeinsamen Nutzung des Zugriffs auf Repositorys mit anderen Gruppen und Benutzern finden Sie unter Ein Repository teilen und. Authentifizierung und Zugriffskontrolle für AWS CodeCommit

Anmerkung

Wenn Sie AWS CLI Befehle mit verwenden möchten CodeCommit, installieren Sie den AWS CLI. Weitere Informationen finden Sie unter Befehlszeilenreferenz.

Schritt 2: Installieren von Git

Um mit Dateien, Commits und anderen Informationen in CodeCommit Repositorys zu arbeiten, musst du Git auf deinem lokalen Computer installieren. CodeCommit unterstützt die Git-Versionen 1.7.9 und höher. Git Version 2.28 unterstützt die Konfiguration des Branch-Namens für erste Commits. Wir empfehlen die Verwendung einer aktuellen Version von Git.

Um Git zu installieren, empfehlen wir Websites wie Git Downloads.

Anmerkung

Git ist eine sich entwickelnde, regelmäßig aktualisierte Plattform. Gelegentlich kann sich eine Funktionsänderung auf die Art und Weise auswirken, wie sie funktioniert CodeCommit. Wenn du Probleme mit einer bestimmten Version von Git und hast CodeCommit, sieh dir die Informationen unter anFehlerbehebung.

Wenn die installierte Git-Version keinen Bash-Emulator, z. B. Git Bash, umfasst, installieren Sie einen. Sie verwenden diesen Emulator beim Erstellen von SSH-Verbindungen anstelle der Windows-Befehlszeile.

Schritt 3: Richte die öffentlichen und privaten Schlüssel für Git ein und CodeCommit

Um die öffentlichen und privaten Schlüssel für Git und CodeCommit unter Windows einzurichten
  1. Öffnen Sie den Bash-Emulator.

    Anmerkung

    Eventuell müssen Sie den Emulator mit Administratorberechtigungen ausführen.

    Führen Sie im Emulator den Befehl ssh-keygen aus und befolgen Sie die Anweisungen, um die Datei im Verzeichnis ".ssh" für Ihr Profil zu speichern.

    Beispiel:

    $ ssh-keygen Generating public/private rsa key pair. Enter file in which to save the key (/drive/Users/user-name/.ssh/id_rsa): Type a file name here, for example /c/Users/user-name/.ssh/codecommit_rsa Enter passphrase (empty for no passphrase): <Type a passphrase, and then press Enter> Enter same passphrase again: <Type the passphrase again, and then press Enter> Your identification has been saved in drive/Users/user-name/.ssh/codecommit_rsa. Your public key has been saved in drive/Users/user-name/.ssh/codecommit_rsa.pub. The key fingerprint is: 45:63:d5:99:0e:99:73:50:5e:d4:b3:2d:86:4a:2c:14 user-name@client-name The key's randomart image is: +--[ RSA 2048]----+ | E.+.o*.++| | .o .=.=o.| | . .. *. +| | ..o . +..| | So . . . | | . | | | | | | | +-----------------+

    Folgendes wird generiert:

    • Die codecommit_rsa Datei, die die private Schlüsseldatei ist.

    • Die codecommit_rsa PUB-Datei, die die öffentliche Schlüsseldatei ist.

    Tipp

    ssh-keygenGeneriert standardmäßig einen 2048-Bit-Schlüssel. Sie können die Parameter -t und -b verwenden, um den Typ und die Länge des Schlüssels anzugeben. Wenn Sie einen 4096-Bit-Schlüssel im RSA-Format benötigen, geben Sie dies an, indem Sie den Befehl mit den folgenden Parametern ausführen:

    ssh-keygen -t rsa -b 4096

    Weitere Informationen zu den Formaten und Längen, die für SSH-Schlüssel erforderlich sind, finden Sie unter Using IAM with. CodeCommit

  2. Führen Sie die folgenden Befehle aus, um den Wert der öffentlichen Schlüsseldatei (codecommit_rsa.pub) anzuzeigen:

    cd .ssh notepad codecommit_rsa.pub

    Kopieren Sie den Inhalt der Datei und schließen Sie Notepad, ohne zu speichern. Der Inhalt der Datei ähnelt dem folgenden Beispiel:

    ssh-rsa EXAMPLE-AfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMCVVMxCzAJB gNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb2 5zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhc NMTEwNDI1MjA0NTIxWhcNMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAw DgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDAS=EXAMPLE user-name@computer-name
  3. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter. https://console.aws.amazon.com/iam/

    Anmerkung

    Sie können Ihre CodeCommit Anmeldeinformationen direkt unter Meine Sicherheitsanmeldedaten einsehen und verwalten. Weitere Informationen finden Sie unter Ihre Anmeldeinformationen anzeigen und verwalten.

  4. Wählen Sie in der IAM-Konsole im Navigationsbereich die Option Benutzer aus, und wählen Sie aus der Benutzerliste Ihren IAM-Benutzer aus.

  5. Wählen Sie auf der Detailseite des Benutzers auf der Registerkarte Security Credentials die Option Upload SSH public key aus.

  6. Kopieren Sie den Inhalt des öffentlichen SSH-Schlüssels in das Feld und wählen Sie dann Upload SSH public key aus.

  7. Kopieren oder speichern Sie die Informationen in der SSH-Schlüssel-ID (z. B.APKAEIBAERJR2EXAMPLE).

    Die SSH-Schlüssel-ID in der IAM-Konsole
    Anmerkung

    Wenn Sie mehr als eine SSH-Schlüssel-IDs hochgeladen haben, werden die Schlüssel alphabetisch nach Schlüssel-ID und nicht nach dem Datum des Hochladens aufgeführt. Stellen Sie sicher, dass Sie die Schlüssel-ID kopiert haben, die dem richtigen Upload-Datum zugeordnet ist.

  8. Führen Sie im Bash-Emulator die folgenden Befehle aus, um im Verzeichnis "~/.ssh" eine Konfigurationsdatei zu erstellen bzw. zu bearbeiten, falls bereits eine solche Datei vorhanden ist:

    notepad ~/.ssh/config
  9. Fügen Sie der Datei die folgenden Zeilen hinzu, wobei der Wert für die SSH-Schlüssel-ID User ist, die Sie zuvor kopiert haben, und der Wert für den Pfad und den Namen der privaten Schlüsseldatei IdentityFile ist:

    Host git-codecommit.*.amazonaws.com User APKAEIBAERJR2EXAMPLE IdentityFile ~/.ssh/codecommit_rsa
    Anmerkung

    Wenn Sie Ihrer privaten Schlüsseldatei einen anderen Namen als gegeben habencodecommit_rsa, achten Sie darauf, ihn hier zu verwenden.

    Sie können den SSH-Zugriff auf Repositorys in mehreren Amazon Web Services-Konten einrichten. Weitere Informationen finden Sie unterFehlerbehebung bei SSH-Verbindungen zu AWS CodeCommit.

    Speichern Sie die Datei als "config" (nicht "config.txt") und schließen Sie Notepad.

    Wichtig

    Der Name der Datei muss config ohne Dateierweiterung lauten. Andernfalls schlagen die SSH-Verbindungen fehl.

  10. Führen Sie den folgenden Befehl aus, um Ihre SSH-Konfiguration zu testen:

    ssh git-codecommit.us-east-2.amazonaws.com

    Sie werden aufgefordert, die Verbindung zu bestätigen, da sie noch nicht in Ihrer bekannten Hosts-Datei enthalten git-codecommit.us-east-2.amazonaws.com ist. Der CodeCommit Server-Fingerabdruck wird als Teil der Überprüfung angezeigt (a9:6d:03:ed:08:42:21:be:06:e1:e0:2a:d1:75:31:5efür MD5 oder 3lBlW2g5xn/NA2Ck6dyeJIrQOWvn7n8UEs56fG6ZIzQ für SHA256).

    Anmerkung

    CodeCommit Server-Fingerabdrücke sind für jeden einzigartig. AWS-Region Informationen zum Anzeigen der Serverfingerabdrücke für einen finden Sie AWS-Region unter. Server-Fingerabdrücke für CodeCommit

    Nachdem Sie die Verbindung bestätigt haben, sollte jeweils eine Bestätigung angezeigt werden, dass der Server der Datei mit den bekannten Hosts hinzugefügt und die Verbindung hergestellt wurde. Wenn Sie keine Erfolgsmeldung sehen, überprüfen Sie, ob Sie die config Datei im Verzeichnis ~/.ssh des IAM-Benutzers gespeichert haben, auf den Sie für den Zugriff konfiguriert haben CodeCommit, dass die config Datei keine Dateierweiterung hat (z. B. darf sie nicht config.txt heißen) und dass Sie die richtige private Schlüsseldatei (nicht .pub) angegeben haben. codecommit_rsa codecommit_rsa

    Führen Sie den Befehl mit dem Parameter aus, um Probleme zu beheben. ssh -v Beispiel:

    ssh -v git-codecommit.us-east-2.amazonaws.com

    Weitere Informationen zum Beheben von Verbindungsproblemen finden Sie unter Fehlerbehebung bei SSH-Verbindungen zu AWS CodeCommit.

Schritt 4: Stellen Sie eine Verbindung zur CodeCommit Konsole her und klonen Sie das Repository

Wenn Sie den Namen und die Verbindungsdetails für das CodeCommit-Repository bereits von einem Administrator erhalten haben, können Sie diesen Schritt überspringen und das Repository direkt klonen.

Um eine Verbindung zu einem CodeCommit Repository herzustellen
  1. Öffnen Sie die CodeCommit Konsole unter https://console.aws.amazon.com/codesuite/codecommit/home.

  2. Wählen Sie in der Regionsauswahl den Ort aus, AWS-Region an dem das Repository erstellt wurde. Repositorys sind spezifisch für einen. AWS-Region Weitere Informationen finden Sie unter Regionen und Git-Verbindungsendpunkte.

  3. Suchen Sie das Repository, zu dem Sie eine Verbindung herstellen möchten, in der Liste und wählen Sie es aus. Wählen Sie Clone URL (URL klonen) und dann das Protokoll aus, das Sie beim Klonen oder bei der Verbindung zu dem Repository verwenden möchten. Dadurch wird die Klon-URL kopiert.

    • Kopieren Sie die HTTPS-URL, wenn Sie entweder Git-Anmeldeinformationen mit Ihrem IAM-Benutzer oder den in der enthaltenen Credential Helper verwenden. AWS CLI

    • Kopieren Sie die HTTPS-URL (GRC), wenn Sie den Befehl git-remote-codecommit auf Ihrem lokalen Computer verwenden.

    • Kopieren Sie die SSH-URL, wenn Sie ein public/private SSH-Schlüsselpaar mit Ihrem IAM-Benutzer verwenden.

    Anmerkung

    Wenn Sie statt einer Liste von Repositorys eine Willkommensseite sehen, sind Ihrem AWS Konto in dem, in AWS-Region dem Sie angemeldet sind, keine Repositorys zugeordnet. Informationen zur Erstellung eines Repositorys finden Sie unter Erstellen Sie eine AWS CodeCommit Repository, oder befolgen Sie die Schritte im Tutorial Erste Schritte mit Git und CodeCommit.

  4. Führen Sie im Bash-Emulator den git clone-Befehl mit der SSH-URL aus, die Sie kopiert haben, um das Repository zu klonen. Durch diesen Befehl wird in einem Unterverzeichnis des Verzeichnisses, in dem Sie den Befehl ausgeführt haben, das lokale Repository erstellt. Um beispielsweise ein Repository zu klonen, das MyDemoRepo nach einem lokalen Repo benannt ist, das my-demo-repo in der Region USA Ost (Ohio) benannt ist:

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

    Öffnen Sie alternativ eine Eingabeaufforderung und führen Sie den Befehl mithilfe der URL und der SSH-Schlüssel-ID für den öffentlichen Schlüssel aus, den Sie in IAM hochgeladen haben. git clone Dadurch wird das lokale Repository in einem Unterverzeichnis des Verzeichnisses erstellt, in dem Sie den Befehl ausgeführt haben. Im folgenden Beispiel wird ein Repository mit dem Namen MyDemoRepo in ein lokales Repository mit dem Namen my-demo-repo geklont:

    git clone ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

    Weitere Informationen erhalten Sie unter Stellen Sie eine Verbindung zum CodeCommit Repository her, indem Sie das Repository klonen und Erstellen Sie einen Commit.

Nächste Schritte

Sie haben die Voraussetzungen erfüllt. Folgen Sie den Schritten unter, um mit der Verwendung Erste Schritte mit CodeCommit CodeCommit zu beginnen.