Migrieren Sie lokale oder nicht versionierte Inhalte zuAWS 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.

Migrieren Sie lokale oder nicht versionierte Inhalte zuAWS CodeCommit

Die Verfahren in diesem Thema zeigen den Prozess des Migrierens eines bestehenden Projekts oder lokaler Inhalte auf dem Computer in ein CodeCommit -Repository. Als Teil dieses Prozesses werden Sie Folgendes durchführen:

  • Führen Sie die für CodeCommit -erforderliche erstmaligen Einrichtung aus.

  • Erstellen eines CodeCommit Repositorys.

  • Legen Sie einen lokalen Ordner unter Git-Versionskontrolle und pushen Sie den Inhalt dieses Ordners an das CodeCommit -Repository.

  • Anzeigen der Dateien im CodeCommit -Repository

  • Freigeben des CodeCommit -Repositorys für Ihr Team


            Migrieren eines lokalen Projekts nach CodeCommit

Schritt 0: Setup für den Zugriff auf CodeCommit erforderlich

Bevor Sie lokale Inhalte nach CodeCommit migrieren können, müssen Sie zunächst einen IAM-Benutzer für CodeCommit erstellen und konfigurieren und den lokalen Computer für den Zugriff konfigurieren. Installieren Sie auch dieAWS CLIVerwalten von CodeCommit. Obwohl Sie die meisten CodeCommit -Aufgaben ohne ausführen können, ist dasAWS CLIbietet Flexibilität bei der Arbeit mit Git.

Wenn Sie bereits für CodeCommit eingerichtet sind, gehen Sie direkt zuSchritt 1: Erstellen eines CodeCommit Repositorys.

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ählenRegistrieren.

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

    Anmerkung

    CodeCommit erfordertAWS Key Management Service. Wenn Sie einen vorhandenen IAM-Benutzer verwenden, stellen Sie sicher, dass keine Richtlinien an den -Benutzer angefügt 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-Management-Konsole unter https://console.aws.amazon.com/iam/.

  4. Wählen Sie im Navigationsbereich der IAM-KonsoleBenutzerWä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 Richtlinien die OptionAWScodeCommitPowerUseroder eine andere verwaltete Richtlinie für den CodeCommit -Zugriff. Weitere Informationen finden Sie unter AWSVon AWS verwaltete (vordefinierte) Richtlinien für CodeCommit.

    Nachdem Sie die Richtlinie zugewiesen haben, wählen SieWeiter: PrüfenUm die Liste der Richtlinien anzuzeigen, die an den IAM-Benutzer angefügt werden sollen. Ist die Liste korrekt, wählen Sie Add permissions aus.

    Weitere Informationen über verwaltete CodeCommit -Richtlinien und das Freigeben von Repositorys für andere Gruppen und Benutzer finden Sie unterTeilen eines RepositorysundAuthentifizierung 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 über die Befehlszeile. Wir empfehlen Ihnen, zu installieren.AWS CLIVersion 2. Es ist die neueste Hauptversion derAWS CLIunterstützt alle aktuellen Funktionen. Es ist die einzige Version derAWS CLIunterstützt das Verwenden eines Root-Kontos, eines Verbundzugriffs oder temporären Anmeldeinformationen mitgit-remote-codecommit.

    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 dasAWS CLIinstalliert sind.

    aws codecommit help

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

  3. Konfigurieren derAWS CLImit einem Profil mithilfe derconfigurewie folgt:.

    aws configure

    Geben Sie nach Aufforderung dieAWSZugriffsschlüssel undAWSDer geheime Zugriffsschlüssel des IAM-Benutzers, der mit CodeCommit verwendet werden soll. Stellen Sie außerdem sicher, dass Sie die AWS-Region Wenn das Repository existiert, z. Bus-east-2. Wenn Sie nach dem standardmäßigen Ausgabeformat gefragt werden, geben Sie json an. Zum 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 Konfigurieren Sie dieAWS CLIKlicken Sie mit dem Standardnamen der Region an. 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

    Weitere Informationen zu CodeCommit und AWS-Region finden Sie unter.Regionen und Git-Verbindungsendpunkte. Weitere Informationen über IAM, Zugriffsschlüssel und geheime Schlüssel finden Sie unterWie erhalte ich Anmeldeinformationen?undVerwalten der Zugriffsschlüssel für IAM-Benutzer. Weitere Informationen zur AWS CLI und zu Profilen finden Sie unter Benannte Profile.

Als Nächstes müssen Sie Git installieren.

  • Für Linux, macOS oder Unix:

    Um mit Dateien, Commits und anderen Informationen in CodeCommit -Repositories zu arbeiten, 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 Zweignamens für anfängliche Commits. Wir empfehlen die Verwendung einer aktuellen Version von Git.

    Für die Installation von Git empfehlen wir Websites wieGit-Downloads.

    Anmerkung

    Git ist eine stetig weiterentwickelte und regelmäßig aktualisierte Plattform. Es kommt vor, dass sich die Änderung eines Features darauf auswirkt, wie CodeCommit funktioniert. Wenn Sie Probleme mit einer bestimmten Version von Git und CodeCommit haben, lesen Sie die Informationen inFehlersuche.

  • Für Windows:

    Um mit Dateien, Commits und anderen Informationen in CodeCommit -Repositories zu arbeiten, 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 Zweignamens für anfängliche Commits. Wir empfehlen die Verwendung einer aktuellen Version von Git.

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

    Anmerkung

    Git ist eine stetig weiterentwickelte und regelmäßig aktualisierte Plattform. Es kommt vor, dass sich die Änderung eines Features darauf auswirkt, wie CodeCommit funktioniert. Wenn Sie Probleme mit einer bestimmten Version von Git und CodeCommit haben, lesen Sie die Informationen inFehlersuche.

CodeCommit unterstützt sowohl HTTPS- als auch SSH-Authentifizierung. Um die Einrichtung abzuschließen, müssen Sie entweder Git-Anmeldeinformationen für CodeCommit (HTTPS, für die meisten Benutzer empfohlen), ein SSH-key pair (SSH) für die Verwendung beim Zugriff auf CodeCommit,git-remote-codecommit(empfohlen für Benutzer, die Verbundzugriff verwenden) oder der Anmeldeinformationen, die in derAWS CLI.

Schritt 1: Erstellen eines CodeCommit Repositorys

In diesem Abschnitt verwenden Sie die CodeCommit -Konsole zum Erstellen des CodeCommit-Repositorys, das Sie für den Rest dieses Tutorials verwenden werden. Informationen über die Verwendung der AWS CLI zum Erstellen des Repositorys finden Sie unter Erstellen Sie ein -Repository (AWS CLI).

  1. Öffnen Sie die CodeCommit -Konsole unter.https://console.aws.amazon.com/codesuite/codecommit/home.

  2. Wählen Sie in der Regionenauswahl die Option AWS-Region Klicken Sie auf, in dem Sie das Repository erstellen möchten. Weitere Informationen finden Sie unter Regionen und Git-Verbindungsendpunkte.

  3. Wählen Sie auf der Seite Repositories die Option Create repository aus.

  4. Geben Sie auf der Seite Create repository (Repository erstellen) im Feld Repository name (Repository-Name) einen Namen für das Repository ein.

    Anmerkung

    Bei den Repository-Namen wird nach Groß- und Kleinschreibung unterschieden. Der Name muss in der -Liste eindeutig sein. AWS-Region Klicken Sie auf Ihr Amazon Web Services Konto.

  5. (Optional) Geben Sie unter Description (Beschreibung) eine Beschreibung für das Repository ein. Dadurch können Sie und andere Benutzer den Zweck des Repositorys leichter erkennen.

    Anmerkung

    Das Feld für die Bezeichnung zeigt Markdown in der -Konsole an und akzeptiert alle HTML- und gültigen Unicode-Zeichen. Wenn Sie ein Anwendungsentwickler sind, der dieGetRepositoryoder .BatchGetRepositoriesAPIs und Sie planen, das Repository-Beschreibungsfeld in einem Webbrowser anzuzeigen, finden Sie unterCodeCommit -API-Referenz.

  6. (Optional) Wählen Sie Add tag (Tag hinzufügen) aus, um ein oder mehrere Repository-Tags (ein benutzerdefiniertes Attribut-Label, mit dem Sie Ihre AWS-Ressourcen organisieren und verwalten), zu Ihrem Repository hinzuzufügen. Weitere Informationen finden Sie unter Markieren von Repositorys inAWS CodeCommit.

  7. (Optional) Wählen SieAmazon CodeGuru Reviewer für Java und Python aktivieren, wenn dieses Repository Java- oder Python-Code enthält und CodeGuru Reviewer ihn analysieren soll. CodeGuru Reviewer verwendet mehrere Machine-Learning-Modelle, um Codefehler zu finden und Verbesserungen und Korrekturen in Pull-Anforderungen vorzuschlagen. Weitere Informationen finden Sie im .Amazon CodeGuru Reviewer Benutzerhandbuch.

  8. Wählen Sie Create aus.


                Erstellen eines Repositorys für das Migrieren von lokalen Inhalten nach CodeCommit

Nachdem das Repository erstellt wurde, wird es in der Liste Repositories angezeigt. Wählen Sie in der URL-Spalte das Kopiersymbol aus und wählen Sie dann das Protokoll (HTTPS oder SSH) aus, das Sie zum Herstellen der Verbindung mit CodeCommit verwenden möchten. Kopieren Sie die URL.

Wenn Sie beispielsweise Ihr Repository MyFirstRepo benannt haben und HTTPS verwenden, würde die URL folgendermaßen aussehen:

https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyFirstRepo

Sie benötigen diese URL später in Schritt 2: Migrieren von lokalen Inhalten in das CodeCommit -Repository.

Schritt 2: Migrieren von lokalen Inhalten in das CodeCommit -Repository

Nachdem Sie nun ein CodeCommit -Repository haben, können Sie ein Verzeichnis auf dem lokalen Computer auswählen, das in ein lokales Git-Repository konvertiert werden soll. Der git init-Befehl kann verwendet werden, um entweder bestehende, nicht versionierte Inhalte in ein Git-Repository zu konvertieren oder, wenn Sie noch keine Dateien oder Inhalte haben, um ein neues, leeres Repository zu initialisieren.

  1. Ändern Sie im Terminal- oder Befehlszeilenfenster des lokalen Computers Verzeichnisse in das Verzeichnis, das Sie als Quelle für Ihr Repository verwenden möchten.

  2. Führen Sie den folgenden Befehl aus, um Git so zu konfigurieren, dass ein Standardzweig namensmain:

    git config --local init.defaultBranch main

    Sie können diesen Befehl auch ausführen, um Ihren Standard-Zweignamen aufmainfür alle neu erstellten Repositories:

    git config --global init.defaultBranch main
  3. Führen Sie den git init-Befehl aus, um die Git-Versionskontrolle im Verzeichnis zu initialisieren. Dadurch wird ein Unterverzeichnis ".git" im Stamm des Verzeichnisses erstellt, das eine Nachverfolgung zur Versionskontrolle ermöglicht. Der Ordner ".git" enthält außerdem alle für das Repository erforderlichen Metadaten.

    git init
  4. Überprüfen Sie den Status des initialisierten Verzeichnisses, indem Sie den folgenden Befehl ausführen:

    git status

    Fügen Sie die Dateien hinzu, die Sie der Versionskontrolle hinzufügen möchten. In diesem Tutorial führen Sie den git add-Befehl mit dem .-Spezifizierer aus, um alle Dateien in diesem Verzeichnis hinzuzufügen. Weitere Optionen finden Sie in der Git-Dokumentation.

    git add .
  5. Erstellen Sie einen Commit für die hinzugefügten Dateien mit einer Commit-Nachricht.

    git commit –m "Initial commit"
  6. Ausführen des sgit pushGeben Sie die URL und den Namen des -Ziel-CodeCommit -Repositorys und das--all-Option. (Dies ist die URL, die Sie in Schritt 1: Erstellen eines CodeCommit Repositorys kopiert haben.)

    Wenn Sie beispielsweise Ihr Repository MyFirstRepo genannt haben und für die Nutzung von HTTPS eingerichtet sind, führen Sie folgenden Befehl aus:

    git push https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyFirstRepo --all

Schritt 3: Anzeigen von Dateien in CodeCommit

Nachdem Sie den Inhalt des Verzeichnisses per Push übertragen haben, können Sie alle Dateien im Repository schnell mithilfe der CodeCommit-Konsole anzeigen.

  1. Öffnen Sie die CodeCommit -Konsole unter.https://console.aws.amazon.com/codesuite/codecommit/home.

  2. Wählen Sie unter Repositories den Namen des Repositorys aus der Liste aus (z. B. MyFirstRepository).

  3. Zeigen Sie die Dateien im Repository an, um die Branches, die Klon-URLs, die Einstellungen und vieles mehr zu sehen.

Schritt 4: Teilen des CodeCommit Repositorys

Wenn Sie ein Repository in CodeCommit erstellen, werden zwei Endpunkte generiert: einer für HTTPS-Verbindungen und einer für SSH-Verbindungen. Beide bieten sichere Verbindungen über ein Netzwerk. Ihre Benutzer können beide Protokolle verwenden. Beide Endpunkte bleiben aktiv, unabhängig davon, welches Protokoll Sie Ihren Benutzern empfehlen. Bevor Sie Ihr Repository für andere freigeben können, müssen Sie IAM-Richtlinien erstellen, die anderen Benutzern Zugriff auf Ihr Repository ermöglichen. Stellen Sie Ihren Benutzern diese Zugriffsanweisungen zur Verfügung.

Erstellen einer kundenverwalteten Richtlinie für das Repository

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

  2. Wählen Sie im Navigationsbereich Dashboard die Optionen Policies und dann Create Policy aus.

  3. Klicken Sie auf derErstellen einer Richtlinie, wählen SieImportieren von verwaltete Richtlinie.

  4. Klicken Sie auf derImportieren von verwalteten Richtlinienfinden Sie unter.FilterrichtlinienGeben SieAWSCodeCommitPowerUser. Wählen Sie die Schaltfläche neben dem Richtliniennamen und anschließendImport.

  5. Wählen Sie auf der Seite Create policy (Richtlinie erstellen) die Option JSON aus. Ersetzen Sie den Teil „*“ desResourceZeile für CodeCommit -Aktionen mit dem Amazon-Ressourcennamen (ARN) des CodeCommit -Repositorys, wie hier dargestellt:

    "Resource": [ "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo" ]
    Tipp

    Um das ARN für das CodeCommit -Repository zu finden, gehen Sie zur CodeCommit-Konsole, wählen Sie den Namen des Repositorys aus der Liste aus und wählen Sie dannEinstellungen. Weitere Informationen finden Sie unter Repository-Details anzeigen.

    Wenn Sie diese Richtlinie auf mehr als ein Repository anwenden möchten, fügen Sie jedes Repository als Ressource hinzu, indem Sie seinen ARN angeben. Fügen Sie zwischen den Ressourcenanweisungen ein Komma ein, wie hier dargestellt:

    "Resource": [ "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo", "arn:aws:codecommit:us-east-2:111111111111:MyOtherDemoRepo" ]

    Wenn Sie mit der Bearbeitung fertig sind, wählen SieÜberprüfen der Richtlinie.

  6. Klicken Sie auf derÜberprüfen der Richtliniefinden Sie unter.NameGeben Sie einen neuen Namen für die Richtlinie ein (z. B.AWSCODECommitPowerUser-MyDemorepo) enthalten. Geben Sie optional eine Beschreibung für diese Richtlinie ein.

  7. Klicken Sie auf Create Policy.

Erstellen Sie zur Verwaltung des Zugriffs auf Ihr Repository eine IAM-Gruppe für dessen Benutzer, fügen Sie dieser Gruppe IAM-Benutzer hinzu und fügen Sie dann die kundenverwaltete Richtlinie, die Sie im vorherigen Schritt erstellt haben, an. Fügen Sie alle anderen für den Zugriff erforderlichen Richtlinien an, z. B. IAMSelfManageServiceSpecificCredentials oder IAMUserSSHKeys.

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

  2. Wählen Sie im Navigationsbereich Dashboard die Option Groups und dann Create New Group aus.

  3. Klicken Sie auf derGruppenname festlegenfinden Sie unter.GruppennameGeben Sie einen Namen für die Gruppe ein (z. B.MyDemorepoGroupKlicken Sie auf und danach auf.Nächster Schritt. Sie sollten den Repository-Namen als Teil des Gruppennamens einfügen.

    Anmerkung

    Dieser Name muss in einem Amazon Web Services Konto eindeutig sein.

  4. Aktivieren Sie das Kontrollkästchen neben der kundenverwalteten Richtlinie, die Sie im vorherigen Abschnitt erstellt haben (z. B.AWSCODECommitPowerUser-MyDemorepo) enthalten.

  5. Klicken Sie auf der Seite Review auf Create Group. IAM erstellt diese Gruppe mit den angegebenen, bereits angefügten Richtlinien. Die Gruppe wird in der Liste der mit Ihrem Amazon Web Services Konto verknüpften Gruppen angezeigt.

  6. Wählen Sie Ihre Gruppe in der Liste aus.

  7. Wählen Sie auf der Gruppenübersichtsseite die Registerkarte Users und anschließend die Option Add Users to Groups aus. Aktivieren Sie auf der Liste, die alle mit Ihrem Amazon Web Services Konto verknüpften Benutzer enthält, die Kontrollkästchen neben den Benutzern, denen Sie Zugriff auf das CodeCommit -Repository gewähren möchten. Wählen Sie dann aus.Benutzer hinzufügen.

    Tipp

    Sie können über das Suchfeld schnell nach Benutzern anhand ihres Namens suchen.

  8. Nachdem Sie die Benutzer hinzugefügt haben, schließen Sie die IAM-Konsole.

Nachdem Sie einen IAM-Benutzer erstellt haben, der mithilfe der von Ihnen konfigurierten RichtCodeCommit iengruppe und Richtlinien auf zugreifen kann, senden Sie diesem Benutzer die Informationen, die er zum Herstellen der Verbindung zum Repository benötigt.

  1. Öffnen Sie die CodeCommit -Konsole unter.https://console.aws.amazon.com/codesuite/codecommit/home.

  2. Wählen Sie in der Regionenauswahl die Option AWS-Region , in dem das Repository erstellt wurde. Die Repositorys sind spezifisch für eine AWS-Region . Weitere Informationen finden Sie unter Regionen und Git-Verbindungsendpunkte.

  3. Wählen Sie auf der Seite Repositories (Repositorys) das Repository aus, das Sie freigeben möchten.

  4. Wählen Sie unter Clone URL (Klon-URL) das Protokoll aus, das die Benutzer verwenden sollen. Dadurch wird die Klon-URL für das Verbindungsprotokoll kopiert.

  5. Übermitteln Sie den Benutzern die Klon-URL und andere erforderliche Anweisungen, wie z. B. zum Installieren der AWS CLI, Konfigurieren eines Profils oder Installieren von Git. Stellen Sie sicher, dass Sie die Konfigurationsinformationen für das Verbindungsprotokoll (z. B. HTTPS) angeben.