View a markdown version of this page

Einrichtungsschritte für HTTPS-Verbindungen zu AWS CodeCommit mit git-remote-codecommit - AWS CodeCommit
Schritt 0: Installieren Sie die Voraussetzungen für git-remote-codecommitSchritt 1: Erstkonfiguration für CodeCommitSchritt 2: git-remote-codecommit installierenSchritt 3: Stellen Sie eine Verbindung zur CodeCommit Konsole her und klonen Sie das RepositoryNächste Schritte

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 zu AWS CodeCommit mit git-remote-codecommit

Wenn Sie eine Verbindung CodeCommit mit einem Root-Konto, Verbundzugriff oder temporären Anmeldeinformationen herstellen möchten, sollten Sie den Zugriff mithilfe von git-remote-codecommit einrichten. Dieses Tool bietet eine einfache Methode zum Push und Abrufen von Code aus CodeCommit Repositorys, indem Git erweitert wird. Es 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 die Berechtigungen für die Rolle. Wird eine Verbundidentität authentifiziert, so 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 (Verbund) 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 es auch git-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 wurden unter der Annahme geschrieben, dass Sie ein Amazon Web Services-Konto haben, mindestens ein Repository in 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 Verbindung herstellen mit AWS CodeCommit Repositorys mit wechselnden 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:

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 die Git-Versionen 1.7.9 und höher. Git Version 2.28 unterstützt die Konfiguration des Branch-Namens 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 Funktionsänderung auf die Art und Weise auswirken, wie sie funktioniert CodeCommit. Wenn du Probleme mit einer bestimmten Version von Git und hast CodeCommit, sieh dir die Informationen unter anFehlerbehebung.

Schritt 1: Erstkonfiguration für CodeCommit

Folgen Sie diesen Schritten, 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 AWS CLI zu installieren und zu konfigurieren.

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

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

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

    Anmerkung

    CodeCommit benötigt AWS Key Management Service. Wenn Sie einen vorhandenen IAM-Benutzer verwenden, stellen Sie sicher, dass dem Benutzer keine Richtlinien zugeordnet sind, die die von CodeCommit erforderlichen AWS KMS Aktionen ausdrücklich verweigern. Weitere Informationen finden Sie unter AWS KMS und Verschlüsselung.

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

  4. Wählen Sie in der IAM-Konsole im Navigationsbereich die Option 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 AWSCodeCommitPowerUser aus 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, 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 Ein Repository teilen 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 CodeCommit von der Befehlszeile aus. Wir empfehlen, AWS CLI Version 2 zu installieren. Es ist die neueste Hauptversion von AWS CLI und unterstützt die neuesten Funktionen. Es ist die einzige Version von AWS CLI , die die Verwendung eines Root-Kontos, Verbundzugriff oder temporäre Anmeldeinformationen mit git-remote-codecommit unterstützt.

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

    Anmerkung

    CodeCommit funktioniert nur mit den AWS CLI Versionen 1.7.38 und höher. Als bewährte Methode empfiehlt es sich, die Version zu installieren oder auf die neueste verfügbare Version AWS CLI 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 folgenden configure Befehl 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 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 zur Verwendung mit dem AWS CLI finden Sie im Folgenden:

    Um eine Verbindung zu einem Repository oder einer Ressource in einem anderen herzustellen AWS-Region, müssen Sie das AWS CLI mit dem Standardregionsnamen neu konfigurieren. Zu den unterstützten Standardregionsnamen 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 Verwaltung von Zugriffsschlüsseln für IAM-Benutzer. Weitere Informationen zu den Profilen AWS CLI und finden Sie unter Benannte Profile.

Schritt 2: git-remote-codecommit installieren

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 Berechtigungen wie sudo ausführen oder den Parameter --user verwenden, um die Installation in einem Verzeichnis durchzuführen, 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, auf dem Windows ausgeführt wird:

    pip install --user git-remote-codecommit

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

Schritt 3: Stellen Sie eine Verbindung zur CodeCommit Konsole her und klonen Sie das Repository

Wenn dir bereits ein Administrator die Clone-URL geschickt hat, die du git-remote-codecommit für das CodeCommit Repository verwenden kannst, kannst du 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 einen. 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 in der enthaltenen Credential Helper 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 public/private SSH-Schlüsselpaar mit Ihrem IAM-Benutzer verwenden.

    Anmerkung

    Wenn Sie statt einer Liste von Repositorys eine Willkommensseite sehen, sind Ihrem AWS Konto in dem, in AWS-Region dem Sie angemeldet sind, keine Repositorys zugeordnet. Informationen zur Erstellung eines Repositorys finden Sie unter Erstellen Sie eine AWS CodeCommit Repository, 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 die HTTPS-URL git-remote-codecommit, die Sie kopiert haben, und den Namen des AWS CLI Profils, 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 mit dem Namen zu klonen: CodeCommitProfile 

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

    Um ein Repository in einem anderen AWS-Region als dem in Ihrem Profil konfigurierten zu klonen, geben Sie den AWS-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 du deinen ersten Commit erstellst und pushen kannst, erfährst du unterErstellen Sie einen 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.