Einrichtungsschritte für HTTPS-Verbindungen zuAWS CodeCommit Repositorys unter Windows mit demAWS CLI Credential Helper - AWS CodeCommit
Schritt 1: Erstkonfiguration für CodeCommitSchritt 2: Installieren von GitSchritt 3: Einrichten des Credential-HelpersSchritt 4: Connect CodeCommit Konsole und Klonen des RepositorysNächste Schritte

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 HTTPS-Verbindungen zuAWS CodeCommit Repositorys unter Windows mit demAWS CLI Credential Helper

Bevor Sie AWS CodeCommit verwenden können, müssen Sie die Schritte für die erste Konfiguration ausführen. Für die meisten Benutzer lässt sich das am einfachsten mit den Schritten unter Für HTTPS-Benutzer, die Git-Anmeldeinformationen verwenden umsetzen. Wenn Sie jedoch eine Verbindung CodeCommit mit einem Root-Konto, einem Verbundzugriff oder temporären Anmeldeinformationen herstellen möchten, können Sie den Anmeldeinformationshelfer verwenden, der in der enthalten istAWS CLI.

Anmerkung

Der Credential Helper ist zwar eine unterstützte Methode für die Verbindung CodeCommit mit einem Verbundzugriff, einem Identitätsanbieter oder temporären Anmeldeinformationen, es wird jedoch empfohlen, dasgit-remote-codecommit Dienstprogramm zu installieren und zu verwenden. Weitere Informationen finden Sie unter Einrichtungsschritte für HTTPS-Verbindungen zuAWS CodeCommit mit git-remote-codecommit.

In diesem Thema erfahren Sie, wie Sie das Repository installierenAWS CLI, Ihren Computer und IhrAWS Profil einrichten, eine Verbindung zu einem CodeCommit Repository herstellen und dieses Repository auf Ihrem Computer klonen. Dies wird auch als Erstellen eines lokalen Repositorys bezeichnet. 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 Services-Konto einzurichten, einen IAM-Benutzer zu erstellen und zu konfigurieren und den zu installierenAWS CLI. DasAWS CLI beinhaltet einen Anmeldeinformationshelfer, den Sie für HTTPS-Verbindungen zu Ihren CodeCommit Repositorys konfigurieren.

So erstellen und konfigurieren Sie einen IAM-Benutzer für den Zugriff CodeCommit

  1. Erstellen Sie ein Amazon Web Services Services-Konto, indem Sie zu http://aws.amazon.com gehen und „Anmelden“ wählen.

  2. Erstellen Sie einen IAM-Benutzer in Ihrem Amazon Web Services Services-Konto, oder verwenden Sie einen vorhandenen. Vergewissern Sie sich, dass Sie eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel haben, der mit diesem IAM-Benutzer verknüpft ist. Weitere Informationen finden Sie unter Erstellen eines IAM-Benutzers in Ihrem Amazon Web Services Services-Konto.

    Anmerkung

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

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

  4. Wählen Sie im Navigationsbereich der IAM-Konsole die Option Users und anschließend den IAM-Benutzer aus, der IAM-Konsole für den CodeCommit Zugriff konfiguriert werden soll.

  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 aus der Liste der Richtlinien eine AWSCodeCommitPowerUseroder eine andere verwaltete Richtlinie für den CodeCommit Zugriff aus. Weitere Informationen finden Sie unter AWS Von verwaltete Richtlinien für CodeCommit.

    Nachdem Sie die Richtlinie ausgewählt haben, die Sie anhängen möchten, klicken Sie auf 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 zum Teilen des Zugriffs auf Repositorys mit anderen Gruppen und Benutzern finden Sie unterEin Repository teilen undAuthentifizierung und Zugriffskontrolle für AWS CodeCommit.

So installieren und konfigurieren Sie die AWS CLI

  1. Laden Sie die AWS CLI auf den lokalen Computer herunter und installieren Sie. Dies ist eine Voraussetzung für die Interaktion mit CodeCommit der Befehlszeile. Es wird empfohlen,AWS CLI Version 2 zu installieren. Es ist die neueste Hauptversion derAWS CLI und unterstützt alle aktuellen Funktionen. Es ist die einzige Version vonAWS CLI, die die Verwendung eines Root-Kontos, eines Verbundzugriffs oder temporärer Anmeldeinformationen unterstütztgit-remote-codecommit.

    Weitere Informationen finden Sie unter Erste Schritte mit der AWS-Befehlszeilenschnittstelle.

    Anmerkung

    CodeCommit funktioniert nur mitAWS CLI Versionen 1.7.38 und höher. Als bewährte Methode installieren oder aktualisieren Sie die AWS CLI auf die neueste verfügbare Version. Führen Sie den Befehl aws --version aus, um zu überprüfen, welche Version der AWS CLI installiert ist.

    Informationen zum Upgraden von einer älteren auf die aktuelle Version der AWS CLI finden Sie unter Installieren der AWS Command Line Interface.

  2. Führen Sie diesen Befehl aus, um zu überprüfen, obAWS CLI die CodeCommit Befehle für die

    aws codecommit help

    Dieser Befehl gibt eine Liste mit CodeCommit Befehlen zurück.

  3. Konfigurieren Sie dasAWS CLI mit einem Profil, indem Sie den folgendenconfigure Befehl verwenden:.

    aws configure

    Wenn Sie dazu aufgefordert werden, geben Sie denAWS Zugriffsschlüssel und denAWS geheimen Zugriffsschlüssel des IAM-Benutzers an, der verwendet werden soll CodeCommit. Stellen Sie außerdem sicher, dass Sie angeben,AWS-Region wo sich das Repository befindet, z.us-east-2 B. Wenn Sie nach dem standardmäßigen Ausgabeformat gefragt werden, geben Sie json an. Wenn Sie beispielsweise ein Profil für einen IAM-Benutzer konfigurieren:

    AWS Access Key ID [None]: Type your IAM user AWS access key ID here, and then press Enter
AWS Secret Access Key [None]: Type your IAM user AWS secret access key here, and then press Enter
Default region name [None]: Type a supported region for CodeCommit here, and then press Enter
Default output format [None]: Type json here, and then press Enter

    Weitere Informationen zum Erstellen und Konfigurieren von Profilen für die AWS CLI finden Sie unter:

    Um eine Verbindung zu einem Repository oder einer Ressource in einem anderen Repository herzustellenAWS-Region, müssen Sie dasAWS CLI mit dem standardmäßigen Regionsnamen neu konfigurieren. Zu den unterstützten Standard-Regionsnamen CodeCommit gehören:

    • us-east-2

    • us-east-1

    • eu-west-1

    • us-west-2

    • ap-northeast-1

    • ap-southeast-1

    • ap-southeast-2

    • ap-southeast-3

    • me-central-1

    • eu-central-1

    • ap-northeast-2

    • sa-east-1

    • us-west-1

    • eu-west-2

    • ap-south-1

    • ap-south-1

    • ca-central-1

    • us-gov-west-1

    • us-gov-east-1

    • eu-north-1

    • ap-east-1

    • me-south-1

    • cn-north-1

    • cn-northwest-1

    • eu-south-1

    • ap-northeast-3

    • af-south-1

    Weitere Informationen zu CodeCommit undAWS-Region finden Sie unterRegionen und Git-Verbindungsendpunkte. Informationen zu IAM, Zugriffsschlüssel und geheimen Schlüsseln finden Sie unter Wie erhalte ich Anmeldeinformationen? und Verwaltung von Zugriffsschlüsseln für IAM-Benutzer. Weitere Informationen zur AWS CLI und zu Profilen finden Sie unter Benannte Profile.

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 Git-Versionen 1.7.9 und höher. Git Version 2.28 unterstützt die Konfiguration des Branchnamens für erste Commits. Wir empfehlen die Verwendung einer aktuellen Version von Git.

Um Git zu installieren, empfehlen wir Websites wie Git für Windows. Wenn du diesen Link verwendest, um Git zu installieren, kannst du alle Standardeinstellungen der Installation akzeptieren, mit Ausnahme der folgenden:

Anmerkung

Git ist eine sich entwickelnde, regelmäßig aktualisierte Plattform. Gelegentlich kann sich eine Änderung der Funktion auf die Funktionsweise auswirken CodeCommit. Wenn du Probleme mit einer bestimmten Version von Git und hast CodeCommit, lies dir die Informationen unter durchFehlerbehebung.

Schritt 3: Einrichten des Credential-Helpers

DasAWS CLI enthält einen Git-Helper für Anmeldeinformationen, mit dem Sie ihn verwenden können CodeCommit. Der Git Credential Helper benötigt einAWS Anmeldeinformationsprofil, das eine Kopie derAWS Zugriffsschlüssel-ID und desAWS geheimen Zugriffsschlüssels eines IAM-Benutzers (zusammen mit einemAWS-Region Standardnamen und einem Standardausgabeformat) speichert. Der Git Credential Helper verwendet diese Informationen, um sich automatisch zu authentifizieren, CodeCommit sodass Sie diese Informationen nicht jedes Mal eingeben müssen, wenn Sie Git für die Interaktion mit Git verwenden CodeCommit.

  1. Öffnen Sie eine Befehlszeile und verwenden Sie Gitgit config, um sie auszuführen. Geben Sie dabei die Verwendung des Git Credential-Helpers mit demAWS Anmeldeinformationsprofil an, wodurch der Git Credential Helper den Pfad zu den Repositorys senden kann:

    git config --global credential.helper "!aws codecommit credential-helper $@"
git config --global credential.UseHttpPath true

    Das Git-Hilfsprogramm für Anmeldeinformationen schreibt folgende Werte in die .gitconfig-Datei:

    [credential]    
    helper = !aws codecommit credential-helper $@ 
    UseHttpPath = true
    Wichtig

    • Falls Sie anstelle der Windows-Befehlszeile einen Bash-Emulator einsetzen, müssen Sie einfache (statt doppelte) Anführungszeichen eingeben.

    • Der Credential Helper verwendet dasAWS Standardprofil oder die Amazon EC2 EC2-Instance-Rolle. Wenn Sie ein eigenes erstelltes AWS-Anmeldeinformationsprofil verwenden möchten (z. B. CodeCommitProfile), können Sie den Befehl folgendermaßen anpassen:

      git config --global credential.helper "!aws codecommit credential-helper --profile CodeCommitProfile $@"

      Dann werden folgende Werte in die .gitconfig-Datei geschrieben:

      [credential]    
    helper = !aws codecommit credential-helper --profile=CodeCommitProfile $@ 
    UseHttpPath = true

    • Falls Ihr Profilname Leerzeichen enthält, müssen Sie nach der Ausführung dieses Befehls den Namen in der .gitconfig-Datei in einfache Anführungszeichen (') setzen. Andernfalls können Sie das Hilfsprogramm für Anmeldeinformationen nicht nutzen.

    • Wenn Sie im Rahmen der Installation von Git für Windows auch das Git-Dienstprogramm zur Verwaltung von Anmeldeinformationen (Git Credential Manager) implementiert haben, werden Ihnen nach den ersten Verbindungsversuchen entweder 403-Fehlermeldungen angezeigt oder Sie werden vom Dienstprogramm aufgefordert, Ihre Anmeldeinformationen einzugeben. Dieses Problem lässt sich am besten lösen, indem Sie Git für Windows deinstallieren und dann ohne den Git Credential Manager erneut installieren, da das Dienstprogramm mit CodeCommit nicht kompatibel ist. Wenn Sie das Git Credential Manager-Dienstprogramm beibehalten möchten, müssen Sie zusätzliche Konfigurationsschritte durchführen, um es ebenfalls zu verwenden CodeCommit, einschließlich der manuellen Änderung der Datei.gitconfig, um festzulegen, wie der Credential-HelperAWS CodeCommit beim Herstellen einer Verbindung mit verwendet werden soll CodeCommit. Entfernen Sie sämtliche gespeicherten Anmeldeinformationen aus dem Credential Manager-Dienstprogramm (dies finden Sie in der Systemsteuerung). Nachdem Sie alle gespeicherten Anmeldeinformationen gelöscht haben, fügen Sie folgenden Abschnitt zur .gitconfig-Datei hinzu, speichern diese und versuchen, über ein neues Befehlszeilenfenster eine Verbindung herzustellen:

      [credential "https://git-codecommit.us-east-2.amazonaws.com"]
    helper = !aws codecommit credential-helper $@ 
    UseHttpPath = true

[credential "https://git-codecommit.us-east-1.amazonaws.com"]
    helper = !aws codecommit credential-helper $@ 
    UseHttpPath = true

      Möglicherweise ist zusätzlich eine Neukonfiguration der Einstellungen für git config erforderlich. Dabei geben Sie --system anstelle von --global oder --local an, damit alle Verbindungen ordnungsgemäß hergestellt werden können.

    • Wenn Sie verschiedene IAM-Benutzer auf demselben lokalen Computer verwenden möchten CodeCommit, sollten Sie git config --local statt dessengit config --global die Konfiguration für jedesAWS Anmeldeinformationsprofil angeben und ausführen.

  2. Führen Sie den Befehl git config --global --edit aus, um zu prüfen, ob die vorigen Werte in die .gitconfig-Datei Ihres Benutzerprofils geschrieben wurden (standardmäßig %HOME%\.gitconfig oder drive:\Users\UserName\.gitconfig). War der Schreibvorgang erfolgreich, werden die Werte angezeigt (zusätzlich zu den Werten, die ggf. bereits in der globalen Git-Konfigurationsdatei vorhanden sind). Zum Beenden geben Sie :q ein und drücken die Eingabetaste.

Schritt 4: Connect CodeCommit Konsole und Klonen des Repositorys

Wenn Ihnen ein Administrator bereits den Namen und die Verbindungsdetails für das CodeCommit Repository gesendet hat, können Sie diesen Schritt überspringen und das Repository direkt klonen.

So stellen Sie eine Verbindung zu einem CodeCommit Repository her

  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 einAWS-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 für Ihren IAM-Benutzer oder den in der enthaltenen Anmeldeinformationshelfer verwendenAWS 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 mit Ihrem IAM-Benutzer ein öffentliches/privates SSH-Schlüsselpaar verwenden.

    Anmerkung

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

  4. Öffnen Sie eine Eingabeaufforderung und führen Sie dengit clone Befehl mit der kopierten HTTPS-URL aus, die Sie kopiert haben. Dadurch wird das lokale Repository in einem Unterverzeichnis des Verzeichnisses erstellt, in dem Sie den Befehl ausgeführt haben. Um beispielsweise ein Repository mit dem Namen eines lokalen Repositorys mit dem Namen my-demo-repoder Region USA Ost (Ohio) MyDemoRepozu klonen, gehen Sie wie folgt vor:

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

    Bei einigen Windows-Versionen werden Sie möglicherweise über eine Popup-Meldung aufgefordert, Ihren Benutzernamen und Ihr Passwort einzugeben. Dabei handelt es sich um das integrierte System für die Anmeldeinformationsverwaltung von Windows, dieses ist jedoch nicht mit dem AWS CodeCommit-Hilfsprogramm für Anmeldeinformationen kompatibel. Klicken Sie auf Abbrechen.

Nächste Schritte

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