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 auszuwählen AWS-Region , wo 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ähle Tag hinzufügen, um deinem Repository ein oder mehrere Repository-Tags (eine benutzerdefinierte Attributbezeichnung, die dir hilft, deine AWS Ressourcen zu organisieren und zu verwalten) 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 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 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 enthalten soll und Sie möchten, dass CodeGuru Reviewer diesen Code analysiert. CodeGuru Reviewer verwendet mehrere Machine-Learning-Modelle, 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 einen. 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 in der enthaltenen Credential Helper verwenden. 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 public/private SSH-Schlüsselpaar mit Ihrem IAM-Benutzer verwenden.

   Anmerkung

   Wenn Sie statt einer Liste von Repositorys eine Willkommensseite sehen, sind Ihrem AWS Konto in dem, in AWS-Region dem Sie angemeldet sind, keine Repositorys zugeordnet. Informationen zur Erstellung eines Repositorys finden Sie unter Erstellen Sie eine AWS CodeCommit Repository, 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 Name 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, der CodeCommit verwendet wird, wenn du deinen ersten Commit in der Konsole durchführst. Führen Sie den folgenden Befehl aus, um den Standard-Branchnamen global für Ihr System zu konfigurieren:

   git config --global init.defaultBranch main

   Wenn du es vorziehst, für all deine Repositorys einen anderen Standard-Branchnamen zu verwenden, ersetze ihn main durch deinen bevorzugten Namen. In diesem Tutorial wird davon ausgegangen, dass dein Standard-Branch main heißt.

   Wenn du unterschiedliche Standard-Branchnamen für verschiedene Repositorys verwenden möchtest, kannst du dieses Attribut lokal (--local) statt global (--global) setzen.

5. Klonen Sie das Repository im Terminal oder in der Befehlszeile mit dem git clone Befehl und geben Sie die Clone-URL ein, die Sie in Schritt 3 kopiert haben. Ihre Clone-URL hängt davon ab, welches Protokoll und welche Konfiguration Sie verwenden. Wenn du beispielsweise HTTPS mit Git-Anmeldeinformationen verwendest, um ein Repository zu klonen, das MyDemoRepo in 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 Platzhalteryour-user-name, Ihrem lokalen your-email-address Repo 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 Repo erstellt haben, führen Sie den folgenden Befehl aus, um den Standard-Branchnamen wie folgt 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. Ausführengit config, um einen weiteren Benutzernamen und eine E-Mail-Adresse hinzuzufügen, die durch Platzhalter other-user-name und other-email-address dargestellt 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 übertragen:

   git push -u origin main

9. Wechsle zu deinem lokalen Repo und führe ausgit pull, um den Commit, den das gemeinsame Repo für das Repository vorgenommen hat, in dein lokales Repo abzurufen. 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 den Befehl in Ihrem lokalen Repo aus und geben Sie dabei den Namen des Branches (z. B.MyNewBranch) 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. Damit soll simuliert werden, dass main es sich um eine stabile Version des CodeCommit Repositorys handelt und der MyNewBranch Branch für eine neue, relativ instabile Funktion bestimmt ist:

   git checkout -b MyNewBranch commit-ID

2. Führen Sie Folgendes ausgit push, um den neuen Branch aus dem lokalen Repo an das CodeCommit Projektarchiv 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 gemeinsam genutzte Repo-Verzeichnis (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 zur Filiale in Ihrem lokalen Repomain. 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 den Befehl in Ihrem lokalen Repo aus und geben Sie dabei den Namen des neuen Tags (release) und die ID des ersten Commits an, das 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 soll simulieren, dass Ihr Commit eine stabile Version des Repositorys ist: CodeCommit

   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 Projektarchiv 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 gemeinsam genutzte Repo-Verzeichnis (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. Probiere das auch im lokalen Repo aus:

   git log release
   git log beta

1. Melden Sie sich bei der an AWS-Managementkonsole 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: Richten Sie die öffentlichen und privaten Schlüssel für Git ein und CodeCommit oder Schritt 3: Richte die öffentlichen und privaten Schlüssel für Git ein und CodeCommit, 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 gemeinsame Repo mit dem CodeCommit Repository zu synchronisieren.

7. Kehren Sie zur IAM-Konsole zurück. Wählen Sie im Navigationsbereich Richtlinien und dann Richtlinie erstellen. (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 in das Feld Richtliniendokument Folgendes ein, damit ein IAM-Benutzer Daten aus jedem Repository abrufen kann, das dem IAM-Benutzer zugeordnet ist:

    JSON

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

    Tipp

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

    JSON

    {
      "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 zu AWS CodeCommit mit git-remote-codecommit.

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

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