Tutorial: Erstellen Sie eine einfache Pipeline (CodeCommitRepository)

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 zu Ihrem CodeCommit Remote-Repository herzustellen.

1. Wenn Ihr neues Repository in der Konsole geöffnet ist, wählen Sie oben rechts URL auf der Seite die Option Klonen und dann Klonen ausSSH. 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 SSH dabei die 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 im YAML-Format formatierte Datei, 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 Bereitstellungslebenszyklus 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 zum Hochladen Ihrer Dateien:

      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 von Ihrem lokalen Repository in Ihr CodeCommit Repository zu übertragen:

         git push

4. Die Dateien, die Sie heruntergeladen und zu Ihrem lokalen Repo hinzugefügt haben, wurden nun dem main Zweig in Ihrem 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 die Option aus AWS-Service. 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 AMI Linux-Option mit dem AWS Logo und stellen Sie sicher, dass sie ausgewählt ist. (Dies AMI wird als Amazon Linux 2 AMI (HVM) beschrieben 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 eine Verbindung SSH zu Ihren Instances herzustellen, erstellen oder verwenden Sie ein key pair.

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 SSHunter Quelltyp die Option Meine IP aus.

   • Wählen Sie Sicherheitsgruppe hinzufügen HTTP, wählen Sie und wählen Sie dann unter Quelltyp die Option Meine IP aus.

8. Erweitern Sie Advanced Details (Erweiterte Details). Wählen Sie unter 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 Wert1..

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. Nach dem Start der Instanz ändert sich running ihr Status in und sie erhält einen öffentlichen DNS Namen. (Wenn die DNS Spalte Öffentlich nicht angezeigt wird, wählen Sie das Symbol Ein-/Ausblenden und dann Öffentlich 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. 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 die Servicerolle ARN 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 Create pipeline (Pipeline erstellen) aus.

3. Geben Sie unter Step 1: Choose pipeline settings (Schritt 1: Auswahl der Pipeline-Einstellungen) unter Pipeline name (Pipeline-Name) MyFirstPipeline ein.

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

5. Wählen Sie unter Servicerolle die Option Neue Servicerolle aus, CodePipeline um das Erstellen einer Servicerolle in zu ermöglichenIAM.

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

7. Wählen Sie in Schritt 2: Quellstufe hinzufügen im Feld Quellanbieter die Option aus CodeCommit. Wählen Sie unter Repository-Name den Namen des CodeCommit Repositorys aus, in dem Sie es erstellt habenSchritt 1: Erstellen Sie 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.

8. Wählen Sie unter Step 3: Add build stage (Schritt 3: Build-Stufe hinzufügen) die Option Skip build stage (Build-Stufe überspringen) und akzeptieren Sie die Warnmeldung, indem Sie erneut auf Skip (Ü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 ihn CodeBuildin diesem Schritt konfigurieren.

9. Wählen Sie in Schritt 4: 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.

10. Prüfen Sie in Step 5: Review die Informationen und wählen Sie dann Create pipeline aus.

11. 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. Daraufhin wird die EC2-Konsole geöffnet.

4. Kopieren Sie auf der Registerkarte Beschreibung unter Öffentlich DNS die Adresse (z. B.ec2-192-0-2-1.us-west-2.compute.amazonaws.com) und fügen Sie sie dann 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.