Schritte zum Einrichten von HTTPS-Verbindungen mitAWS CodeCommitMit git-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.

Schritte zum Einrichten von HTTPS-Verbindungen mitAWS CodeCommitMit git-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 einrichtengit-remote-codecommitaus. Dieses Dienstprogramm bietet eine einfache Methode zum Push- und Pull von Code aus CodeCommit -Repositorys durch die Erweiterung von Git. Es ist die empfohlene Methode zur Unterstützung von Verbindungen, die mit Verbundzugriff, Identitätsanbietern und temporären Anmeldeinformationen hergestellt werden. Statt einen IAM-Benutzer zu erstellen, können Sie bereits vorhandene Identitäten vonAWS Directory Serviceoder einen Web-Identitätsanbieter. Diese werden als verbundene Benutzer bezeichnet. AWS weist einem verbundenen Benutzer eine Rolle zu, wenn der Zugriff über einen Identitätsanbieter angefordert wird. Weitere Informationen zu verbundenen Benutzern finden Sie unter Verbundene Benutzer und Rollen im IAM-Benutzerhandbuch.

Sie können auchgit-remote-codecommitVerwenden Sie einen 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 Prozeduren werden unter der Annahme geschrieben, dass Sie über ein Amazon Web Services Konto verfügen, mindestens ein Repository in CodeCommit erstellt haben und einen IAM-Benutzer mit einer verwalteten Richtlinie verwenden, wenn Sie eine Verbindung mit 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 der 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 -Repositories zu arbeiten, müssen Sie Git auf Ihrem lokalen Computer installieren. CodeCommit unterstützt 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 wieDownloadsaus.

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

Schritt 1: Erste Konfiguration für CodeCommit

Führen Sie diese Schritte aus, um einen IAM-Benutzer zu erstellen, ihn mit den entsprechenden Richtlinien zu konfigurieren, einen Zugriffsschlüssel und einen geheimen Schlüssel zu erhalten und die zu installieren und zu konfigurierenAWS CLIaus.

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

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

  2. Legen Sie einen IAM-Benutzer für Ihr -Konto an oder wählen Sie einen vorhandenen Amazon Web Services aus. Legen Sie eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel für den -Benutzer fest. Weitere Informationen finden Sie unterErstellen eines IAM-Benutzers in Ihrem Amazon Web Services Kontoaus.

    Anmerkung

    erfordert CodeCommitAWS Key Management Serviceaus. Wenn Sie einen vorhandenen IAM-Benutzer verwenden, müssen Sie sicherstellen, dass mit diesem keine Richtlinien verknüpft 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-Konsole unter https://console.aws.amazon.com/iam/.

  4. Wählen Sie im Navigationsbereich der IAM-KonsoleBenutzerWählen Sie dann den IAM-Benutzer aus, der für den CodeCommit -Zugriff konfiguriert werden soll.

  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 Richtlinien die OptionAWScodeCommitPowerUseroder eine andere verwaltete Richtlinie für den CodeCommit -Zugriff. Weitere Informationen finden Sie unter AWSverwaltete Richtlinien für CodeCommit.

    Nachdem Sie die Richtlinie zugewiesen haben, wählen SieWeiter: PrüfenUm 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 unterFreigeben eines RepositoriundAuthentifizierung 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 das Arbeiten mit CodeCommit über die Befehlszeile. Wir empfehlen Ihnen,AWS 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ür dieAWS CLIinstalliert sind.

    aws codecommit help

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

  3. Konfigurieren derAWS CLImit einem Profil mithilfe derconfigureFühren Sie den folgenden Befehl aus:.

    aws configure

    Geben Sie nach Aufforderung dieAWSZugriffsschlüssel undAWSDer geheime Zugriffsschlüssel des IAM-Benutzers, den Sie mit CodeCommit verwenden werden. Achten Sie auch darauf, die AWS-Region Wenn sich das Repository befindet, z. Bus-east-2aus. Wenn Sie nach dem standardmäßigen Ausgabeformat gefragt werden, geben Sie json an. 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 her AWS-Region So konfigurieren Sie dieAWS CLIWählen Sie den Standardregionsnamen aus. 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

    • af-south-1

    Weitere Informationen über CodeCommit und AWS-Region finden Sie unterRegionen und Git-Verbindungsendpunkteaus. Weitere Informationen zu IAM, Zugriffsschlüsseln und geheimen Schlüsseln 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: So installieren Sie git-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 Berechtigungen ausführen, z. B. sudo:

    sudo pip install git-remote-codecommit
  2. Überwachen Sie den Installationsvorgang, bis eine Erfolgsmeldung ähnlich der folgenden angezeigt wird:

    Successfully built git-remote-codecommit

Schritt 3: Connect zur CodeCommit -Konsole her und klonen Sie das Repository

Wenn Ihnen ein Administrator bereits die Klon-URL zur Verwendung mitgit-remote-codecommitFür das CodeCommit -Repository können Sie die Verbindung zur Konsole überspringen und das Repository direkt klonen.

So stellen Sie eine Verbindung mit einem CodeCommit her

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

  2. Wählen Sie in der Regionsauswahl die Option AWS-Region , in dem das Repository erstellt wurde. Repositorys sind spezifisch für eine AWS-Region aus. 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 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 SSHkey pair mit Ihrem IAM-Benutzer verwenden.

    Anmerkung

    Wenn Ihnen einWillkommenWird anstelle einer Liste mit Repositorys (Liste) verwendet, sind keine Repositorys mit IhrerAWS-Konto in der AWS-Region Wenn 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. Klonen Sie am Terminal oder an der Eingabeaufforderung das Repository mit dem git clone-Befehl. Verwenden Sie die kopierte HTTPS git-remote-codecommit-URL 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. Beispiel zum Klonen eines Repositorys namensMyDemoRepozu einem lokalen Repo namensmy-demo-repo:

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

    So klonen Sie dasselbe Repository mit einem Profil namens CodeCommitProfile:

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

    So klonen Sie ein Repository in einem anderen AWS-Region Fügen Sie als die in Ihrem Profil konfigurierte AWS-Region Name. Beispiel:

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

Nächste Schritte

Sie haben die Voraussetzungen erfüllt. Führen Sie die Schritte unter ausErste Schritte mit CodeCommit , um mit der Verwendung von CodeCommit zu beginnen.

Weitere Informationen zum Erstellen und Push Ihres ersten Commits finden Sie unterErstellen eines Commits inAWS CodeCommitaus. Wenn Sie mit Git noch nicht vertraut sind, finden Sie unterWo kann ich mehr über Git erfahren?undErste Schritte mit Git undAWS CodeCommitaus.