Migrieren Sie ein Git-Repository zu AWS CodeCommit

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:

   • Benannte Profile

   • Verwenden einer IAM-Rolle in der AWS CLI

   • Befehl „Set“

   • Verbindung herstellen mit AWS CodeCommit Repositorys mit wechselnden Anmeldeinformationen

   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.

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-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 GetRepository BatchGetRepositories OR-APIs verwendet und das Repository-Beschreibungsfeld in einem Webbrowser anzeigen möchten, lesen Sie die CodeCommit API-Referenz.

6. (Optional) Wähle Tag hinzufügen, um deinem Repository ein oder mehrere Repository-Tags (eine benutzerdefinierte Attributbezeichnung, mit der du deine AWS Ressourcen organisieren und verwalten kannst) hinzuzufügen. Weitere Informationen finden Sie unter Markieren 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 an dem Ort verfügbar ist, AWS-Region an dem 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 Repositorien.

8. (Optional) Wählen Sie Amazon CodeGuru Reviewer für Java und Python aktivieren aus, wenn dieses Repository Java- oder Python-Code enthält und Sie möchten, dass CodeGuru Reviewer ihn analysiert. CodeGuru Reviewer verwendet mehrere Machine-Learning-Modelle, 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-demo zu 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 CodeCommit abgeschlossen ist.

   Im folgenden Beispiel wird eine auf GitHub (https://github.com/awslabs/aws-demo-php-simple-app.git) gehostete Demoanwendung 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 MyClonedRepository und 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 Repositorys 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 an AWS-Managementkonsole 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 Create Policy die Option Verwaltete Policy importieren aus.

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

5. Wählen Sie auf der Seite Create policy (Richtlinie erstellen) die Option JSON aus. Ersetzen Sie den „*“ -Teil 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 aus.

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 Richtlinie erstellen aus.

1. Melden Sie sich bei der an AWS-Managementkonsole 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-Konto eindeutig sein.

4. Wählen Sie das Kästchen neben der vom Kunden verwalteten Richtlinie aus, 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, der die angegebenen Richtlinien bereits zugeordnet sind. Die Gruppe erscheint in der Liste der Gruppen, die Ihrem Amazon Web Services-Konto zugeordnet 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. Wählen Sie in der Liste mit allen Benutzern, die mit Ihrem Amazon Web Services-Konto verknüpft sind, die Felder neben den Benutzern aus, denen Sie Zugriff auf das CodeCommit Repository gewähren möchten, und wählen Sie dann Benutzer hinzufügen aus.

   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 einen. 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. Senden Sie Ihren Benutzern die Clone-URL zusammen mit allen anderen Anweisungen, z. B. zur Installation AWS CLI, Konfiguration eines Profils oder Installation von Git. Stellen Sie sicher, dass Sie die Konfigurationsinformationen für das Verbindungsprotokoll (z. B. HTTPS) angeben.