Einrichtungsschritte für HTTPS-VerbindungenAWS CodeCommit-Repositories unter Windows mit demAWS CLIHilfsprogramm für Anmeldeinformationen - 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 HTTPS-VerbindungenAWS CodeCommit-Repositories unter Windows mit demAWS CLIHilfsprogramm 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 zu CodeCommit herstellen möchten, können Sie den Hilfsprogramm für Anmeldeinformationen verwenden, der in derAWS CLI.

Anmerkung

Obwohl das Hilfsprogramm für Anmeldeinformationen eine unterstützte Methode für die Verbindung zu CodeCommit über den Verbundzugriff, über einen Identitätsanbieter oder mit temporären Anmeldeinformationen ist, empfiehlt sich die Installation und Verwendung dergit-remote-codecommit-Dienstprogramm. Weitere Informationen finden Sie unter Installationsschritte für HTTPS-VerbindungenAWS CodeCommitMit git-remote-codecommit.

In diesem Thema werden Sie durch die Schritte zum Installieren derAWS CLI, richten Sie Ihren Computer ein undAWSStellen Sie eine Verbindung zu einem CodeCommit -Repository her und klonen Sie dieses Repository auf Ihrem Computer — also ein lokales Repository erstellen. 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

Führen Sie die folgenden Schritte aus, um ein Amazon Web Services Konto einzurichten, einen IAM-Benutzer zu erstellen und zu konfigurieren und die zu installieren.AWS CLI. DieAWS CLIDie enthält ein Hilfsprogramm für Anmeldeinformationen, das Sie für HTTPS-Verbindungen zu Ihren CodeCommit -Repositorys konfigurieren.

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

  1. Erstellen Sie ein Amazon Web Services Konto, indem Siehttp://aws.amazon.comund wählenRegistrieren.

  2. Erstellen Sie einen IAM-Benutzer oder verwenden Sie einen vorhandenen Benutzer in Ihrem Amazon Web Services Konto. Stellen Sie sicher, dass Sie über eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel verfügen, die mit diesem IAM-Benutzer verknüpft sind. Weitere Informationen finden Sie unterErstellen eines IAM-Benutzers in Ihrem Amazon Web Services Konto.

    Anmerkung

    CodeCommitAWS Key Management Service. Wenn Sie einen vorhandenen IAM-Benutzer verwenden, stellen Sie sicher, dass dem -Benutzer keine Richtlinien zugeordnet sind, die ausdrücklich dieAWS KMSAktionen, die von CodeCommit erforderlich sind. Weitere Informationen finden Sie unter AWS KMSund Verschlüsselung.

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

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

  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 Liste der RichtlinienAWScodeCommitPowerUseroder eine andere verwaltete Richtlinie für den CodeCommit -Zugriff. Weitere Informationen finden Sie unter AWSVon AWS verwaltete (vordefinierte) Richtlinien für CodeCommit.

    Nachdem Sie die Richtlinie zugewiesen haben, wählen SieWeiter: PrüfenKlicken Sie auf, um die Liste der Richtlinien anzuzeigen, um den IAM-Benutzer zuzuweisen. 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 unterTeilen eines RepositorysundAuthentifizierung 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 über die Befehlszeile. Wir empfehlen Ihnen,AWS CLIVersion 2. Es ist die neueste Hauptversion derAWS CLIunterstützt alle aktuellen Funktionen. Es ist die einzige Version derAWS CLIDas unterstützt die Verwendung eines Root-Kontos, Verbundzugriff oder temporären Anmeldeinformationen mitgit-remote-codecommit.

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

    Anmerkung

    CodeCommit funktioniert 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, ob die CodeCommit -Befehle für dieAWS CLIinstalliert sind.

    aws codecommit help

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

  3. Konfigurieren derAWS CLImit einem Profil mithilfe derconfigure-Befehl wie folgt:.

    aws configure

    Geben Sie nach Aufforderung dieAWSZugriffsschlüssel undAWSGeheimer Zugriffsschlüssel des IAM-Benutzers, der mit CodeCommit verwendet werden soll. Stellen Sie außerdem sicher, dass Sie die AWS-Region , in dem sich das Repository befindet, z. Bus-east-2. Wenn Sie nach dem standardmäßigen Ausgabeformat gefragt werden, geben Sie json an. Zum Beispiel:

    AWS Access Key ID [None]: Type your target AWS access key ID here, and then press Enter AWS Secret Access Key [None]: Type your target 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:

    So stellen Sie eine Verbindung mit einem Repository oder einer -Ressource in einem anderen AWS-Region , müssen Sie dieAWS CLImit dem Standardregionsnamen. 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

    • eu-central-1

    • ap-northeast-2

    • sa-east-1

    • us-west-1

    • eu-west-2

    • 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

    Weitere Informationen zu CodeCommit und AWS-Region finden Sie unterRegionen und Git-Verbindungsendpunkte. Weitere Informationen über IAM, Zugriffsschlüssel und geheime Schlüssel finden Sie unterWie erhalte ich Anmeldeinformationsdaten?undVerwalten der Zugriffsschlüssel für IAM-Benutzer. Weitere Informationen zur AWS CLI und zu Profilen finden Sie unter Benannte Profile.

Schritt 2: Installieren Sie Git

Um mit Dateien, Commits und anderen Informationen in CodeCommit -Repositories zu arbeiten, 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 Zweignamens 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 Sie diesen Link verwenden, um Git zu installieren, können Sie alle Standardeinstellungen der Installation mit Ausnahme der folgenden akzeptieren:

Anmerkung

Git ist eine stetig weiterentwickelte und 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 inFehlersuche.

Schritt 3: Einrichten des Assistenten für Anmeldeinformationen

DieAWS CLIDie enthält ein Git-Hilfsprogramm für Anmeldeinformationen, das mit CodeCommit verwendet werden kann. Der Git-Anmeldeinformationshelfer erfordert eineAWS Anmeldeinformationsprofil, in dem eine Kopie derAWSZugriffsschlüssel-IDAWSgeheimer Zugriffsschlüssel (zusammen mit einem standardmäßigen AWS-Region -Namen und Standard-Ausgabeformat). Das Git-Hilfsprogramm für Anmeldeinformationen verwendet diese Informationen für die automatische Authentifizierung bei CodeCommit, sodass Sie diese Daten nicht jedes Mal erneut eingeben müssen, wenn Sie Git für die Interaktion mit CodeCommit nutzen.

  1. Öffnen Sie eine Eingabeaufforderung und verwenden Sie Gitgit config, indem Sie die Verwendung des Git-Anmeldeinformationshelfers mit derAWS-Anmeldeinformationsprofil verwenden, damit das Git-Hilfsprogramm für Anmeldeinformationen den Pfad an die 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.

    • Das Hilfsprogramm für Anmeldeinformationen verwendet die standardmäßigeAWS-Profil oder die Amazon EC2 Instance-Rolle. Wenn Sie eineAWSAnmeldeinformationsprofil, das verwendet werden soll, z. B.CodeCommitProfileWählen Sie den Befehl folgendermaßen aus, 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-Anmeldeinformationsmanager erneut installieren, da das Dienstprogramm mit CodeCommit nicht kompatibel ist. Wenn Sie das Git-Hilfsprogramm für Anmeldeinformationen und verwenden möchten, sind weitere Konfigurationsschritte erforderlich. Hierzu zählen u. a. CodeCommit manuelle Ändern der .gitconfig-Datei für die Angabe der Verwendung des Hilfsprogramms für Anmeldeinformationen erforderlich.AWS CodeCommit, wenn Sie eine Verbindung mit CodeCommit herstellen. 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 CodeCommit verwenden möchten, geben Sie git config --localanstelle vongit config --global, und führen Sie die Konfiguration für jedenAWSAnmeldeinformationsprofil.

  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 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

  1. Öffnen Sie die CodeCommit -Konsole unterhttps://console.aws.amazon.com/codesuite/codecommit/home.

  2. Wählen Sie in der Regionsauswahl die AWS-Region , in dem das Repository erstellt wurde. -Repositorys sind spezifisch für eine 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 Git-Anmeldeinformationen mit Ihrem IAM-Benutzer oder das in enthaltene Hilfsprogramm für Anmeldeinformationen 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 öffentliches/privates SSHkey pair mit Ihrem IAM-Benutzer verwenden.

    Anmerkung

    Wenn Sie eineWillkommen-Seite anstelle einer Liste mit Repositorys verwenden, sind keine Repositorys mit IhrerAWS-Konto in AWS-Region , in der Sie angemeldet sind. Informationen zur Erstellung eines Repositorys finden Sie unter Erstellen einesAWS CodeCommitRepository hoch, oder befolgen Sie die Schritte im Tutorial Erste Schritte mit Git und CodeCommit.

  4. Öffnen Sie eine Eingabeaufforderung und führen Sie die aus.git clone-Befehl mit der kopierten HTTPS-URL. Dadurch wird das lokale Repository in einem Unterverzeichnis des Verzeichnisses erstellt, in dem Sie den Befehl ausgeführt haben. Beispielsweise löschen Sie das Repository namensMyDemoRepozu einem lokalen Repo namensmy-demo-repoRegion 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. Führen Sie die Schritte unterErste Schritte mit CodeCommit , um mit der Verwendung von CodeCommit zu beginnen.