Tutorial: Erstellen einer einfachen Pipeline (CodeCommit-Repository)

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 Create (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 die Schritte in diesem Tutorial für Linux-Instances befolgen möchten.

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

      • Wenn Sie die Bereitstellung auf Windows Server-Instances mithilfe 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 YAML-Format, die CodeDeploy zur Verwaltung einer Bereitstellung verwendet wird. Weitere Informationen zu der AppSpec Datei finden Sie unter 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. Für jedes der verschiedenen Ereignisse im CodeDeploy Bereitstellungszyklus wird wie folgt eine Datei geschrieben:

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

        • (Nur Windows-Beispiel) before-install.bat — Dies ist ein Batch-Skript für das BeforeInstall Deployment-Lifecycle-Ereignis, das ausgeführt wird, um alte Dateien zu entfernen, die während früherer Bereitstellungen dieses Beispiels geschrieben wurden, und einen Speicherort auf Ihrer Instanz 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. Verwenden Sie eine der folgenden Methoden, um Dateien in Ihr Repository hochzuladen.

   1. So verwenden Sie die CodeCommit Konsole, um Ihre Dateien hochzuladen:

      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 nun dem main Branch in deinem CodeCommit MyDemoRepo Repository hinzugefügt und können nun in eine Pipeline aufgenommen werden.

So erstellen Sie eine Instance-Rolle

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

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

3. Wählen Sie Rolle erstellen.

4. Wählen Sie unter Typ der vertrauenswürdigen Entität auswählen AWS-Servicedie Option aus. Wählen Sie unter Anwendungsfall auswählen die Option aus EC2. Wählen Sie unter Wählen Sie Ihren Anwendungsfall aus EC2. Wählen Sie Weiter: Berechtigungen aus.

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

6. Suchen Sie nach der genannten 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.

So starten Sie eine Instance

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

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

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 die bereitzustellenden Instanzen auf der Grundlage der Tags aus.

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) bezeichnet und trägt die Bezeichnung „Für das kostenlose Kontingent in Frage“.)

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

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

   Sie können auch Proceed without a key pair 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 Öffentliche IP automatisch zuweisen der Status Enable lautet.

   • Klicken Sie neben Assign a security group (Sicherheitsgruppe zuweisen) auf Create a new security group (Neue Sicherheitsgruppe zuweisen).

   • Wählen Sie in der Zeile für SSH unter Quelltyp die Option Meine IP aus.

   • Wählen Sie Sicherheitsgruppe hinzufügen, wählen Sie 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.. 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 Public DNS nicht angezeigt wird, wählen Sie das Show/Hide-Symbol aus und wählen Sie dann Public DNS aus.)

Um eine CodeDeploy Servicerolle zu erstellen

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

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

3. Wählen Sie Rolle erstellen.

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 CodeDeployaus den aufgelisteten Optionen aus. Wählen Sie Weiter. Die AWSCodeDeployRole-verwaltete Richtlinie ist der Rolle bereits zugewiesen.

5. Wählen Sie Weiter.

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ü „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 aus.

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 Deployment type (Bereitstellungstyp) die Option In-place (Direkt).

5. Wählen Sie unter Umgebungskonfiguration die Option Amazon EC2 Instances aus. Geben Sie im Feld Schlüssel einName. Geben Sie im Feld Wert den Namen ein, mit dem Sie die Instanz markiert haben (z. B.MyCodePipelineDemo).

6. Wählen Sie unter Agentenkonfiguration mit AWS Systems Manager die Option Jetzt 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 Management Console 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.

4. Geben Sie in Schritt 2: Pipeline-Einstellungen auswählen im Feld Pipeline-Name den Wert einMyFirstPipeline.

5. Wählen Sie unter Pipeline-Typ die Option V2 aus. Weitere Informationen finden Sie unter Arten von Pipelines. Wählen Sie Weiter.

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 im Feld Quellanbieter die Option CodeCommit. Wählen Sie unter Repository-Name den Namen des CodeCommit Repositorys aus, in dem Sie es 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 soll.

   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.

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 auf Überspringen klicken. Wählen Sie Weiter.

   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 wählen.

    Wählen Sie Weiter.

11. Wählen Sie in Schritt 6: Bereitstellungsphase hinzufügen unter Bereitstellungsanbieter die Option aus 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. Überprüfen Sie in Schritt 7: Überprüfen Sie die Informationen und wählen Sie dann Pipeline erstellen aus.

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

    

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 Successed für den Pipeline-Status angezeigt wird, wählen Sie im Statusbereich für die Bereitstellungsphase die Option CodeDeploy. Dadurch wird die CodeDeploy Konsole geöffnet. Wenn Succeeded (Erfolgreich) nicht angezeigt wird, finden Sie weitere Informationen unter Problembehebung 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. Dadurch 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 Repository, 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 Eine Pipeline löschen in AWS CodePipeline.

2. Um Ihre CodeDeploy Ressourcen zu bereinigen, folgen Sie den Anweisungen unter Ressourcen zum Aufräumen der Bereitstellung.

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