Setup-Schritte für HTTPS-Verbindungen zuAWS CodeCommitRepositorys 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.

Setup-Schritte für HTTPS-Verbindungen zuAWS CodeCommitRepositorys 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 mit Git-Anmeldeinformationen 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 inAWS CLIaus.

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 desgit-remote-codecommitDienstprogramm. Weitere Informationen finden Sie unter Einrichten von Schritten für HTTPS-Verbindungen mitAWS CodeCommitmit git-remote-codecommit .

In diesem Thema werden Sie durch die Schritte zur Installation derAWS CLI, richten Sie Ihren Computer ein undAWS-Profil, stellen Sie eine Verbindung zu einem CodeCommit-Repository her und klonen Sie dieses Repository auf Ihrem Computer ein, 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 Services-Konto einzurichten, einen IAM-Benutzer zu erstellen und zu konfigurieren und dieAWS CLIaus. 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 Services-Konto, indem Sie aufhttp://aws.amazon.comund wählenRegistrierenaus.

  2. Erstellen eines IAM-Benutzers oder verwenden Sie einen vorhandenen -Benutzer 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 mit diesem IAM-Benutzer verknüpft sind Weitere Informationen finden Sie unterErstellen eines IAM-Benutzers in Ihrem Amazon Web Services Services-Kontoaus.

    Anmerkung

    CodeCommit benötigtAWS Key Management Serviceaus. Wenn Sie einen vorhandenen IAM-Benutzer verwenden, müssen Sie sicherstellen, dass dem -Benutzer keine Richtlinien zugeordnet sind, die ausdrücklich dieAWS KMSvon CodeCommit erforderliche Aktionen. 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-KonsoleBenutzerund wä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 CodeCommit-Zugriff. Weitere Informationen finden Sie unter AWSverwaltete Richtlinien für CodeCommit .

    Wenn Sie die Richtlinie zugewiesen haben, wählen SieWeiter: Prüfenum die Liste der Richtlinien anzuzeigen, die an den IAM-Benutzer angehängt werden. Ist die Liste korrekt, wählen Sie Add permissions aus.

    Weitere Informationen über die verwalteten Richtlinien von CodeCommit und die Freigabe des Zugriffs auf Repositorys mit anderen Gruppen und -Benutzern finden Sie unterFreigeben eines RepositoryundAuthentifizierung und Zugriffskontrolle für AWS CodeCommitaus.

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, zu installierenAWS CLIVersion 2. Es ist die neueste Hauptversion derAWS CLIund unterstützt alle aktuellen Funktionen. Es ist die einzige Version derAWS CLIDas unterstützt die Verwendung eines Root-Kontos, eines Verbundzugriffs oder temporären Anmeldeinformationen mitgit-remote-codecommitaus.

    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ürAWS CLIsind installiert.

    aws codecommit help

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

  3. Konfigurieren derAWS CLImit einem Profil unter Verwendung desconfigureBefehl wie folgt:.

    aws configure

    Geben Sie nach Aufforderung dieAWS-Zugriffsschlüssel undAWSgeheimer Zugriffsschlüssel des IAM-Benutzers für die Verwendung mit CodeCommit. Stellen Sie auch sicher, dass Sie dieAWS-Regionwo das Repository existiert, z. Bus-east-2aus. 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:

    So stellen Sie eine Verbindung mit einem Repository oder einer Ressource in einem anderen herAWS-Regionmüssen Sie dieAWS CLImit dem Standardregionsnamen. Zu den 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

    • 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

    • af-south-1

    Weitere Informationen zu CodeCommit undAWS-Region, finden Sie unterRegionen und Git-Verbindungsendpunkteaus. Weitere Informationen über IAM, Zugriffsschlüssel und geheime Schlüssel finden Sie unterWie erhalte ich Anmeldeinformationen?undVerwalten der Zugriffsschlüssel für IAM-Benutzeraus. 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-Repositorys arbeiten zu können, 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 das Konfigurieren des Zweignamens für erste Commits. Wir empfehlen die Verwendung einer aktuellen Version von Git.

Für die Installation von Git empfehlen wir Websites wieGit für Windowsaus. Wenn Sie diesen Link verwenden, um Git zu installieren, können Sie alle Standardeinstellungen für die Installation mit Ausnahme der folgenden akzeptieren:

Anmerkung

Git ist eine stetig weiterentwickelte und regelmäßig aktualisierte Plattform. Gelegentlich kann sich eine Änderung der Funktion auf die Funktionsweise mit CodeCommit auswirken. Wenn Probleme mit einer bestimmten Version von Git und CodeCommit auftreten, lesen Sie die Informationen inFehlerbehebungaus.

Schritt 3: Richten Sie den Helfer für Anmeldeinformationen ein

DieAWS CLIDie enthält ein Git-Hilfsprogramm für Anmeldeinformationen, das mit CodeCommit verwendet werden kann. Der Helfer für Git-Anmeldeinformationen benötigt eineAWS Anmeldeinformationsprofil, das eine Kopie eines IAM-Benutzers speichertAWSZugriffsschlüssel-ID undAWSgeheimer Zugriffsschlüssel (zusammen mit einem StandardAWS-RegionName und Standardausgabeformat). 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 führen Sie mit Git ausgit config, mit Angabe der Verwendung des Git-Anmeldeinformationen Helfer mit demAWS-Anmeldeinformationsprofil, 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.

    • Der Hilfsprogramm für Anmeldeinformationen verwendet den StandardwertAWS-Profil oder die Amazon EC2 EC2-Instance-Rolle. Wenn Sie eine erstellt habenAWSZu verwendende Anmeldeinformationen, wie z.CodeCommitProfilekönnen Sie den Befehl folgendermaßen ändern, 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 ist. Sofern Sie das Git Credential Manager-Dienstprogramm und verwenden möchten, sind weitere Konfigurationsschritte erforderlich CodeCommit So müssen Sie die .gitconfig-Datei manuell ändern und angeben, dass das Hilfsprogramm für Anmeldeinformationen fürAWS CodeCommitwenn 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, sollten Sie angeben git config --localanstelle vongit config --global, und führen Sie die Konfiguration für jeden ausAWSAnmeldeinformationsprofil.

  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 Sie sich mit der CodeCommit-Konsole 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 her

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

  2. Wählen Sie in der Regionenauswahl die Option ausAWS-Regionwo das Repository erstellt wurde. Die Repositorys sind spezifisch fürAWS-Regionaus. 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 den Hilfsprogramm für Anmeldeinformationen verwenden, der inAWS CLIaus.

    • 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 du eine siehstWillkommen-Seite anstelle einer Liste von Repositorys sind keine Repositorys mit Ihrem verknüpftAWSKonto imAWS-Regionwo Sie angemeldet sind. Informationen zur Erstellung eines Repositorys finden Sie unter Erstellen einesAWS CodeCommitEndlager, oder befolgen Sie die Schritte im Tutorial Erste Schritte mit Git und CodeCommit.

  4. Öffnen Sie eine Eingabeaufforderung und führen Siegit 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. Beispiel zum Klonen eines Repositorys namensMyDemoRepozu einem lokalen Repo namensmy-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. Führen Sie die Schritte unter ausErste Schritte mit CodeCommit um CodeCommit zu verwenden.