Erste Schritte mit Git und AWS CodeCommit

Um das CodeCommit Repository zu erstellen

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

2. Verwenden Sie die Regionsauswahl, um den AWS-Region Ort auszuwählen, 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) unter Repository name (Repository-Name) einen Namen für Ihr Repository ein (z. B. MyDemoRepo).

   Anmerkung

   Bei Repository-Namen muss die Groß- und Kleinschreibung beachtet werden. Er darf nicht mehr als 100 Zeichen enthalten. Weitere Informationen finden Sie unter Limits.

5. (Optional) Geben Sie unter Description (Beschreibung) eine Beschreibung ein (z. B. My demonstration repository). Dadurch können Sie und andere Benutzer den Zweck des Repositorys leichter erkennen.

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 der 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 diesen Code analysiert. CodeGuru Reviewer verwendet mehrere Modelle für maschinelles Lernen, um Codefehler zu finden und automatisch Verbesserungen und Korrekturen in Pull-Requests vorzuschlagen. Weitere Informationen finden Sie im Amazon CodeGuru Reviewer-Benutzerhandbuch.

9. Wählen Sie Erstellen aus.

1. Öffne 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. 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 entweder Git-Anmeldeinformationen mit Ihrem IAM-Benutzer oder den Credential Helper verwenden, der im Lieferumfang von enthalten ist. AWS CLI

   • 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 SSH-Schlüsselpaar mit Ihrem IAM-Benutzer verwenden.

   Anmerkung

   Wenn Sie statt einer Liste von Repositorys eine Willkommensseite sehen, sind in dem Land, in dem Sie angemeldet sind, keine Repositorys mit Ihrem AWS Konto verknüpft. AWS-Region Informationen zur Erstellung eines Repositorys finden Sie unter Erstellen Sie ein Repository AWS CodeCommit, oder befolgen Sie die Schritte im Tutorial Erste Schritte mit Git und CodeCommit.

4. (Optional) Wir empfehlen, dass du deinen lokalen Git-Client so konfigurierst, dass er main als Namen für den Standard-Branch für dein Repository verwendet wird. Dies ist der Name, der in allen Beispielen in diesem Handbuch für den Standard-Branch verwendet wird. Es ist auch derselbe Standard-Branch-Name, den Sie CodeCommit verwenden, wenn Sie Ihren ersten Commit in der Konsole durchführen. Führen Sie den folgenden Befehl aus, um den Standard-Branch-Namen global für Ihr System zu konfigurieren:

   git config --global init.defaultBranch main

   Wenn Sie es vorziehen, einen anderen Standard-Branch-Namen für all Ihre Repositorys zu verwenden, main ersetzen Sie ihn durch Ihren bevorzugten Namen. In diesem Tutorial wird davon ausgegangen, dass Ihr Standard-Branch den Namen main trägt.

   Wenn Sie unterschiedliche Standard-Branch-Namen für verschiedene Repositorys verwenden möchten, können Sie dieses Attribut lokal (--local) statt global (--global) setzen.

5. Klonen Sie das Repository am Terminal oder in der Befehlszeile mit dem git clone Befehl und geben Sie die Klon-URL ein, die Sie in Schritt 3 kopiert haben. Ihre Klon-URL hängt davon ab, welches Protokoll und welche Konfiguration Sie verwenden. Wenn Sie beispielsweise HTTPS mit Git-Anmeldeinformationen verwenden, um ein Repository zu klonen, das MyDemoRepoin der Region USA Ost (Ohio) benannt ist:

   git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

   Wenn Sie HTTPS mit git-remote-codecommit verwenden:

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

   Bei Verwendung von SSH:

   git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

   Anmerkung

   Wenn bei dem Versuch, ein Repository zu klonen, ein Fehler angezeigt wird, haben Sie möglicherweise die Einrichtung nicht abgeschlossen, die für Ihren lokalen Computer erforderlich ist. Weitere Informationen finden Sie unter Einrichtung für AWS CodeCommit.

1. Erstellen Sie mit einem Texteditor die beiden folgenden Beispieltextdateien in Ihrem Verzeichnis. Geben Sie den Dateien die Namen cat.txt und dog.txt:

   cat.txt
   -------
   The domestic cat (Felis catus or Felis silvestris catus) is a small, usually furry, domesticated, and carnivorous mammal.

   dog.txt
   -------
   The domestic dog (Canis lupus familiaris) is a canid that is known as man's best friend.

2. Führen Sie ausgit config, um Ihren Benutzernamen und Ihre E-Mail-Adresse, dargestellt durch Platzhalter your-user-name, your-email-addresszu Ihrem lokalen Repository hinzuzufügen. Dies vereinfacht die Identifizierung der erstellten Commits:

   git config --local user.name "your-user-name"
   git config --local user.email your-email-address

3. Wenn Sie Ihren Standard-Branch-Namen nicht global festgelegt haben, als Sie das lokale Repository erstellt haben, führen Sie den folgenden Befehl aus, um den Standard-Branch-Namen auf festzulegen: main

   git config --local init.defaultBranch main

4. Führen Sie git add aus, um die Änderung per Stage zu übertragen:

   git add cat.txt dog.txt

5. Führen Sie git commit aus, um die Änderung festzuschreiben:

   git commit -m "Added cat.txt and dog.txt"

   Tipp

   Um Details zu dem soeben durchgeführten Commit anzuzeigen, führen Sie git log aus.

1. Wechseln Sie in das Verzeichnis /tmp oder in das Verzeichnis c:\temp.

2. Führen Sie git clone aus, um eine Pull-Übertragung einer Kopie des Repositorys in das freigegebene Repository (shared repo) durchzuführen:

   Für HTTPS:

   git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo shared-demo-repo

   Für HTTPS mit git-remote-codecommit:

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

   Für SSH:

   git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo shared-demo-repo

   Anmerkung

   Beim Klonen eines Repositorys mit SSH auf Windows-Betriebssystemen müssen Sie möglicherweise die SSH-Schlüssel-ID wie folgt der Verbindungszeichenfolge hinzufügen:

   git clone ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

   Weitere Informationen finden Sie unter Für SSH-Verbindungen unter Windows.

   In diesem Befehl MyDemoRepo steht der Name Ihres CodeCommit Repositorys. shared-demo-repoist der Name des Verzeichnisses, das Git in dem /tmp Verzeichnis oder dem c:\temp Verzeichnis erstellt. Wenn Git das Verzeichnis erstellt hat, überträgt Git eine Kopie Ihres Repositorys per Pull in das Verzeichnis shared-demo-repo.

3. Wechseln Sie in das Verzeichnis shared-demo-repo:

   (For Linux, macOS, or Unix) cd /tmp/shared-demo-repo
   (For Windows) cd c:\temp\shared-demo-repo

4. Führen Sie git config den Befehl aus, um einen weiteren Benutzernamen und eine E-Mail-Adresse hinzuzufügen, die durch Platzhalter other-user-nameund other-email-addressdargestellt werden. Dadurch wird es einfacher, festzustellen, welche Commits von dem anderen Benutzer durchgeführt werden:

   git config --local user.name "other-user-name"
   git config --local user.email other-email-address

5. Erstellen Sie mit einem Texteditor die folgende Beispieltextdateien im Verzeichnis shared-demo-repo. Benennen Sie die Datei horse.txt:

   horse.txt
   -------
   The horse (Equus ferus caballus) is one of two extant subspecies of Equus ferus.

6. Führen Sie git add aus, um die Änderung per Stage an das freigegebene Repository (shared repo) zu übertragen:

   git add horse.txt

7. Führen Sie git commit aus, um die Änderung im dem freigegebenen Repository (shared repo) festzuschreiben:

   git commit -m "Added horse.txt"

8. Führen Sie ausgit push, um Ihren ersten Commit über den Standard-Remote-Namen, den Git für Ihr CodeCommit Repository (origin) verwendet, aus dem Standard-Branch in Ihrem lokalen Repo (main) zu pushen:

   git push -u origin main

9. Wechsle zu deinem lokalen Repo und führe den Befehl ausgit pull, um den Commit, den das gemeinsame Repo für das Repository vorgenommen hat, in dein lokales Repo zu ziehen. CodeCommit Führen Sie anschließend git log aus, um den Commit anzeigen zu lassen, der von dem freigegebenen Repository (shared repo) initiiert wurde.

1. Führen git checkout Sie von Ihrem lokalen Repo aus den Befehl aus und geben Sie dabei den Namen des Branches (zum BeispielMyNewBranch) und die ID des ersten Commits an, den Sie im lokalen Repository vorgenommen haben.

   Wenn Sie die Commit-ID nicht kennen, führen Sie git log aus, um sie abzurufen. Stellen Sie sicher, dass in dem Commit Ihr Benutzername und Ihre E-Mail-Adresse und nicht die Daten des anderen Benutzers verwendet werden. Dies dient dazu, zu simulieren, dass main es sich um eine stabile Version des CodeCommit Projektarchivs handelt und dass der MyNewBranch Branch für ein neues, relativ instabiles Feature vorgesehen ist:

   git checkout -b MyNewBranch commit-ID

2. Führen Sie den Befehl ausgit push, um den neuen Branch vom lokalen Repository an das CodeCommit Repository zu senden:

   git push origin MyNewBranch

3. Übertragen Sie nun den Branch per Pull an das freigegebene Repository (shared repo) und überprüfen Sie die Ergebnisse:

   1. Wechseln Sie in das Verzeichnis des freigegebenen Repositorys (shared-demo-repo).

   2. Rufen Sie den neuen Branch per Pull ab (git fetch origin).

   3. Überprüfen Sie, ob der Branch per Pull übertragen wurde (git branch --all zeigt eine Liste aller Branches für das Repository an).

   4. Umstellen auf den neuen Branch (git checkout MyNewBranch).

   5. Überprüfen Sie, ob Sie zum Branch MyNewBranch gewechselt haben, indem Sie git status oder git branch ausführen. Die Ausgabe zeigt Ihnen, in welchem Branch Sie sich befinden. In diesem Fall sollte es sich um MyNewBranch handeln.

   6. Lassen Sie die Liste der Commits in dem Branch anzeigen (git log).

   Im Folgenden sind die aufzurufenden Git-Befehle aufgeführt:

   git fetch origin
   git branch --all
   git checkout MyNewBranch
   git branch or git status
   git log

4. Wechseln Sie zurück zum Branch main und lassen Sie die Liste der zugehörigen Commits anzeigen. Die Git-Befehle sollten wie folgt aussehen:

   git checkout main
   git log

5. Wechseln Sie zu dem main Zweig in Ihrem lokalen Repo. Sie können git status oder git branch ausführen. Die Ausgabe zeigt Ihnen, in welchem Branch Sie sich befinden. In diesem Fall sollte es sich um main handeln. Die Git-Befehle sollten wie folgt aussehen:

   git checkout main
   git branch or git status

1. Führen git tag Sie von Ihrem lokalen Repo aus den Befehl aus und geben Sie dabei den Namen des neuen Tags (release) und die ID des ersten Commits an, den Sie im lokalen Repo vorgenommen haben.

   Wenn Sie die Commit-ID nicht kennen, führen Sie git log aus, um sie abzurufen. Stellen Sie sicher, dass in dem Commit Ihr Benutzername und Ihre E-Mail-Adresse und nicht die Daten des anderen Benutzers verwendet werden. Dies dient dazu, zu simulieren, dass es sich bei Ihrem Commit um eine stabile Version des CodeCommit Repositorys handelt:

   git tag release commit-ID

   Führen Sie git tag erneut aus, um den Commit des anderen Benutzers mit dem Tag beta zu versehen. Dadurch wird simuliert, dass der Commit für eine neue, relativ instabile Funktion durchgeführt wird:

   git tag beta commit-ID

2. Führen Sie ausgit push --tags, um die Tags an das CodeCommit Repository zu senden.

3. Übertragen Sie nun die Tags per Pull an das freigegebene Repository (shared repo) und überprüfen Sie die Ergebnisse:

   1. Wechseln Sie in das Verzeichnis des freigegebenen Repositorys (shared-demo-repo).

   2. Rufen Sie die neuen Tags per Pull ab (git fetch origin).

   3. Überprüfen Sie, ob die Tags per Pull übertragen wurden (git tag zeigt eine Liste aller Tags für das Repository an).

   4. Zeigen Sie Informationen zu jedem Tag an (git log release und git log beta).

   Im Folgenden sind die aufzurufenden Git-Befehle aufgeführt:

   git fetch origin
   git tag
   git log release
   git log beta

4. Probieren Sie das auch im lokalen Repo aus:

   git log release
   git log beta

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

   Stellen Sie sicher, dass Sie sich mit demselben Benutzernamen und demselben Passwort anmelden, das Sie auch in Einrichtung verwendet haben.

2. Wählen Sie im Navigationsbereich Users und dann Create New Users aus.

3. Geben Sie im ersten Feld unter Enter User Names (Benutzernamen eingeben) einen Beispiel-Benutzernamen ein (zum Beispiel JaneDoe-CodeCommit). Aktivieren Sie das Kontrollkästchen Generate an access key for each user (Zugriffsschlüssel für jeden Benutzer generieren) und wählen Sie dann Create (Erstellen).

4. Wählen Sie die Option Show User Security Credentials. Notieren Sie sich die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel oder wählen Sie Download Credentials.

5. Folgen Sie den Anweisungen unterFür HTTPS-Benutzer, die Git-Anmeldeinformationen verwenden, um die Anmeldeinformationen des IAM-Benutzers zu generieren und bereitzustellen.

   Wenn Sie SSH verwenden möchten, befolgen Sie die Anweisungen in SSH und Linux, macOS oder Unix: Richte die öffentlichen und privaten Schlüssel für Git ein undCodeCommit oder Schritt 3: Richten Sie die öffentlichen und privaten Schlüssel für Git und CodeCommit ein, um für den Benutzer öffentliche und private Schlüssel einzurichten.

6. Führen Sie git pull. Die folgende Fehlermeldung sollte angezeigt werden:

   Für HTTPS:

   fatal: unable to access 'https://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403.

   Für SSH:

   fatal: unable to access 'ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403.

   Der Fehler tritt auf, weil der neue Benutzer nicht berechtigt ist, das gemeinsam genutzte Repository mit dem CodeCommit Repository zu synchronisieren.

7. Kehren Sie zur IAM-Konsole zurück. Wählen Sie im Navigationsbereich Policies und dann Create Policy. (Wenn die Schaltfläche Get Started (Erste Schritte) angezeigt wird, klicken Sie darauf und wählen Sie anschließend Create Policy (Richtlinie erstellen) aus.)

8. Klicken Sie neben Create Your Own Policy auf Select.

9. Geben Sie in das Feld Policy Name (Richtlinienname) einen Namen ein (z. B. CodeCommitAccess-GettingStarted).

10. Geben Sie im Feld Richtliniendokument Folgendes ein, sodass ein IAM-Benutzer Daten aus jedem Repository abrufen kann, das dem IAM-Benutzer zugeordnet ist:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "codecommit:GitPull"
          ],
          "Resource": "*"
        }
      ]
    }

    Tipp

    Wenn Sie möchten, dass der IAM-Benutzer Commits in jedes Repository übertragen kann, das dem IAM-Benutzer zugeordnet ist, geben Sie stattdessen Folgendes ein:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "codecommit:GitPull",
            "codecommit:GitPush"
          ],
          "Resource": "*"
        }
      ]
    }

    Informationen zu anderen CodeCommit Aktions- und Ressourcenberechtigungen, die Sie Benutzern gewähren können, finden Sie unter. Authentifizierung und Zugriffskontrolle für AWS CodeCommit

11. Klicken Sie im Navigationsbereich auf Users (Benutzer).

12. Wählen Sie den Beispiel-Benutzernamen (zum Beispiel JaneDoe-CodeCommit), dem Sie die Richtlinie anfügen möchten.

13. Wählen Sie die Registerkarte Berechtigungen.

14. Klicken Sie unter Managed Policies auf Attach Policy.

15. Wählen Sie die CodeCommitAccess-GettingStarted-Richtlinie aus, die Sie eben erstellt haben, und dann Attach Policy (Richtlinie anfügen).

16. Führen Sie git pull. Nun sollte der Befehl funktionieren und eine Meldung des Typs Already up-to-date sollte angezeigt werden.

17. Wenn Sie HTTPS verwenden, wechseln Sie zu Ihren ursprünglichen Git-Anmeldeinformationen oder, falls Sie git-remote-codecommit verwenden, zu Ihrem üblichen Profil. Weitere Informationen finden Sie in den Anweisungen unter Einrichtung für HTTPS-Benutzer mit Git-Anmeldeinformationen oder Einrichtungsschritte für HTTPS-Verbindungen zuAWS CodeCommitmitgit-remote-codecommit.

    Wenn Sie SSH verwenden, wechseln Sie zu Ihren ursprünglichen Schlüsseln. Weitere Informationen finden Sie unter SSH und Linux, macOS oder Unix: Richte die öffentlichen und privaten Schlüssel für Git ein undCodeCommit oder Schritt 3: Richten Sie die öffentlichen und privaten Schlüssel für Git und CodeCommit ein.

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

2. Wählen Sie auf der Seite Dashboard in der Liste der Repositorys den Eintrag MyDemoRepo.

3. Wählen Sie im Navigationsbereich Settings (Einstellungen).

4. Klicken Sie auf der Seite Settings unter Delete repository auf Delete repository.

5. Geben Sie in das Feld neben Type the name of the repository to confirm deletion (Namen des Repositorys eingeben, um das Löschen zu bestätigen) die Zeichenfolge MyDemoRepo ein und klicken Sie dann auf Delete (Löschen).