Einrichtungsschritte für HTTPS-Verbindungen zuAWS CodeCommit mit git-remote-codecommit

Wenn Sie eine Verbindung CodeCommit mit einem Root-Konto, einem Verbundzugriff oder temporären Anmeldeinformationen herstellen möchten, sollten Sie den Zugriff über einrichtengit-remote-codecommit. Dieses Tool bietet eine einfache Methode zum Pushen und Abrufen von Code aus CodeCommit Repositorys, indem es Git erweitert. Dies ist die empfohlene Methode zur Unterstützung von Verbindungen, die mit Verbundzugriff, Identitätsanbietern und temporären Anmeldeinformationen hergestellt wurden. Um einer Verbundidentitä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 (successor to AWS Single Sign-On)-Benutzerhandbuch.

Sie können es auchgit-remote-codecommit mit einem IAM-Benutzer verwenden. 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 werden unter der Annahme geschrieben, dass Sie über ein Amazon Web Services Services-Konto verfügen, mindestens ein Repository erstellt haben und einen IAM-Benutzer mit einer verwalteten Richtlinie verwenden CodeCommit, wenn Sie eine Verbindung zu CodeCommit Repositorys herstellen. Informationen zum Konfigurieren des Zugriffs für verbundener Benutzer und andere rotierende Anmeldeinformationstypen finden Sie unter Verbinden mitAWS CodeCommitRepositorys mit rotierenden Anmeldeinformationen.

Schritt 0: Installieren Sie die Voraussetzungen für git-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 in CodeCommit Repositorys zu arbeiten, musst du Git auf deinem 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 erste Commits. Wir empfehlen die Verwendung einer aktuellen Version von Git.

Um Git zu installieren, empfehlen wir Websites wie Git Downloads.

Anmerkung

Git ist eine sich entwickelnde, regelmäßig aktualisierte Plattform. Gelegentlich kann sich eine Änderung der Funktion auf die Funktionsweise auswirken CodeCommit. Wenn du Probleme mit einer bestimmten Version von Git und hast CodeCommit, lies dir die Informationen unter durchFehlerbehebung.

Schritt 1: Erstkonfiguration für CodeCommit

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.

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

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

2. Erstellen Sie einen IAM-Benutzer in Ihrem Amazon Web Services Services-Konto, oder verwenden Sie einen vorhandenen. Vergewissern Sie sich, dass Sie eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel haben, die mit diesem IAM-Benutzer verknüpft sind. Weitere Informationen finden Sie unter Erstellen eines IAM-Benutzers in Ihrem Amazon Web Services Services-Konto.

   Anmerkung

   CodeCommit erfordertAWS 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 gefordertenAWS KMS Aktionen verweigern CodeCommit. 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-Konsole und anschließend 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 aus der Liste der Richtlinien eine AWSCodeCommitPowerUseroder eine andere verwaltete Richtlinie für den CodeCommit Zugriff aus. Weitere Informationen finden Sie unter AWS Von verwaltete Richtlinien für CodeCommit.

   Nachdem Sie die Richtlinie ausgewählt haben, die Sie anhängen möchten, klicken Sie auf Weiter: Überprüfen, 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 zum Teilen des Zugriffs auf Repositorys mit anderen Gruppen und Benutzern finden Sie unterEin Repository teilen undAuthentifizierung 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 der Befehlszeile. Es wird empfohlen,AWS CLI Version 2 zu installieren. Es ist die neueste Hauptversion derAWS CLI und unterstützt alle aktuellen Funktionen. Es ist die einzige Version vonAWS CLI, die die Verwendung eines Root-Kontos, eines Verbundzugriffs oder temporärer Anmeldeinformationen unterstütztgit-remote-codecommit.

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

   Anmerkung

   CodeCommit funktioniert nur mitAWS CLI Versionen 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 den Befehl aus, um zu überprüfen, ob die CodeCommit Befehle fürAWS CLI die.

   aws codecommit help

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

3. Konfigurieren Sie dasAWS CLI mit einem Profil, indem Sie den folgendenconfigure Befehl verwenden:.

   aws configure

   Wenn Sie dazu aufgefordert werden, geben Sie denAWS Zugriffsschlüssel und denAWS geheimen Zugriffsschlüssel des IAM-Benutzers an, mit dem Sie verwendet CodeCommit werden möchten. Stellen Sie außerdem sicher, dass Sie angeben,AWS-Region wo sich das Repository befindet, z.us-east-2 B. 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“

   • Verbinden mitAWS CodeCommitRepositorys mit rotierenden Anmeldeinformationen

   Um eine Verbindung zu einem Repository oder einer Ressource in einem anderen Repository herzustellenAWS-Region, müssen Sie dasAWS CLI mit dem standardmäßigen Regionsnamen neu konfigurieren. Zu den unterstützten Standard-Regionsnamen 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

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

Schritt 2: Installieren git-remote-codecommit

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

Zur Installation 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 Berechtigungen wie sudo ausführen oder 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 mit Linux, macOS oder Unix:

   sudo pip install git-remote-codecommit

   Auf einem Computer, auf dem Windows ausgeführt wird:

   pip install --user git-remote-codecommit

2. Überwachen Sie den Installationsvorgang, bis Sie eine Erfolgsmeldung sehen.

Schritt 3: Connect mit der CodeCommit Konsole und Klonen des Repositorys

Wenn Ihnen ein Administrator bereits die Klon-URL zur Verwendunggit-remote-codecommit für das CodeCommit Repository gesendet hat, können Sie die Verbindung zur Konsole ü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 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 für Ihren IAM-Benutzer oder den in der enthaltenen Anmeldeinformationshelfer verwendenAWS 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 Willkommensseite statt einer Liste von Repositorys sehen, sind IhremAWS Konto in dem, inAWS-Region dem Sie angemeldet sind, keine Repositorys zugeordnet. Informationen zur Erstellung eines Repositorys finden Sie unter Erstellen Sie einAWS CodeCommit Repository, oder befolgen Sie die Schritte im Tutorial Erste mit Git und und CodeCommit.

4. Klonen Sie am Terminal oder an der Eingabeaufforderung das Repository mit dem git clone-Befehl. Verwenden Sie die kopierte git-remote-codecommit HTTPS-URL und den Namen desAWS CLI Profils, falls 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 klonen CodeCommitProfile:

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

   Um ein Repository in einem anderenAWS-Region als dem in Ihrem Profil konfigurierten zu klonen, geben Sie denAWS-Region Namen an. Beispiel:

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

Nächste Schritte

Sie haben die Voraussetzungen erfüllt. Folgen Sie den Schritten unterErste Schritte mit CodeCommit , um mit der Verwendung zu beginnen CodeCommit.

Wie Sie Ihren ersten Commit erstellen und pushen können, erfahren Sie unterErstellen Sie ein Commit inAWS CodeCommit. Wenn Sie mit Git noch nicht vertraut sind, finden Sie unter Wo kann ich mehr über Git erfahren? und Erste mit Git und undAWS CodeCommit genauere Informationen.