Einrichtungsschritte für HTTPS-Verbindungen zuAWS CodeCommitRepositorien unter Windows mit demAWS CLIHelfer für Anmeldeinformationen

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 über ein Root-Konto, über einen Verbundzugriff oder mit temporären Anmeldeinformationen eine Verbindung mit CodeCommit herstellen möchten, müssen Sie das AWS CLI-Hilfsprogramm für Anmeldeinformationen nutzen.

Anmerkung

Obwohl das Hilfsprogramm für Anmeldeinformationen eine unterstützte Methode für die Verbindung mit CodeCommit über den Verbundzugriff, über einen Identitätsanbieter oder mit temporären Anmeldeinformationen ist, empfiehlt sich die Installation und Verwendung des git-remote-codecommit-Dienstprogramms. Weitere Informationen finden Sie unter Einrichtungsschritte für HTTPS Verbindungen AWS CodeCommit mit git-remote-codecommit.

Dieses Thema führt Sie durch die Schritte zur Installation vonAWS CLI, richten Sie Ihren Computer ein undAWSProfil, stellen Sie eine Verbindung zu einem herCodeCommitRepository und klonen Sie dieses Repository auf Ihren Computer. Dies wird auch als Erstellen eines lokalen Repos 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ürCodeCommit

Gehen Sie wie folgt vor, um ein Amazon Web Services-Konto einzurichten, einen IAM-Benutzer zu erstellen und zu konfigurieren und denAWS CLI. Die AWS CLI enthält ein Hilfsprogramm für Anmeldeinformationen, das Sie für HTTPS-Verbindungen zu Ihren CodeCommit-Repositorys konfigurieren.

Um einen IAM-Benutzer für den Zugriff zu erstellen und zu konfigurierenCodeCommit

1. Erstellen Sie ein Amazon Web Services-Konto, indem Sie zuhttp://aws.amazon.comund wählenMelde dich an.

2. Erstellen Sie einen IAM-Benutzer oder verwenden Sie einen vorhandenen in Ihrem Amazon Web Services-Konto. 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 unterEinen IAM-Benutzer in Ihrem Amazon Web Services-Konto erstellen.

   Anmerkung

   CodeCommit erfordert AWS Key Management Service Wenn Sie einen bestehenden IAM-Benutzer verwenden, stellen Sie sicher, dass dem Benutzer keine Richtlinien zugeordnet sind, die das ausdrücklich verbietenAWS KMSAktionen erforderlich vonCodeCommit. Weitere Informationen finden Sie unter AWS KMS und 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 in der IAM-Konsole im NavigationsbereichBenutzer, und wählen Sie dann den IAM-Benutzer aus, für den Sie konfigurieren möchtenCodeCommitZugriff.

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 in der Richtlinienliste den Eintrag AWSCodeCommitPowerUser oder eine andere verwaltete Richtlinie für den CodeCommit-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 SieWeiter: Überprüfenum 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 über die verwalteten Richtlinien von CodeCommit und die Freigabe von Repositorys für andere Gruppen und Benutzer finden Sie unter Teilen Sie ein Repository und Authentifizierung 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 das Arbeiten mit CodeCommit über die Befehlszeile. Wir empfehlen die InstallationAWS CLIVersion 2. Es ist die neueste Hauptversion vonAWS CLIund unterstützt die neuesten Funktionen. Es ist die einzige Version vonAWS CLIdas unterstützt die Verwendung eines Root-Kontos, Verbundzugriffs oder temporärer Anmeldeinformationen mitgit-remote-codecommit.

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

   Anmerkung

   CodeCommitfunktioniert nur mitAWS CLIVersionen 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, obCodeCommitBefehle für denAWS CLIsind installiert.

   aws codecommit help

   Dieser Befehl gibt eine Liste vonCodeCommitBefehle.

3. Konfigurieren Sie dieAWS CLImit einem Profil unter Verwendung desconfigureBefehl, wie folgt:.

   aws configure

   Wenn Sie dazu aufgefordert werden, geben Sie denAWSZugriffsschlüssel undAWSgeheimer Zugriffsschlüssel des IAM-Benutzers, mit dem verwendet werden sollCodeCommit. Stellen Sie außerdem sicher, dass Sie Folgendes angebenAWS-Regionwo das Repository existiert, z. B.us-east-2. 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:

   • Benannte Profile

   • Verwenden einer IAM-Rolle in derAWS CLI

   • Befehl „Set“

   • Verbindung zu AWS CodeCommit Repositorys mit rotierenden Anmeldeinformationen herstellen

   Um eine Verbindung zu einem Repository oder einer Ressource in einem anderen herzustellenAWS-Region, müssen Sie das neu konfigurierenAWS CLImit dem Standardnamen der Region. Zu den Standardregionsnamen für CodeCommit zählen:

   • 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

   • il-central-1

   Weitere Informationen zu CodeCommit und AWS-Region finden Sie unter Regionen und Git-Verbindungsendpunkte. Weitere Informationen zu IAM, Zugriffsschlüsseln und geheimen Schlüsseln finden Sie unterWie erhalte ich Zugangsdaten?undVerwaltung 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 zu arbeiten inCodeCommitRepositorys müssen Sie Git auf Ihrem lokalen Computer installieren. CodeCommit unterstützt die Git-Versionen 1.7.9 und höher. Git Version 2.28 unterstützt die Konfiguration des Branchnamens für anfängliche Commits. Wir empfehlen die Verwendung einer aktuellen Version von Git.

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

• Wenn Sie während desAnpassung Ihrer PATH-UmgebungSchritt, wählen Sie die Option zur Verwendung von Git von der Befehlszeile aus.

• (Optional) Wenn Sie beabsichtigen, HTTPS mit dem Credential Helper zu verwenden, der imAWS CLIanstatt Git-Anmeldeinformationen zu konfigurieren fürCodeCommit, auf demKonfiguration zusätzlicher OptionenSeite, stellen Sie sicher, dassAktivieren Sie Git Credential ManagerOption ist gelöscht. Der Git Credential Manager ist nur kompatibel mitCodeCommitwenn IAM-Benutzer Git-Anmeldeinformationen konfigurieren. Weitere Informationen erhalten Sie unter Für HTTPS-Benutzer, die Git-Anmeldeinformationen verwenden und Git für Windows: Ich habe Git für Windows installiert, aber mir wird der Zugriff auf mein Repository verweigert (403).

Anmerkung

Git ist eine sich entwickelnde, regelmäßig aktualisierte Plattform. Es kommt vor, dass sich die Änderung eines Features darauf auswirkt, wie Git mit CodeCommit zusammen funktioniert. Wenn Sie Probleme mit einer bestimmten Version von Git und CodeCommit haben, lesen Sie die Informationen in Fehlerbehebung.

Schritt 3: Richten Sie den Credential Helper ein

Die AWS CLI enthält ein Git-Hilfsprogramm für Anmeldeinformationen, das mit CodeCommit verwendet werden kann. Der Git Credential Helper benötigt eineAWS Anmeldeinformationsprofil, in dem eine Kopie des Profils eines IAM-Benutzers gespeichert wirdAWSZugriffsschlüssel-ID undAWSgeheimer Zugriffsschlüssel (zusammen mit einem Standardschlüssel)AWS-RegionName und Standardausgabeformat). Der Git Credential Helper verwendet diese Informationen, um sich automatisch zu authentifizieren mitCodeCommitSie müssen diese Informationen also nicht jedes Mal eingeben, wenn Sie Git für die Interaktion mitCodeCommit.

1. Öffne eine Eingabeaufforderung und verwende Git zum Ausführengit config, spezifiziert die Verwendung des Git Credential Helper mit demAWSCredential-Profil, das es dem Git Credential Helper ermöglicht, den Pfad an Repositorys zu senden:

   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 den StandardAWSProfil oder die Amazon 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. Sofern Sie das Git Credential Manager-Dienstprogramm und CodeCommit verwenden möchten, sind weitere Konfigurationsschritte erforderlich. Beispielsweise müssen Sie die .gitconfig-Datei manuell ändern und angeben, dass bei einer Verbindungserstellung zu AWS CodeCommit das CodeCommit-Hilfsprogramm für Anmeldeinformationen verwendet werden soll. 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 fürCodeCommit, sollten Sie Folgendes angeben git config --localstattgit config --global, und führe die Konfiguration für jeden ausAWSProfil mit Anmeldeinformationen.

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: Stellen Sie eine Verbindung mit dem herCodeCommitkonsole und klone 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.

So stellen Sie eine Verbindung mit einem CodeCommit-Repository her

1. Öffne dasCodeCommitKonsole beihttps://console.aws.amazon.com/codesuite/codecommit/home.

2. Wählen Sie in der Regionsauswahl dieAWS-Regionwo das Repository erstellt wurde. Repositorien 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 mit Ihrem IAM-Benutzer oder den Credential Helper verwenden, der im Lieferumfang vonAWS 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 sehenWillkommenSeite statt einer Liste von Repositorien, es gibt keine Repositorys, die mit Ihrem verknüpft sindAWSKonto imAWS-Regionwo Sie angemeldet sind. Informationen zur Erstellung eines Repositorys finden Sie unter Erstellen Sie ein Repository AWS CodeCommit, oder befolgen Sie die Schritte im Tutorial Erste Schritte mit Git und CodeCommit.

4. Öffnen Sie eine Eingabeaufforderung und führen Sie dengit cloneBefehl mit der HTTPS-URL, die Sie kopiert haben. Dadurch wird das lokale Repository in einem Unterverzeichnis des Verzeichnisses erstellt, in dem Sie den Befehl ausgeführt haben. Zum Beispiel, um ein Repository mit dem Namen zu klonenMyDemoRepozu einem lokalen Repo mit dem Namenmy-demo-repoin der Region USA Ost (Ohio):

   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 inErste Schritte mit CodeCommit um mit der Nutzung zu beginnenCodeCommit.