Einrichtungsschritte für HTTPS-Verbindungen zu AWS CodeCommit Repositorys unter Windows mit dem AWS CLI Credential Helper

Bevor Sie AWS CodeCommit zum ersten Mal eine Verbindung herstellen können, müssen Sie die Schritte zur Erstkonfiguration abschließen. 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 CodeCommit über ein Root-Konto, Verbundzugriff oder temporäre Anmeldeinformationen eine Verbindung herstellen möchten, können Sie den Credential Helper verwenden, der in der enthalten ist. AWS CLI

Anmerkung

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

In diesem Thema erfahren Sie, wie Sie das installieren AWS CLI, Ihren Computer und Ihr AWS 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

Gehen Sie wie folgt vor, um ein Amazon Web Services Services-Konto einzurichten, einen IAM-Benutzer zu erstellen und zu konfigurieren und den AWS CLI zu installieren. Das AWS CLI beinhaltet einen Credential Helper, den Sie für HTTPS-Verbindungen zu Ihren CodeCommit Repositorys konfigurieren.

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

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

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

   Anmerkung

   CodeCommit erfordert AWS 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 CodeCommit erforderlichen AWS KMS Aktionen verweigern. Weitere Informationen finden Sie unter AWS KMS und Verschlüsselung.

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

4. Wählen Sie in der IAM-Konsole im Navigationsbereich 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 AWSCodeCommitPowerUseraus 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 aus, 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 Teilen Sie ein Repository und. Authentifizierung und Zugriffskontrolle für AWS CodeCommit

Um das zu installieren und zu konfigurieren AWS CLI

1. Laden Sie auf Ihrem lokalen Computer das herunter und installieren Sie es AWS CLI. Dies ist eine Voraussetzung für die Interaktion mit CodeCommit über die Befehlszeile. Wir empfehlen, AWS CLI Version 2 zu installieren. Es ist die neueste Hauptversion von AWS CLI und unterstützt alle aktuellen Funktionen. Es ist die einzige Version von AWS CLI , die die Verwendung eines Root-Kontos, Verbundzugriff oder temporärer Anmeldeinformationen mit git-remote-codecommit unterstützt.

   Weitere Informationen finden Sie unter Einrichtung der AWS Befehlszeilenschnittstelle.

   Anmerkung

   CodeCommit funktioniert nur mit den AWS CLI Versionen 1.7.38 und höher. Es hat sich bewährt, die neueste verfügbare Version zu installieren oder AWS CLI auf sie zu aktualisieren. Führen AWS CLI Sie den aws --version Befehl aus, um festzustellen, welche Version von Sie installiert haben.

   Informationen zum Upgrade einer älteren Version von AWS CLI auf die neueste Version finden Sie unter Installation von AWS Command Line Interface.

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

   aws codecommit help

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

3. Konfigurieren Sie das AWS CLI mit einem Profil, indem Sie den configure Befehl wie folgt verwenden:.

   aws configure

   Wenn Sie dazu aufgefordert werden, geben Sie den AWS Zugriffsschlüssel und den AWS geheimen Zugriffsschlüssel des IAM-Benutzers an, mit CodeCommit dem Sie ihn verwenden möchten. Stellen Sie außerdem sicher, dass Sie angeben, AWS-Region wo sich das Repository befindet, 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 zur Verwendung mit dem AWS CLI finden Sie im Folgenden:

   • Benannte Profile

   • Verwenden einer IAM-Rolle in der AWS CLI

   • Befehl „Set“

   • Verbindung zu AWS CodeCommit Repositorys mit rotierenden Anmeldeinformationen herstellen

   Um eine Verbindung zu einem Repository oder einer Ressource in einem anderen Repository herzustellen AWS-Region, müssen Sie das AWS CLI mit dem Standardregionsnamen neu konfigurieren. Zu den unterstützten Standardregionsnamen für 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

   • il-central-1

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

Schritt 2: Installieren von Git

Um mit Dateien, Commits und anderen Informationen in CodeCommit Repositorys zu arbeiten, müssen Sie Git auf Ihrem 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 anfängliche 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:

• Wenn Sie während des Schritts Anpassen Ihrer PATH-Umgebung dazu aufgefordert werden, wählen Sie in der Befehlszeile die Option, Git zu verwenden.

• (Optional) Wenn Sie beabsichtigen, HTTPS mit dem Credential Helper zu verwenden, der in AWS CLI statt der Konfiguration von Git-Anmeldeinformationen für enthalten ist CodeCommit, auf der Seite Zusätzliche Optionen konfigurieren, stellen Sie sicher, dass die Option Git Credential Manager aktivieren deaktiviert ist. Der Git Credential Manager ist nur kompatibel, CodeCommit wenn 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. Gelegentlich kann sich eine Änderung der Funktionen auf die Art und Weise auswirken, mit der es funktioniert CodeCommit. Wenn Sie Probleme mit einer bestimmten Version von Git und haben CodeCommit, lesen Sie die Informationen unterFehlerbehebung.

Schritt 3: Richten Sie den Credential Helper ein

Das AWS CLI beinhaltet einen Git-Helfer für Anmeldeinformationen, mit dem CodeCommit Sie ihn verwenden können. Der Git Credential Helper benötigt ein AWS Anmeldeinformationsprofil, das eine Kopie der AWS Zugriffsschlüssel-ID und des AWS geheimen Zugriffsschlüssels eines IAM-Benutzers (zusammen mit einem AWS-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 verwenden. CodeCommit

1. Öffnen Sie eine Befehlszeile und verwenden Sie Git zum Ausführengit config. Geben Sie dabei die Verwendung des Git Credential Helper mit dem AWS Credential Profile an, wodurch der Git Credential Helper den Pfad an 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 das AWS Standardprofil oder die EC2 Amazon-Instance-Rolle. Wenn Sie ein zu verwendendes AWS Anmeldeinformationsprofil erstellt haben, können Sie den Befehl wie folgt ändernCodeCommitProfile, um ihn stattdessen zu verwenden:

     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-Hilfsprogramm behalten möchten, müssen Sie zusätzliche Konfigurationsschritte ausführen, um es ebenfalls zu verwenden. Dazu gehört auch das manuelle Ändern der Datei .gitconfig CodeCommit, um anzugeben, ob der Credential Helper für AWS CodeCommit die Verbindung zu 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 für verwenden möchten CodeCommit, sollten Sie git config --local anstelle von git config --global die Konfiguration für jedes Anmeldeinformationsprofil angeben und die Konfiguration ausführen. AWS

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 zur CodeCommit Konsole her und klonen Sie das Repository

Wenn Ihnen bereits ein Administrator den Namen und die Verbindungsdetails für das CodeCommit Repository gesendet hat, 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 ein. 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 Credential Helper verwenden, der im Lieferumfang von enthalten ist. 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 öffentliches/privates SSH-Schlüsselpaar mit Ihrem IAM-Benutzer verwenden.

   Anmerkung

   Wenn Sie statt einer Liste von Repositorys eine Willkommensseite sehen, sind in dem Land, in dem Sie angemeldet sind, keine Repositorys mit Ihrem AWS Konto verknüpft. AWS-Region 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 Befehlszeile und führen Sie den git clone Befehl mit der 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 MyDemoRepo eines lokalen Repositorys mit dem Namen my-demo-repo in der Region USA Ost (Ohio) zu klonen:

   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 Anweisungen unter, um mit der Verwendung Erste Schritte mit CodeCommit CodeCommit zu beginnen.