Einrichtungsschritte für HTTPS-Verbindungen zuAWS CodeCommitmitgit-remote-codecommit - 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-Verbindungen zuAWS CodeCommitmitgit-remote-codecommit

Wenn Sie mit einem Root-Konto, einem Verbundzugriff oder temporären Anmeldeinformationen eine Verbindung mit CodeCommit herstellen möchten, sollten Sie Zugriff mittels git-remote-codecommit einrichten. Dieses Dienstprogramm bietet eine einfache Methode zum Push- und Pull von Code aus CodeCommit-Repositorys durch die Erweiterung von Git. Dies ist die empfohlene Methode zur Unterstützung von Verbindungen, die mit Verbundzugriff, Identitätsanbietern und temporären Anmeldeinformationen hergestellt werden. Um einer föderierten Identität Berechtigungen zuzuweisen, erstellen Sie eine Rolle und definieren Berechtigungen für die Rolle. Wenn eine Verbundidentität authentifiziert wird, wird die Identität der Rolle zugeordnet und erhält die von der Rolle definierten Berechtigungen. Informationen zu Rollen für den Verbund finden Sie unter Erstellen von Rollen für externe Identitätsanbieter im IAM-Benutzerhandbuch. Wenn Sie IAM Identity Center verwenden, konfigurieren Sie einen Berechtigungssatz. Wenn Sie steuern möchten, worauf Ihre Identitäten nach der Authentifizierung zugreifen können, korreliert IAM Identity Center den Berechtigungssatz mit einer Rolle in IAM. Informationen zu Berechtigungssätzen finden Sie unter Berechtigungssätze im AWS IAM Identity Center-Benutzerhandbuch.

Sie können auch Folgendes verwendengit-remote-codecommitmit einem IAM-Benutzer. Im Gegensatz zu anderen HTTPS-Verbindungsmethoden erfordert git-remote-codecommit das Einrichten von Git-Anmeldeinformationen für den Benutzer nicht.

Anmerkung

Einige IDEs unterstützen das von git-remote-codecommit verwendete Klon-URL-Format nicht. Möglicherweise müssen Sie Repositorys manuell auf Ihren lokalen Computer klonen, bevor Sie mit ihnen in der bevorzugten IDE arbeiten können. Weitere Informationen finden Sie unter Fehlerbehebung bei git-remote-codecommit und AWS CodeCommit.

Diese Verfahren wurden unter der Annahme geschrieben, dass Sie ein Amazon Web Services-Konto haben und mindestens ein Repository erstellt haben inCodeCommit, und verwenden Sie einen IAM-Benutzer mit einer verwalteten Richtlinie, wenn Sie eine Verbindung zu herstellenCodeCommitRepositorien. Informationen zum Konfigurieren des Zugriffs für verbundener Benutzer und andere rotierende Anmeldeinformationstypen finden Sie unter Verbindung zuAWS CodeCommit Repositorys mit wechselnden Anmeldeinformationen herstellen.

Schritt 0: Installieren Sie die Voraussetzungen fürgit-remote-codecommit

Bevor Sie git-remote-codecommit verwenden können, müssen Sie einige Voraussetzungen auf Ihrem lokalen Computer installieren. Dazu zählen:

  • Python (Version 3 oder höher) und dessen Paketmanager „pip“, wenn sie nicht bereits installiert sind. Um die neueste Version von Python herunterzuladen und zu installieren, besuchen Sie die Python-Website.

  • Git

Anmerkung

Wenn Sie Python unter Windows installieren, stellen Sie sicher, dass Sie die Option auswählen, mit der sich Python zum Pfad hinzufügen lässt.

git-remote-codecommit benötigt pip Version 9.0.3 oder höher. Um Ihre pip-Version zu überprüfen, öffnen Sie ein Terminal oder eine Befehlszeile und führen Sie den folgenden Befehl aus:

pip --version

Sie können die folgenden beiden Befehle ausführen, um Ihre pip-Version auf die neueste Version zu aktualisieren:

curl -O https://bootstrap.pypa.io/get-pip.py python3 get-pip.py --user

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 lädt herunter.

Anmerkung

Git ist eine sich weiterentwickelnde, 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 1: Erstkonfiguration fürCodeCommit

Gehen Sie wie folgt vor, um einen IAM-Benutzer zu erstellen, ihn mit den entsprechenden Richtlinien zu konfigurieren, einen Zugriffsschlüssel und einen geheimen Schlüssel zu erhalten und den zu installieren und zu konfigurierenAWS CLI.

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 Von 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 Freigeben eines Repositorys 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, Verbundzugriff 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ürAWS 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 SieAWSZugriffsschlü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:

    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 Anmeldeinformationen?undVerwaltung von Zugriffsschlüsseln für IAM-Benutzer. Weitere Informationen zur AWS CLI und zu Profilen finden Sie unter Benannte Profile.

Schritt 2: Installierengit-remote-codecommit

Führen Sie zur Installation von git-remote-codecommit die folgenden Schritte aus.

So installieren Sie git-remote-codecommit
  1. Führen Sie am Terminal oder in der Befehlszeile den folgenden Befehl aus:

    pip install git-remote-codecommit
    Anmerkung

    Je nach Betriebssystem und Konfiguration müssen Sie diesen Befehl möglicherweise mit erhöhten Rechten ausführen, z. B. mit sudo, oder Sie müssen den Parameter --user verwenden, um in einem Verzeichnis zu installieren, für das keine besonderen Rechte erforderlich sind, wie z. B. Ihr aktuelles Benutzerkonto. Zum Beispiel auf einem Computer, auf dem Linux, macOS oder Unix ausgeführt wird:

    sudo pip install git-remote-codecommit

    Auf einem Computer mit Windows:

    pip install --user git-remote-codecommit
  2. Überwachen Sie den Installationsvorgang, bis Sie eine Erfolgsmeldung sehen.

Schritt 3: Stellen Sie eine Verbindung zum herCodeCommitkonsole und klone das Repository

Wenn Ihnen ein Administrator bereits die Klon-URL zur Verwendung mit git-remote-codecommit für das CodeCommit-Repository gesendet hat, können Sie die Verbindung zur Konsole ü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 RegionsauswahlAWS-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 eines AWS CodeCommit-Repositorys, oder befolgen Sie die Schritte im Tutorial Erste Schritte mit Git und CodeCommit.

  4. Klonen Sie am Terminal oder an der Eingabeaufforderung das Repository mit dem git clone-Befehl. Verwenden Sie das HTTPSgit-remote-codecommitDie URL, die Sie kopiert haben, und der Name desAWS CLIProfil, wenn Sie ein benanntes Profil erstellt haben. Wenn Sie kein Profil angeben, nimmt der Befehl das Standardprofil an. Dadurch wird das lokale Repository in einem Unterverzeichnis des Verzeichnisses erstellt, in dem Sie den Befehl ausgeführt haben. Im folgenden Beispiel wird ein Repository mit dem Namen MyDemoRepo in ein lokales Repository mit dem Namen my-demo-repo geklont:

    git clone codecommit://MyDemoRepo my-demo-repo

    Um dasselbe Repository mit einem Profil namens zu klonenCodeCommitProfile:

    git clone codecommit://CodeCommitProfile@MyDemoRepo my-demo-repo

    Um ein Repository in einem anderen zu klonenAWS-Regionals das in Ihrem Profil konfigurierte, fügen Sie das hinzuAWS-RegionName. Beispiele:

    git clone codecommit::ap-northeast-1://MyDemoRepo my-demo-repo

Nächste Schritte

Sie haben die Voraussetzungen erfüllt. Folgen Sie den Schritten inErste Schritte mit CodeCommit um mit der Nutzung zu beginnenCodeCommit.

Wie du deinen ersten Commit erstellst und pushst, erfährst du unterErstellen eines Commit in AWS CodeCommit. Wenn Sie mit Git noch nicht vertraut sind, finden Sie unter Wo kann ich mehr über Git erfahren? und Erste Schritte mit Git und AWS CodeCommit genauere Informationen.