Migrieren Sie lokalen oder unversionierten Inhalt 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 lokalen oder unversionierten Inhalt zuAWS CodeCommit

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

  • Schließen Sie die für CodeCommit erforderliche erstmaligen Einrichtung ab.

  • Erstellen Sie ein CodeCommit-Repository.

  • Legen Sie einen lokalen Ordner unter Git-Versionskontrolle und Übertragen der Inhalte dieses Ordners per Push an das CodeCommit-Repository.

  • Anzeigen der Dateien im CodeCommit-Repository

  • Teilen Sie das CodeCommit-Repository mit Ihrem Team.


            Migrieren eines lokalen Projekts nach CodeCommit

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

Bevor Sie lokale Inhalte auf CodeCommit migrieren können, müssen Sie einen IAM-Benutzer für CodeCommit erstellen und konfigurieren und den lokalen Computer für den Zugriff konfigurieren. Sie sollten auch dieAWS CLIum CodeCommit zu verwalten. Obwohl Sie die meisten CodeCommit-Aufgaben ohne diese ausführen können, wird 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-Repositorysaus.

So erstellen und konfigurieren Sie einen IAM-Benutzer für den Zugriff auf CodeCommit
  1. Erstellen eines Amazon-Web-Services-Kontos, indem Sie aufhttp://aws.amazon.comund wählenRegistrierenaus.

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

    Anmerkung

    CodeCommit benötigtAWS Key Management Serviceaus. Wenn Sie einen vorhandenen IAM-Benutzer verwenden, stellen Sie sicher, dass dem Benutzer keine Richtlinien zugeordnet sind, die ausdrücklich dasAWS KMSvon CodeCommit erforderliche Aktionen. 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, den Sie für 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 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, die an den IAM-Benutzer angefügt werden. Ist die Liste korrekt, wählen Sie Add permissions aus.

    Weitere Informationen über die verwalteten Richtlinien von CodeCommit und das Freigeben des Zugriffs auf Repositorys für andere Gruppen und Benutzer finden Sie unterEin Repository teilenundAuthentifizierung 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 die Interaktion mit CodeCommit über die Befehlszeile. Wir empfehlen Ihnen, zu installierenAWS 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ärer 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 den folgenden Befehl aus, um zu überprüfen, ob die CodeCommit-Befehle für dasAWS CLIsind installiert.

    aws codecommit help

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

  3. Konfigurieren derAWS CLImit einem Profil unter Verwendung desconfigureBefehl, wie folgt:.

    aws configure

    Geben Sie nach Aufforderung dieAWS-Zugriffsschlüssel undAWSDer geheime Zugriffsschlüssel des IAM-Benutzers, der mit CodeCommit verwendet werden soll. Achten Sie auch darauf, dieAWS-Regionwo das Repository existiert, z. B.us-east-2aus. 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:

    So stellen Sie eine Verbindung mit einem Repository oder einer Ressource in einem anderen herAWS-Regionmüssen Sie dieAWS CLImit dem Standardnamen der Region. Zu den Standardregionsnamen für CodeCommit gehören:

    • 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 zu CodeCommit undAWS-Regionfinden Sie unterRegionen und Git-Verbindungsendpunkteaus. Weitere Informationen über IAM, Zugriffsschlüssel und geheime Schlüssel finden Sie unterWie erhalte ich Anmeldedaten?undVerwalten der Zugriffsschlüssel für IAM-Benutzeraus. 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-Repositorys arbeiten zu können, 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 das Konfigurieren des Zweignamens für erste Commits. Wir empfehlen die Verwendung einer aktuellen Version von Git.

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

    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 Probleme mit einer bestimmten Version von Git und CodeCommit auftreten, lesen Sie die Informationen inFehlerbehebungaus.

  • Für Windows:

    Um mit Dateien, Commits und anderen Informationen in CodeCommit-Repositorys arbeiten zu können, 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 das Konfigurieren des Zweignamens für erste Commits. Wir empfehlen die Verwendung einer aktuellen Version von Git.

    Für die Installation von Git empfehlen wir Websites wieGit für Windowsaus. Wenn Sie diesen Link verwenden, um Git zu installieren, können Sie alle Standardeinstellungen für die 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 Git mit CodeCommit zusammen funktioniert. Wenn Probleme mit einer bestimmten Version von Git und CodeCommit auftreten, lesen Sie die Informationen inFehlerbehebungaus.

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) konfigurieren, ein SSH-Schlüsselpaar (SSH) für die Verwendung beim Zugriff auf CodeCommit, konfigurieren.git-remote-codecommit(empfohlen für Benutzer, die den Verbundzugriff verwenden) oder das in der enthaltene Hilfsprogramm für AnmeldeinformationenAWS CLIaus.

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. Informationen über die Verwendung der AWS CLI zum Erstellen des Repositorys finden Sie unter Ein Repository erstellen (AWS CLI).

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

  2. Wählen Sie in der Regionenauswahl die OptionAWS-Regionwo Sie das Repository erstellen möchten. Weitere Informationen finden Sie unter Regionen und Git-Verbindungsendpunkte .

  3. Wählen Sie auf der Seite Repositorys die Option Repository auswählen.

  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 derAWS-Regionfür Ihr Amazon Web Services 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 Beschreibung zeigt Markdown in der -Konsole an und akzeptiert alle HTML- und gültigen Unicode-Zeichen. Wenn Sie ein Anwendungsentwickler sind, der dieGetRepositoryoderBatchGetRepositoriesAPIs und Sie planen, das Repository-Beschreibungsfeld in einem Webbrowser anzuzeigen, sieheCodeCommit-API-Referenzaus.

  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 Taggen von Repositorys inAWS CodeCommit .

  7. (Optional) Wählen Sie ausAmazon CodeGuru Reviewer für Java und Python aktivierenwenn dieses Repository Java- oder Python-Code enthält und Sie möchten, dass CodeGuru Reviewer es analysiert. CodeGuru Reviewer verwendet mehrere Machine-Learning-Modelle, um Codedefekte zu finden und Verbesserungen und Korrekturen in Pull-Anforderungen vorzuschlagen. Weitere Informationen finden Sie im .Benutzerhandbuch für Amazon CodeGuru Revieweraus.

  8. Wählen Sie Create (Erstellen) aus.

Nachdem das Repository erstellt wurde, wird es in der Liste Repositories angezeigt. Wählen Sie in der URL-Spalte das Kopiersymbol und anschließend das Protokoll (HTTPS oder SSH) aus, das für die Verbindung mit CodeCommit verwendet werden soll. 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

Da 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 für die Verwendung eines Standardzweigs namensmain:

    git config --local init.defaultBranch main

    Sie können diesen Befehl auch ausführen, um Ihren Standardverzweigungsnamen aufmainfür alle neu erstellten Repositorys:

    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 pushBefehl, wobei Sie die URL und den Namen des CodeCommit-Ziel-Repositorys und das--allOption. (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 der 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/homeaus.

  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 Sie das CodeCommit-Repository

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-Konsole unter https://console.aws.amazon.com/iam/.

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

  3. Auf derRichtlinie erstellenseite,, wählenImportieren der verwalteten Richtlinieaus.

  4. Auf derImportieren verwalteter Richtlinienangezeigten, inFilterrichtlinien, geben Sie einAWSCodeCommitPowerUseraus. Wählen Sie die Schaltfläche neben dem Richtliniennamen und wählen Sie dannImportaus.

  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

    Navigieren Sie zur CodeCommit-Konsole, wählen Sie in der Liste den Namen des Repositorys aus, wählen Sie den Namen des Repositorys aus, um den ARN des CodeCommit-Repositorys zu ermittelnEinstellungenaus. Weitere Informationen finden Sie unter Anzeigen von Repository-Details .

    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" ]

    Wählen Sie nach Abschluss der Bearbeitung die OptionÜberprüfen Sie die Richtlinieaus.

  6. Auf derRichtlinie überprüfenangezeigten, inNameGeben 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. Wählen Sie Create Policy (Richtlinie erstellen) aus.

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-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. Auf derGruppennamen festlegenangezeigten, inGruppennameein, geben Sie einen Namen für die Gruppe ein (z. B.MyDemorepoGroup) und danach aufNächster Schrittaus. Sie sollten den Repository-Namen als Teil des Gruppennamens einfügen.

    Anmerkung

    Dieser Name muss in einem Amazon Web Services 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 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 in der Liste, die alle mit Ihrem Amazon Web Services 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 aufBenutzer hinzufügenaus.

    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 Richtliniengruppe 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/homeaus.

  2. Wählen Sie in der Regionenauswahl die OptionAWS-Regionwo das Repository erstellt wurde. Die Repositorys sind spezifisch für eineAWS-Regionaus. 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.