Migrieren Sie ein Git-Repository zu AWS CodeCommit

Um einen IAM-Benutzer für den Zugriff zu erstellen und zu konfigurieren CodeCommit

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

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

   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 CodeCommit erforderlichen AWS KMS Aktionen verweigern. Weitere Informationen finden Sie unter AWS KMS und 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 in der IAM-Konsole im Navigationsbereich 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 AWSCodeCommitPowerUseraus 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 aus, 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 Teilen Sie ein Repository und. Authentifizierung 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 über die CodeCommit Befehlszeile. Wir empfehlen, AWS CLI Version 2 zu installieren. Es ist die neueste Hauptversion von AWS CLI und unterstützt alle aktuellen Funktionen. Es ist die einzige Version vonAWS CLI, die die Verwendung eines Root-Kontos, Verbundzugriff oder temporärer 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 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 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 configure Befehl verwenden, wie folgt:.

   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 sich das Repository befindet, 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 für die AWS CLI finden Sie unter:

   • Benannte Profile

   • Verwenden einer IAM-Rolle in der AWS CLI

   • Befehl „Set“

   • Verbindung zuAWS CodeCommit Repositorys mit wechselnden Anmeldeinformationen herstellen

   Um eine Verbindung zu einem Repository oder einer Ressource in einem anderen Repository herzustellenAWS-Region, müssen Sie das AWS CLI mit dem Standardregionsnamen neu konfigurieren. Zu den unterstützten 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

   • 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 Zugriffsschlüssel für IAM-Benutzer verwalten. Weitere Informationen zur AWS CLI und zu Profilen finden Sie unter Benannte Profile.

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

2. Wählen Sie in der Regionsauswahl den AWS-Region Ort aus, an dem 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 AWS-Region für Ihr Amazon Web Services Services-Konto eindeutig sein.

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 Beschreibungsfeld zeigt Markdown in der Konsole an und akzeptiert alle HTML-Zeichen und gültigen Unicode-Zeichen. Wenn Sie ein Anwendungsentwickler sind, der die BatchGetRepositories APIs GetRepository oder verwendet und planen, das Repository-Beschreibungsfeld in einem Webbrowser anzuzeigen, finden Sie weitere Informationen in der CodeCommit 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 Kennzeichnen von Repositorys in AWS CodeCommit.

7. (Optional) Erweitern Sie Zusätzliche Konfiguration, um anzugeben, ob Sie den Standardschlüssel Von AWS verwalteter Schlüssel oder Ihren eigenen vom Kunden verwalteten Schlüssel zum Verschlüsseln und Entschlüsseln von Daten in diesem Repository verwenden möchten. Wenn Sie Ihren eigenen, vom Kunden verwalteten Schlüssel verwenden möchten, müssen Sie sicherstellen, dass er dort verfügbar ist, AWS-Region wo Sie das Repository erstellen, und dass der Schlüssel aktiv ist. Weitere Informationen finden Sie unter AWS Key Management Service und Verschlüsselung für AWS CodeCommit Repositorys.

8. (Optional) Wählen Sie Amazon CodeGuru Reviewer für Java und Python aktivieren, wenn dieses Repository Java- oder Python-Code enthält und Sie möchten, dass CodeGuru Reviewer ihn analysiert. CodeGuru Reviewer verwendet mehrere Modelle für maschinelles Lernen, um Codefehler zu finden und Verbesserungen und Korrekturen in Pull-Requests vorzuschlagen. Weitere Informationen finden Sie im Amazon CodeGuru Reviewer-Benutzerhandbuch.

9. Wählen Sie Erstellen aus.

1. Führen Sie über das Terminal oder die Befehlszeile auf Ihrem lokalen Computer den git clone Befehl mit der --mirror Option aus, eine bloße Kopie des Remote-Repositorys in einen neuen Ordner mit dem Namen aws-codecommit-demozu klonen. Hierbei handelt es sich um ein einfaches Repository nur für die Migration. Es ist nicht das lokale Repo für die Interaktion mit dem migrierten Repository in. CodeCommit Sie können es später erstellen, nachdem die Migration zu abgeschlossen CodeCommit ist.

   Im folgenden Beispiel wird eine auf GitHub (https://github.com/awslabs/ aws-demo-php-simple -app.git) gehostete Demo-Anwendung in ein lokales Repo in einem Verzeichnis mit dem Namen geklont. aws-codecommit-demo

   git clone --mirror https://github.com/awslabs/aws-demo-php-simple-app.git aws-codecommit-demo

2. Ändern Sie die Verzeichnisse in das Verzeichnis, in dem Sie den Klon erstellt haben.

   cd aws-codecommit-demo

3. Führen Sie den git push Befehl aus und geben Sie die URL und den Namen des CodeCommit Ziel-Repositorys sowie die Option an. --all (Dies ist die URL, die Sie in Schritt 1: Erstellen Sie ein Repository CodeCommit kopiert haben.)

   Wenn Sie beispielsweise Ihr Repository benannt haben MyClonedRepositoryund für die Verwendung von HTTPS eingerichtet sind, würden Sie den folgenden Befehl ausführen:

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

   Anmerkung

   Die Option --all überträgt per Push ausschließlich alle Branches für das Repository. Andere Referenzen, z. B. Tags, werden nicht übertragen. Wenn Sie Tags per Push übertragen möchten, warten Sie, bis der ursprüngliche Push-Vorgang abgeschlossen ist, und führen Sie einen weiteren aus, diesmal unter Verwendung der Option --tags:

   git push ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyClonedRepository --tags

   Weitere Informationen finden Sie unter Git Push auf der Git-Website. Informationen zur Push-Übertragung großer Repositorys, insbesondere wenn alle Referenzen gleichzeitig per Push übertragen werden sollen, (z. B. mit der Option --mirror), finden Sie unter Migrieren Sie ein Repository schrittweise.

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 (z. B. MyClonedRepository).

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

   

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. Wählen Sie auf der Seite „Richtlinie erstellen“ die Option Verwaltete Richtlinie importieren aus.

4. Geben Sie auf der Seite Verwaltete Richtlinien importieren im Feld Richtlinien filtern den Text einAWSCodeCommitPowerUser. Klicken Sie auf die Schaltfläche neben dem Richtliniennamen und wählen Sie dann Importieren aus.

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

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

   Tipp

   Um den ARN für das CodeCommit Repository zu finden, gehen Sie zur CodeCommit Konsole, wählen Sie den Repository-Namen aus der Liste aus und wählen Sie dann Einstellungen. 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 „Richtlinie überprüfen“.

6. Geben Sie auf der Seite „Richtlinie überprüfen“ im Feld Name einen neuen Namen für die Richtlinie ein (z. B. AWSCodeCommitPowerUser- MyDemoRepo). Geben Sie optional eine Beschreibung für diese Richtlinie ein.

7. Wählen Sie Create Policy (Richtlinie erstellen) aus.

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. Geben Sie auf der Seite Set Group Name (Name für Gruppe festlegen) im Feld Group Name (Gruppenname) einen Namen für die Gruppe ein (zum Beispiel MyDemoRepoGroup) und wählen Sie dann Next Step (Nächster Schritt) aus. 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).

5. Klicken Sie auf der Seite Review auf Create Group. IAM erstellt diese Gruppe mit den angegebenen Richtlinien, die bereits angehängt sind. Die Gruppe erscheint in der Liste der Gruppen, die mit Ihrem Amazon Web Services Services-Konto verknüpft sind.

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. Markieren Sie in der Liste, in der alle mit Ihrem Amazon Web Services Services-Konto verknüpften Benutzer angezeigt werden, die Kästchen neben den Benutzern, denen Sie Zugriff auf das CodeCommit Repository gewähren möchten, und wählen Sie dann Benutzer hinzufügen.

   Tipp

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

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

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