Tutorial: Eine einfache Pipeline (CodeCommit Repository) erstellen

Um ein CodeCommit Repository zu erstellen

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

2. Wählen Sie in der Regionsauswahl den Ort aus, AWS-Region an dem Sie das Repository und die Pipeline erstellen möchten. Weitere Informationen finden Sie unter AWS-Regionen und Endpunkte.

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

5. Wählen Sie Erstellen aus.

So richten Sie ein lokales Repository ein

In diesem Schritt richten Sie ein lokales Repository ein, um eine Verbindung mit Ihrem Remote- CodeCommit-Repository herzustellen.

1. Wenn Ihr neues Repository in der Konsole geöffnet ist, wählen Sie Clone URL (URL klonen) oben rechts auf der Seite und dann Clone SSH (SSH klonen) aus. Die Adresse zum Klonen Ihres Git-Repositorys wird in die Zwischenablage kopiert.

2. Navigieren Sie in Ihrem Terminal oder in der Befehlszeile zu einem lokalen Verzeichnis, in dem Ihr lokales Repository gespeichert werden soll. In diesem Tutorial verwenden wir /tmp.

3. Führen Sie den folgenden Befehl aus, um das Repository zu klonen. Ersetzen Sie dabei die SSH-Adresse durch die Adresse, die Sie im vorherigen Schritt kopiert haben. Mit diesem Befehl wird ein Verzeichnis namens MyDemoRepo erstellt. Kopieren Sie eine Beispielanwendung in dieses Verzeichnis.

   git clone ssh://git-codecommit.us-west-2.amazonaws.com/v1/repos/MyDemoRepo

1. Laden Sie als Nächstes ein Beispiel herunter und speichern Sie es in einem Ordner oder Verzeichnis auf Ihrem lokalen Computer.

   1. Wählen Sie eine der folgenden Optionen aus. Wählen Sie aus, SampleApp_Linux.zip ob Sie den Schritten in diesem Tutorial für Linux-Instances folgen möchten.

      • Wenn Sie die Bereitstellung auf Amazon Linux-Instances mit durchführen möchten CodeDeploy, laden Sie die Beispielanwendung hier herunter: SampleApp _ Linux.zip.

      • Wenn Sie die Bereitstellung auf Windows Server-Instances mit durchführen möchten CodeDeploy, laden Sie die Beispielanwendung hier herunter: SampleApp _ Windows.zip.

      Die Beispielanwendung enthält die folgenden Dateien für die Bereitstellung mit CodeDeploy:

      • appspec.yml— Die Anwendungsspezifikationsdatei (AppSpecDatei) ist eine Datei im http://www.yaml.org YAML-Format, die von CodeDeploy zur Verwaltung einer Bereitstellung verwendet wird. Weitere Informationen zur Datei finden Sie unter AppSpec CodeDeploy AppSpec Dateireferenz im AWS CodeDeploy Benutzerhandbuch.

      • index.html— Die Indexdatei enthält die Homepage für die bereitgestellte Beispielanwendung.

      • LICENSE.txt— Die Lizenzdatei enthält Lizenzinformationen für die Beispielanwendung.

      • Dateien für Skripts — Die Beispielanwendung verwendet Skripts, um Textdateien an einen Speicherort auf Ihrer Instance zu schreiben. Eine Datei wird für jedes der Ereignisse im Lebenszyklus einer CodeDeploy Bereitstellung wie folgt geschrieben:

        • scriptsOrdner (nur Linux-Beispiel) — Der Ordner enthält die folgenden Shell-Skripts zum Installieren von Abhängigkeiten und zum Starten und Stoppen der Beispielanwendung für die automatische Bereitstellung: install_dependenciesstart_server, undstop_server.

        • (Nur Windows-Beispiel) before-install.bat — Dies ist ein Batch-Skript für das Ereignis im Lebenszyklus der BeforeInstall Bereitstellung, das ausgeführt wird, um alte Dateien zu entfernen, die bei früheren Bereitstellungen dieses Beispiels geschrieben wurden, und einen Speicherort auf Ihrer Instance zu erstellen, in den die neuen Dateien geschrieben werden.

   2. Laden Sie die komprimierte ZIP-Datei herunter.

2. Entpacken Sie die Dateien aus SampleApp _ Linux.zip in das lokale Verzeichnis, das Sie zuvor erstellt haben (z. B. /tmp/MyDemoRepo oderc:\temp\MyDemoRepo).

   Stellen Sie sicher, dass Sie die Dateien direkt in Ihrem lokalen Repository platzieren. Beziehen Sie keinen SampleApp_Linux Ordner ein. Auf Ihrem lokalen Linux-, macOS- oder Unix-Computer sollte Ihre Verzeichnis- und Dateihierarchie beispielsweise so aussehen:

   /tmp
      └-- MyDemoRepo
          │-- appspec.yml
          │-- index.html
          │-- LICENSE.txt
          └-- scripts
              │-- install_dependencies
              │-- start_server
              └-- stop_server

3. Verwende eine der folgenden Methoden, um Dateien in dein Repository hochzuladen.

   1. Um die CodeCommit Konsole zum Hochladen deiner Dateien zu verwenden:

      1. Öffnen Sie die CodeCommit Konsole und wählen Sie Ihr Repository aus der Repository-Liste aus.

      2. Wählen Sie Add file (Datei hinzufügen) und dann Upload file (Datei hochladen) aus.

      3. Wählen Sie Choose file (Datei auswählen) und navigieren Sie dann zu Ihrer Datei. Um eine Datei unter einem Ordner hinzuzufügen, wählen Sie Datei erstellen und geben Sie dann den Ordnernamen mit dem Dateinamen ein, z. B. scripts/install_dependencies Fügen Sie den Dateiinhalt in die neue Datei ein.

         Übernehmen Sie die Änderung, indem Sie Ihren Benutzernamen und Ihre E-Mail-Adresse eingeben.

         Wählen Sie Commit changes (Änderungen übernehmen) aus.

      4. Wiederholen Sie diesen Schritt für jede Datei.

         Der Inhalt Ihres Repositorys sollte wie folgt aussehen:

         
                │-- appspec.yml
                │-- index.html
                │-- LICENSE.txt
                └-- scripts
                    │-- install_dependencies
                    │-- start_server
                    └-- stop_server

   2. So verwendest du Git-Befehle, um deine Dateien hochzuladen:

      1. Ändern von Verzeichnisses in Ihrem lokalen Repository:

         (For Linux, macOS, or Unix) cd /tmp/MyDemoRepo
         (For Windows) cd c:\temp\MyDemoRepo

      2. Führen Sie den folgenden Befehl aus, um alle Dateien auf einmal zu übertragen:

         git add -A

      3. Führen Sie den folgenden Befehl aus, um einen Commit für Dateien mit einer Commit-Nachricht durchzuführen:

         git commit -m "Add sample application files"

      4. Führen Sie den folgenden Befehl aus, um die Dateien aus Ihrem lokalen Repository in Ihr CodeCommit-Repository zu übertragen:

         git push

4. Die Dateien, die du heruntergeladen und zu deinem lokalen Repo hinzugefügt hast, wurden jetzt zum main Branch in deinem CodeCommit MyDemoRepo Repository hinzugefügt und sind bereit, in eine Pipeline aufgenommen zu werden.

So erstellen Sie eine Instance-Rolle

1. Öffnen Sie unter https://console.aws.amazon.com/iam/ die IAM-Konsole.

2. Wählen Sie im Dashboard der Konsole die Option Rollen aus.

3. Wählen Sie Rolle erstellen aus.

4. Wählen Sie unter Typ der vertrauenswürdigen Entität auswählen die Option aus. AWS-Service Wählen Sie unter Wählen Sie einen Anwendungsfall die Option EC2 aus. Wählen Sie in Select your use case (Anwendungsfall auswählen) die Option EC2 aus. Wählen Sie Weiter: Berechtigungen aus.

5. Suchen Sie nach der benannten AmazonEC2RoleforAWSCodeDeploy Richtlinie und wählen Sie sie aus.

6. Suchen Sie nach der benannten Richtlinie und wählen Sie sie aus AmazonSSMManagedInstanceCore. Wählen Sie Next: Tags (Weiter: Tags) aus.

7. Klicken Sie auf Weiter: Prüfen. Geben Sie einen Namen für die Rolle ein (z. B. EC2InstanceRole).

   Anmerkung

   Notieren Sie sich Ihren Rollennamen für den nächsten Schritt. Sie wählen diese Rolle, wenn Sie Ihre Instance erstellen.

   Wählen Sie Rolle erstellen aus.

So starten Sie eine Instance

1. Öffnen Sie die Amazon-EC2-Konsole unter https://console.aws.amazon.com/ec2/.

2. Wählen Sie in der Seitennavigation Instances aus und klicken Sie oben auf der Seite auf Launch Instances.

3. Geben Sie unter Name MyCodePipelineDemo ein. Dadurch wird der Instance ein Tag-Schlüssel von Name und ein Tag-Wert von MyCodePipelineDemo zugewiesen. Später erstellen Sie eine CodeDeploy Anwendung, die die Beispielanwendung auf dieser Instanz bereitstellt. CodeDeploywählt anhand der Tags die Instanzen aus, die bereitgestellt werden sollen.

4. Suchen Sie unter Anwendungs- und Betriebssystem-Images (Amazon Machine Image) die Amazon Linux AMI-Option mit dem AWS Logo und stellen Sie sicher, dass sie ausgewählt ist. (Dieses AMI wird als Amazon Linux 2 AMI (HVM) beschrieben und trägt die Bezeichnung „Kostenloses Kontingent berechtigt“.)

5. Wählen Sie unter Instance-Typ den t2.micro Typ aus, der für das kostenlose Kontingent in Frage kommt, als Hardwarekonfiguration für Ihre Instance.

6. Wählen Sie unter Schlüsselpaar (Anmeldung) ein Schlüsselpaar aus oder erstellen Sie eines.

   Sie können auch Ohne Schlüsselpaar fortfahren wählen.

   Anmerkung

   Für die Zwecke dieses Tutorials können Sie ohne Schlüsselpaar fortfahren. Um SSH zu verwenden, wenn eine Verbindung zu Ihren Instances herstellen, erstellen Sie ein Schlüsselpaar oder verwenden Sie ein vorhandenes.

7. Gehen Sie unter Netzwerkeinstellungen wie folgt vor.

   Vergewissern Sie sich, dass unter Auto-assign Öffentliche IP der Status Aktiviert lautet.

   Wählen Sie für die erstellte Sicherheitsgruppe HTTP und dann unter Quelltyp die Option Meine IP aus.

8. Erweitern Sie Advanced Details (Erweiterte Details). Wählen Sie im IAM-Instanzprofil die IAM-Rolle aus, die Sie im vorherigen Verfahren erstellt haben (z. B.EC2InstanceRole).

9. Geben Sie unter Zusammenfassung unter Anzahl der Instanzen den Wert ein. 1

10. Wählen Sie Launch Instance (Instance starten) aus.

11. Sie können den Status des Starts auf der Seite Instances anzeigen. Wenn Sie eine Instance starten, lautet ihr anfänglicher Status pending. Nachdem die Instance gestartet ist, lautet ihr Status running. Sie erhält dann einen öffentlichen DNS-Namen. (Wenn die Spalte Öffentliches DNS nicht angezeigt wird, wählen Sie das Show/Hide Symbol und dann Public DNS aus.)

Um eine CodeDeploy Servicerolle zu erstellen

1. Öffnen Sie unter https://console.aws.amazon.com/iam/ die IAM-Konsole.

2. Wählen Sie im Dashboard der Konsole die Option Rollen aus.

3. Wählen Sie Rolle erstellen aus.

4. Wählen Sie unter Vertrauenswürdige Entität auswählen die Option AWS-Service. Wählen Sie unter Use case (Anwendungsfall) CodeDeploy aus. Wählen Sie CodeDeploy aus den aufgelisteten Optionen. Wählen Sie Weiter aus. Die AWSCodeDeployRole-verwaltete Richtlinie ist der Rolle bereits zugewiesen.

5. Wählen Sie Weiter aus.

6. Geben Sie einen Namen für die Rolle ein (beispielsweise CodeDeployRole) und wählen Sie Next (Weiter) aus.

Um eine Anwendung zu erstellen in CodeDeploy

1. Öffnen Sie die CodeDeploy Konsole unter https://console.aws.amazon.com/codedeploy.

2. Wenn die Seite „Anwendungen“ nicht angezeigt wird, wählen Sie im Menü die Option „Anwendungen“.

3. Wählen Sie Create application aus.

4. Geben Sie unter Application name (Anwendungsname) MyDemoApplication ein.

5. Wählen Sie unter Compute Platform die Option EC2/On-premises.

6. Wählen Sie Create application aus.

Um eine Bereitstellungsgruppe zu erstellen in CodeDeploy

Eine Bereitstellungsgruppe ist eine Ressource, die Bereitstellungseinstellungen definiert, z. B. für welche Instances und wie schnell sie bereitgestellt werden sollen.

1. Wählen Sie auf der Seite mit Ihrer Anwendung Create deployment group (Bereitstellungsgruppe erstellen).

2. Geben Sie unter Deployment group name (Name der Bereitstellungsgruppe) MyDemoDeploymentGroup ein.

3. Wählen Sie unter Servicerolle den ARN der Servicerolle aus, die Sie zuvor erstellt haben (z. B.arn:aws:iam::account_ID:role/CodeDeployRole).

4. Wählen Sie unter Bereitstellungstyp die Option aus In-place.

5. Wählen Sie unter Environment configuration (Umgebungskonfiguration) die Option Amazon EC2-Instances aus. Geben Sie in das Feld Schlüssel einName. Geben Sie im Feld Wert den Namen ein, den Sie zum Markieren der Instanz verwendet haben (z. B.MyCodePipelineDemo).

6. Wählen Sie unter Agentenkonfiguration mit AWS Systems Manager die Option Jetzt aus und planen Sie Updates. Dadurch wird der Agent auf der Instanz installiert. Die Linux-Instanz ist bereits mit dem SSM-Agenten konfiguriert und wird nun mit dem CodeDeploy Agenten aktualisiert.

7. Wählen Sie in Deployment configuration (Bereitstellungskonfiguration) die Option CodeDeployDefault.OneAtaTime aus.

8. Stellen Sie sicher, dass unter Load Balancer die Option Load Balancing aktivieren nicht ausgewählt ist. Sie müssen keinen Load Balancer einrichten oder eine Zielgruppe für dieses Beispiel auswählen.

9. Wählen Si Create deployment group (Bereitstellungsgruppe erstellen).

Um eine CodePipeline Pipeline zu erstellen

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CodePipeline Konsole unter http://console.aws.amazon.com/codesuite/codepipeline/home.

   Öffnen Sie die CodePipeline Konsole unter https://console.aws.amazon.com/codepipeline/.

2. Wählen sie auf der Seite Welcome (Willkommen) die Option Getting started (Erste Schritte) aus, oder auf der Seite Pipelines die Option Create pipeline (Pipeline erstellen).

3. Wählen Sie auf der Seite Schritt 1: Erstellungsoption auswählen unter Erstellungsoptionen die Option Benutzerdefinierte Pipeline erstellen aus. Wählen Sie Weiter aus.

4. Geben Sie auf Schritt 2: Wählen Sie die Pipeline-Einstellungen aus und geben Sie im Feld Pipeline-Name den Wert einMyFirstPipeline.

5. CodePipeline bietet Pipelines vom Typ V1 und V2, die sich in Eigenschaften und Preis unterscheiden. Der Typ V2 ist der einzige Typ, den Sie in der Konsole auswählen können. Weitere Informationen finden Sie unter Pipeline-Typen. Informationen zur Preisgestaltung für finden Sie CodePipeline unter Preisgestaltung.

6. Wählen Sie unter Servicerolle die Option Neue Servicerolle aus, um CodePipeline die Erstellung einer Servicerolle in IAM zu ermöglichen.

7. Belassen Sie die Einstellungen unter Erweiterte Einstellungen bei den Standardeinstellungen, und wählen Sie dann Next (Weiter) aus.

8. Wählen Sie in Schritt 3: Quellstufe hinzufügen unter Quellanbieter die Option aus CodeCommit. Wählen Sie unter Repository-Name den Namen des CodeCommit Repositorys aus, in dem Sie erstellt habenSchritt 1: Erstelle ein CodeCommit Repository. Wählen Sie unter Branch name (Name der Verzweigung) die Option main und dann Next step (Nächster Schritt) aus.

   Nachdem Sie den Repository-Namen und den Branch ausgewählt haben, wird in einer Meldung die Amazon CloudWatch Events-Regel angezeigt, die für diese Pipeline erstellt werden muss.

   Lassen Sie die Standardwerte in Change detection options unverändert. Auf diese Weise können CodePipeline Sie Amazon CloudWatch Events verwenden, um Änderungen in Ihrem Quell-Repository zu erkennen.

   Wählen Sie Weiter aus.

9. Wählen Sie in Schritt 4: Build-Phase hinzufügen die Option Build-Phase überspringen und akzeptieren Sie dann die Warnmeldung, indem Sie erneut Skip wählen. Wählen Sie Weiter aus.

   Anmerkung

   In diesem Tutorial stellen Sie Code bereit, der keinen Build-Service erfordert, sodass Sie diesen Schritt überspringen können. Wenn Ihr Quellcode jedoch erstellt werden muss, bevor er für Instances bereitgestellt wird, können Sie in diesem Schritt CodeBuild konfigurieren.

10. Wählen Sie in Schritt 5: Testphase hinzufügen die Option Testphase überspringen aus und akzeptieren Sie dann die Warnmeldung, indem Sie erneut Überspringen auswählen.

    Wählen Sie Weiter aus.

11. Wählen Sie in Schritt 6: Bereitstellungsphase hinzufügen unter Bereitstellungsanbieter die Option CodeDeploy. Wählen Sie unter Application name (Anwendungsname) die Option MyDemoApplication aus. Wählen Sie unter Deployment group (Bereitstellungsgruppe) die Option MyDemoDeploymentGroup , und dann Next step (Nächster Schritt) aus.

12. In Schritt 7: Überprüfen, überprüfen Sie die Informationen und wählen Sie dann Create pipeline aus.

13. Die Pipeline wird ausgeführt, nachdem sie erstellt wurde. Es lädt den Code aus Ihrem CodeCommit Repository herunter und erstellt eine CodeDeploy Bereitstellung für Ihre EC2-Instance. Sie können den Fortschritt sowie Erfolgs- und Fehlernachrichten einsehen, während das CodePipeline Beispiel die Webseite für die Amazon EC2-Instance in der Bereitstellung bereitstellt. CodeDeploy

    

So verifizieren Sie, ob Ihre Pipeline erfolgreich ausgeführt wurde

1. Zeigen Sie den anfänglichen Fortschritt der Pipeline an. Der Status jeder Phase ändert sich von Zurzeit keine Ausführungen zu Laufend. Danach ändert er sich entweder zu Erfolgreich oder Fehlgeschlagen. Die Pipeline sollte die erste Ausführung innerhalb weniger Minuten abschließen.

2. Nachdem „Erfolgreich“ für den Pipeline-Status angezeigt wird, wählen Sie im Statusbereich der Bereitstellungsphase die Option CodeDeploy. Dadurch wird die CodeDeploy Konsole geöffnet. Wenn Erfolgreich nicht angezeigt wird, finden Sie weitere Informationen unterProblembehebung CodePipeline.

3. Wählen Sie in der Registerkarte Deployments (Bereitstellungen) die Bereitstellungs-ID aus. Wählen Sie auf der Seite für die Bereitstellung unter Deployment lifecycle events (Bereitstellungslebenszyklusereignisse) die Instance-ID aus. Daraufhin wird die EC2-Konsole geöffnet.

4. Kopieren Sie in der Registerkarte Description (Beschreibung) in Public DNS (Öffentliches DNS) die Adresse (z. B. ec2-192-0-2-1.us-west-2.compute.amazonaws.com) und fügen Sie diese in die Adressleiste Ihres Webbrowsers ein.

   Die Webseite für die Beispielanwendung, die Sie heruntergeladen und in Ihr CodeCommit Repository übertragen haben, wird angezeigt.

1. Ändern von Verzeichnisses in Ihrem lokalen Repository:

   (For Linux, macOS, or Unix) cd /tmp/MyDemoRepo
   (For Windows) cd c:\temp\MyDemoRepo

2. Verwenden Sie einen Texteditor zum Ändern der index.html-Datei:

   (For Linux or Unix)gedit index.html
   (For OS X)open –e index.html
   (For Windows)notepad index.html

3. Ändern Sie den Inhalt der index.html-Datei auf die gewünschte Hintergrundfarbe und ändern Sie einigen Text auf der Webseite. Speichern Sie dann die Datei.

   <!DOCTYPE html>
   <html>
   <head>
     <title>Updated Sample Deployment</title>
     <style>
       body {
         color: #000000;
         background-color: #CCFFCC;
         font-family: Arial, sans-serif;  
         font-size:14px;
       }
           
       h1 {
         font-size: 250%;
         font-weight: normal;
         margin-bottom: 0;
       }
       
       h2 {
         font-size: 175%;
         font-weight: normal;
         margin-bottom: 0;
       }
     </style>
   </head>
   <body>
     <div align="center"><h1>Updated Sample Deployment</h1></div>
     <div align="center"><h2>This application was updated using CodePipeline, CodeCommit, and CodeDeploy.</h2></div>
     <div align="center">
       <p>Learn more:</p> 
       <p><a href="https://docs.aws.amazon.com/codepipeline/latest/userguide/">CodePipeline User Guide</a></p>
       <p><a href="https://docs.aws.amazon.com/codecommit/latest/userguide/">CodeCommit User Guide</a></p>
       <p><a href="https://docs.aws.amazon.com/codedeploy/latest/userguide/">CodeDeploy User Guide</a></p>
     </div>
   </body>
   </html>

4. Übernehmen Sie Ihre Änderungen und übertragen Sie sie in Ihr CodeCommit Projektarchiv, indem Sie nacheinander die folgenden Befehle ausführen:

   git commit -am "Updated sample application files"

   git push

So verifizieren Sie, ob Ihre Pipeline erfolgreich ausgeführt wurde

1. Zeigen Sie den anfänglichen Fortschritt der Pipeline an. Der Status jeder Phase ändert sich von Zurzeit keine Ausführungen zu Laufend. Danach ändert er sich entweder zu Erfolgreich oder Fehlgeschlagen. Die Ausführung der Pipeline sollte innerhalb weniger Minuten abgeschlossen sein.

2. Nachdem Succeeded (Erfolgreich) für den Aktionsstatus angezeigt wird, aktualisieren Sie die Demo-Seite, auf die Sie zuvor in Ihrem Browser zugegriffen haben.

   Die aktualisierte Webseite wird angezeigt.

So bereinigen Sie die in diesem Tutorial verwendeten Ressourcen

1. Um Ihre CodePipeline Ressourcen zu bereinigen, folgen Sie den Anweisungen unter Löschen einer Pipeline in AWS CodePipeline.

2. Um Ihre CodeDeploy Ressourcen zu bereinigen, folgen Sie den Anweisungen unter Ressourcen zur Bereinigung der Bereitstellung.

3. Folgen Sie den Anweisungen unter Löschen eines CodeCommit Repositorys, um das CodeCommit Repository zu löschen.