Tutorial: Erstellen Sie eine Pipeline, die Amazon S3 als Bereitstellungsanbieter verwendet

Um Dateien in dein CodeCommit Repository zu übertragen

1. Extrahieren Sie die heruntergeladenen Beispieldateien. Laden Sie die ZIP Datei nicht in Ihr Repository hoch.

2. Laden Sie die Dateien per Push oder laden Sie sie in Ihr CodeCommit Repository hoch. Diese Dateien sind das Quellartefakt, das vom Assistenten „Pipeline erstellen“ für Ihre Bereitstellungsaktion in CodePipeline erstellt wurde. Ihre Dateien sollten in Ihrem lokalen Verzeichnis wie folgt aussehen:

   index.html
   main.css
   graphic.jpg

3. Du kannst Git oder die CodeCommit Konsole verwenden, um deine Dateien hochzuladen:

   1. So verwenden Sie die Git-Befehlszeile aus einem geklonten Repository auf Ihrem lokalen Computer:

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

         git add -A

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

         git commit -m "Added static website files"

      3. Führe den folgenden Befehl aus, um die Dateien von deinem lokalen Repo in dein CodeCommit Repository zu übertragen:

         git push

   2. 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. Ü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, die Sie hochladen möchten.

So erstellen Sie mit dem Assistenten eine Pipeline

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.

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

3. Geben Sie unter Step 1: Choose pipeline settings (Schritt 1: Auswahl der Pipeline-Einstellungen) unter Pipeline name (Pipeline-Name) MyS3DeployPipeline 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 unter Step 2: Add source stage (Schritt 2: Quell-Phase hinzufügen) unter Source provider (Quell-Anbieter) die Option AWS 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 in Branch name den Namen des Branch aus, der das neueste Code-Update enthält. Sofern Sie keinen anderen Branch für sich erstellt haben, ist nur main verfügbar.

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

   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.

9. Unter Step 4: Add deploy stage (Schritt 4: Bereitstellungsstufe hinzufügen):

   1. Wählen Sie unter Deploy provider (Bereitstellungsanbieter) die Option Amazon S3.

   2. Geben Sie unter Bucket den Namen Ihres öffentlichen Buckets ein.

   3. Wählen Sie Extract file before deploy (Datei vor Bereitstellung extrahieren).

      Anmerkung

      Die Bereitstellung schlägt fehl, wenn Sie nicht Datei vor der Bereitstellung extrahieren auswählen. Das liegt daran, dass die AWS CodeCommit Aktion in Ihrer Pipeline Quellartefakte zippt und es sich bei Ihrer Datei um eine ZIP Datei handelt.

      Wenn die Option Extract file before deploy (Datei vor Bereitstellung extrahieren) aktiviert ist, wird die Option Deployment path (Bereitstellungspfad) angezeigt. Geben Sie den Namen des gewünschten Pfads ein. Dadurch wird eine Ordnerstruktur in Amazon S3 erstellt, in die die Dateien extrahiert werden. Lassen Sie dieses Feld für dieses Tutorial leer.

      

   4. (Optional) In „ACLGespeichert“ können Sie auf die hochgeladenen Artefakte eine Reihe vordefinierter Grants anwendenACL, die als vorgefertigte Grants bezeichnet werden.

   5. (Optional) Geben Sie unter Cache control (Cache-Kontrolle) die Caching-Parameter ein. Sie können hiermit das Caching-Verhalten für Anforderungen/Antworten festlegen. Gültige Werte finden Sie im Cache-ControlHeader-Feld für HTTP Operationen.

   6. Wählen Sie Weiter.

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

11. Nachdem Ihre Pipeline erfolgreich ausgeführt wurde, öffnen Sie die Amazon S3 S3-Konsole und überprüfen Sie, ob Ihre Dateien in Ihrem öffentlichen Bucket wie folgt angezeigt werden:

    index.html
    main.css
    graphic.jpg

12. Greifen Sie auf Ihren Endpunkt zu, um die Website zu testen. Ihr Endpunkt hat das folgende Format: http://bucket-name.s3-website-region.amazonaws.com/.

    Beispielendpunkt: http://my-bucket.s3-website-us-west-2.amazonaws.com/.

    Die Beispiel-Webseite wird angezeigt.

So erstellen Sie die Datei „buildspec.yml“

• Erstellen Sie eine Datei mit dem Namen buildspec.yml und dem folgenden Inhalt. Diese Build-Befehle installieren TypeScript und verwenden den TypeScript Compiler, um den Code in index.ts Code umzuschreiben. JavaScript

  version: 0.2
  
  phases:
    install:
      commands:
        - npm install -g typescript
    build:
      commands:
        - tsc index.ts
  artifacts:
    files:
      - index.js

So erstellen Sie die Datei „index.ts“

• Erstellen Sie eine Datei mit dem Namen index.ts und dem folgenden Inhalt.

  interface Greeting {
      message: string;
  }
  
  class HelloGreeting implements Greeting {
      message = "Hello!";
  }
  
  function greet(greeting: Greeting) {
      console.log(greeting.message);
  }
  
  let greeting = new HelloGreeting();
  
  greet(greeting);

So laden Sie Dateien in Ihren S3-Quell-Bucket hoch

1. Ihre Dateien sollten in Ihrem lokalen Verzeichnis wie folgt aussehen:

   buildspec.yml
   index.ts

   Zippen Sie die Dateien und geben Sie der Datei den Namen source.zip.

2. Wählen Sie in der Amazon S3 S3-Konsole für Ihren Quell-Bucket Upload aus. Wählen Sie Dateien hinzufügen und suchen Sie dann nach der ZIP Datei, die Sie erstellt haben.

3. Klicken Sie auf Hochladen. Diese Dateien sind das Quellartefakt, das vom Assistenten „Pipeline erstellen“ für Ihre Bereitstellungsaktion unter erstellt wurde. CodePipeline Ihre Datei sollte in Ihrem Bucket wie folgt aussehen:

   source.zip

So erstellen Sie mit dem Assistenten eine Pipeline

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.

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

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

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

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

6. Wählen Sie in Step 2: Add source stage (Schritt 2: Quellstufe hinzufügen) unter Source provider (Quellanbieter) die Option Amazon S3. Wählen Sie unter Bucket den Namen Ihres Quell-Buckets aus. Geben Sie im Feld S3-Objektschlüssel den Namen Ihrer ZIP Quelldatei ein. Stellen Sie sicher, dass Sie die Dateierweiterung .zip angeben.

   Wählen Sie Weiter.

7. Unter Schritt 3: Build-Stufe hinzufügen:

   1. Wählen Sie unter Build provider (Build-Anbieter) die Option CodeBuild aus.

   2. Wählen Sie Create build project (Build-Projekt erstellen) aus. Auf der Seite Projekt erstellen:

   3. Geben Sie unter Project name (Projektname) einen Namen für dieses Build-Projekt ein.

   4. Wählen Sie für Environment (Umgebung) die Option Managed image (Verwaltetes Image) aus. Wählen Sie für Operating system (Betriebssystem) die Option Ubuntu aus.

   5. Wählen Sie unter Runtime (Laufzeit) die Option Standard aus. Wählen Sie für Runtime version (Laufzeitversion) aws/codebuild/standard:1.0 aus.

   6. Wählen Sie unter Image version (Abbildversion) die Option Always use the latest image for this runtime version (Immer aktuelles Abbild für diese Laufzeitversion verwenden).

   7. Wählen Sie unter Servicerolle Ihre CodeBuild Servicerolle aus, oder erstellen Sie eine.

   8. Wählen Sie unter Build specifications (Build-Spezifikationen) die Option Use a buildspec file (Eine buildspec-Datei verwenden).

   9. Wählen Sie Weiter zu CodePipeline. Eine Meldung mit dem Hinweis, ob die Erstellung des Projekts erfolgreich war, wird angezeigt.

   10. Wählen Sie Weiter.

8. Unter Step 4: Add deploy stage (Schritt 4: Bereitstellungsstufe hinzufügen):

   1. Wählen Sie unter Deploy provider (Bereitstellungsanbieter) die Option Amazon S3.

   2. Geben Sie unter Bucket den Namen Ihres S3-Ziel-Buckets ein.

   3. Stellen Sie sicher, dass Extract file before deploy (Datei vor Bereitstellung extrahieren) deaktiviert ist.

      Wenn die Option Extract file before deploy (Datei vor Bereitstellung extrahieren) deaktiviert ist, wird die Option S3 object key (S3-Objektschlüssel) angezeigt. Geben Sie den Namen des gewünschten Pfads ein: js-application/{datetime}.zip

      Dadurch wird ein js-application Ordner in Amazon S3 erstellt, in den die Dateien extrahiert werden. In diesem Ordner wird bei Ausführung Ihrer Pipeline mit der Variablen {datetime} ein Zeitstempel für jede Ausgabedatei erstellt.

      

   4. (Optional) In Canned ACL können Sie auf die hochgeladenen Artefakte eine Reihe vordefinierter Grants anwendenACL, die als vorgefertigte Grants bezeichnet werden.

   5. (Optional) Geben Sie unter Cache control (Cache-Kontrolle) die Caching-Parameter ein. Sie können hiermit das Caching-Verhalten für Anforderungen/Antworten festlegen. Gültige Werte finden Sie im Cache-ControlHeader-Feld für HTTP Operationen.

   6. Wählen Sie Weiter.

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

10. Nachdem Ihre Pipeline erfolgreich ausgeführt wurde, sehen Sie sich Ihren Bucket in der Amazon S3 S3-Konsole an. Vergewissern Sie sich, dass Ihre bereitgestellte ZIP Datei in Ihrem Ziel-Bucket unter dem js-application Ordner angezeigt wird. Die in der JavaScript Datei enthaltene ZIP Datei sollte seinindex.js. Die Datei index.js enthält die folgende Ausgabe:

    var HelloGreeting = /** @class */ (function () {
        function HelloGreeting() {
            this.message = "Hello!";
        }
        return HelloGreeting;
    }());
    function greet(greeting) {
        console.log(greeting.message);
    }
    var greeting = new HelloGreeting();
    greet(greeting);