Erstellen Sie eine Pipeline, Stufen und Aktionen

Schritt 1: Erstellen Sie Ihre Pipeline und geben Sie ihr einen Namen

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

2. Klicken Sie auf der Seite Welcome auf Create pipeline.

   Wenn Sie es zum ersten Mal verwenden CodePipeline, wählen Sie Erste Schritte.

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 der Seite „Schritt 2: Pipeline-Einstellungen auswählen“ im Feld Pipeline-Name den Namen für Ihre Pipeline ein.

   In einem einzelnen AWS Konto muss jede Pipeline, die Sie in einer AWS Region erstellen, einen eindeutigen Namen haben. Namen können für Pipelines in anderen Regionen wiederverwendet werden.

   Anmerkung

   Der Name einer erstellten Pipeline kann nicht nachträglich geändert werden. Weitere Informationen zu Einschränkungen finden Sie unter Kontingente in AWS CodePipeline.

5. Wählen Sie unter Pipeline-Typ eine der folgenden Optionen aus. Die Pipeline-Typen unterscheiden sich in ihren Eigenschaften und ihrem Preis. Weitere Informationen finden Sie unter Pipeline-Typen.

   • Pipelines vom Typ V1 haben eine JSON-Struktur, die Standardparameter auf Pipeline-, Stufen- und Aktionsebene enthält.

   • Pipelines vom Typ V2 haben dieselbe Struktur wie ein V1-Typ und bieten zusätzliche Parameterunterstützung, z. B. Trigger für Git-Tags und Variablen auf Pipeline-Ebene.

6. Führen Sie unter Service role (Service-Rolle) einen der folgenden Schritte aus:

   • Wählen Sie Neue Servicerolle, um das Erstellen einer neuen Servicerolle in IAM CodePipeline zu ermöglichen.

   • Wählen Sie Existing service role (Vorhandene Servicerolle), um eine Servicerolle zu verwenden, die in IAM bereits erstellt wurde. Wählen Sie unter Role ARN (Rollen-ARN) Ihren Servicerollen-ARN aus der Liste aus.

   Anmerkung

   Je nachdem, wann Ihre Servicerolle erstellt wurde, müssen Sie möglicherweise ihre Berechtigungen aktualisieren, um weitere AWS-Services Funktionen zu unterstützen. Weitere Informationen finden Sie unter Fügen Sie der CodePipeline Servicerolle Berechtigungen hinzu.

   Weitere Informationen über die Service-Rolle und ihre Richtlinienanweisung finden Sie unter Verwalten Sie die CodePipeline Servicerolle.

7. (Optional) Wählen Sie unter Variablen die Option Variable hinzufügen aus, um Variablen auf Pipeline-Ebene hinzuzufügen.

   Weitere Hinweise zu Variablen auf Pipeline-Ebene finden Sie unterVariablenreferenz. Ein Tutorial mit einer Variablen auf Pipeline-Ebene, die bei der Ausführung der Pipeline übergeben wird, finden Sie unter. Tutorial: Variablen auf Pipeline-Ebene verwenden

   Anmerkung

   Es ist zwar optional, Variablen auf Pipeline-Ebene hinzuzufügen, aber bei einer Pipeline, die mit Variablen auf Pipeline-Ebene angegeben ist und für die keine Werte bereitgestellt werden, schlägt die Pipeline-Ausführung fehl.

8. (Optional) Erweitern Sie den Abschnitt Advanced Settings (Erweiterte Einstellungen).

9. Führen Sie unter Artifact store (Artefakt speichern) einen der folgenden Schritte aus:

   1. Wählen Sie Standardspeicherort, um den Standard-Artefaktspeicher, wie z. B. den als Standard ausgewiesenen S3-Artefakt-Bucket, für Ihre Pipeline in der Pipeline zu verwenden, die AWS-Region Sie für Ihre Pipeline ausgewählt haben.

   2. Wählen Sie Custom location (Benutzerdefinierter Speicherort), wenn Sie in derselben Region wie Ihre Pipeline bereits über einen Artefakt-Speicher, wie z. B. einen S3-Artefakt-Bucket, verfügen. Wählen Sie unter Bucket den Bucket-Namen aus.

   Anmerkung

   Dabei handelt es sich nicht um den Quell-Bucket für Ihren Quellcode, sondern um den Artefaktspeicher für Ihre Pipeline. Für jede Pipeline benötigen Sie einen separaten Artefaktspeicher, z. B. einen S3 Bucket. Wenn Sie eine Pipeline erstellen oder bearbeiten, benötigen Sie einen Artefakt-Bucket in der Pipeline-Region und einen Artefakt-Bucket pro AWS Region, in der Sie eine Aktion ausführen.

   Weitere Informationen erhalten Sie unter Eingabe- und Ausgabe-Artefakte und CodePipeline Referenz zur Pipeline-Struktur.

10. Führen Sie unter Encryption key (Verschlüsselungsschlüssel) einen der folgenden Schritte aus:

    1. Um den CodePipeline Standard AWS KMS key zum Verschlüsseln der Daten im Pipeline-Artefaktspeicher (S3-Bucket) zu verwenden, wählen Sie Default Managed Key aus. AWS

    2. Um Ihren vom Kunden verwalteten Schlüssel zum Verschlüsseln der Daten im Pipeline-Artefaktspeicher (S3-Bucket) zu verwenden, wählen Sie Customer Managed Key aus. Wählen Sie die Schlüssel-ID, den Schlüssel-ARN oder den Alias-ARN.

11. Wählen Sie Weiter aus.

Schritt 2: Erstellen Sie eine Quellstufe

1. Wählen Sie auf der Seite Schritt 3: Quellstufe hinzufügen unter Quellanbieter den Repository-Typ aus, in dem Ihr Quellcode gespeichert ist, und geben Sie die erforderlichen Optionen an. Die zusätzlichen Felder werden je nach ausgewähltem Quellanbieter wie folgt angezeigt.

   • Für Bitbucket Cloud GitHub (per GitHub App), GitHub Enterprise Server oder GitLab selbstverwaltet: GitLab.com

     1. Wähle unter Verbindung eine bestehende Verbindung aus oder erstelle eine neue. Informationen zum Erstellen oder Verwalten einer Verbindung für Ihre GitHub Quellaktion finden Sie unterGitHub Verbindungen.

     2. Wählen Sie das Repository aus, das Sie als Quellspeicherort für Ihre Pipeline verwenden möchten.

        Wählen Sie, ob Sie einen Trigger hinzufügen oder nach Triggertypen filtern möchten, um Ihre Pipeline zu starten. Weitere Informationen zum Arbeiten mit Triggern finden Sie unterTrigger mit Code-Push- oder Pull-Request-Ereignistypen hinzufügen. Weitere Hinweise zum Filtern mit Glob-Mustern finden Sie unterArbeiten mit Glob-Mustern in der Syntax.

     3. Wählen Sie unter Ausgabe-Artefaktformat das Format für Ihre Artefakte aus.

        • Um die Ausgabeartefakte der GitHub Aktion mit der Standardmethode zu speichern, wählen Sie CodePipeline Standard. Die Aktion greift auf die Dateien aus dem GitHub Repository zu und speichert die Artefakte in einer ZIP-Datei im Pipeline-Artefaktspeicher.

        • Um eine JSON-Datei zu speichern, die einen URL-Verweis auf das Repository enthält, damit Downstream-Aktionen Git-Befehle direkt ausführen können, wählen Sie Full clone (Vollständiger Klon). Diese Option kann nur von CodeBuild nachgeschalteten Aktionen verwendet werden.

          Wenn Sie diese Option wählen, müssen Sie die Berechtigungen für Ihre CodeBuild Projektservice-Rolle aktualisieren, wie unter gezeigt. Problembehebung CodePipeline Ein Tutorial, das Ihnen zeigt, wie Sie die Option „Vollständiger Klon“ verwenden, finden Sie unterTutorial: Vollständigen Klon mit einer GitHub Pipeline-Quelle verwenden.

   • Für Amazon S3:

     1. Geben Sie in Amazon S3 location (Amazon S3-Speicherort) den S3-Bucket-Namen und den Pfad zum Objekt in einem Bucket mit aktiviertem Versioning an. Das Format des Bucket-Namens und der Pfad sehen etwa so aus:

         s3://bucketName/folderName/objectName

        Anmerkung

        Wenn Amazon S3 der Quellanbieter für Ihre Pipeline ist, können Sie Ihre Quelldatei (en) in eine einzige ZIP-Datei komprimieren und die ZIP-Datei in Ihren Quell-Bucket hochladen. Sie können auch eine einzelne Datei ungezippt hochladen, aber nachgelagerte Aktionen, die eine ZIP-Datei erwarten, schlagen dann fehl.

     2. Nachdem Sie den S3-Quell-Bucket ausgewählt haben, CodePipeline erstellt er die Amazon CloudWatch Events-Regel und den AWS CloudTrail Trail, der für diese Pipeline erstellt werden soll. Lassen Sie die Standardwerte in Change detection options (Optionen für die Änderungserkennung) unverändert. Auf diese Weise können CodePipeline Sie Amazon CloudWatch Events verwenden und AWS CloudTrail Änderungen für Ihre neue Pipeline erkennen. Wählen Sie Weiter aus.

   • Für AWS CodeCommit:

     • Wählen Sie unter Repository-Name den Namen des CodeCommit Repositorys aus, das Sie als Quellspeicherort für Ihre Pipeline verwenden möchten. Wählen Sie in Branch name aus der Dropdown-Liste die Verzweigung aus, die Sie verwenden möchten.

     • Wählen Sie unter Ausgabe-Artefaktformat das Format für Ihre Artefakte aus.

       • Um die Ausgabeartefakte der CodeCommit Aktion mit der Standardmethode zu speichern, wählen Sie CodePipeline Standard. Die Aktion greift auf die Dateien aus dem CodeCommit Repository zu und speichert die Artefakte in einer ZIP-Datei im Pipeline-Artefaktspeicher.

       • Um eine JSON-Datei zu speichern, die einen URL-Verweis auf das Repository enthält, damit Downstream-Aktionen Git-Befehle direkt ausführen können, wählen Sie Full clone (Vollständiger Klon). Diese Option kann nur von CodeBuild nachgeschalteten Aktionen verwendet werden.

         Wenn Sie diese Option wählen, müssen Sie die codecommit:GitPull Berechtigung Ihrer CodeBuild Servicerolle hinzufügen, wie unter gezeigt. Fügen Sie CodeBuild GitClone Berechtigungen für CodeCommit Quellaktionen hinzu Sie müssen außerdem die codecommit:GetRepository Berechtigungen zu Ihrer CodePipeline Servicerolle hinzufügen, wie unter gezeigtFügen Sie der CodePipeline Servicerolle Berechtigungen hinzu. Ein Tutorial, das Ihnen zeigt, wie Sie die Option „Vollständiger Klon“ verwenden, finden Sie unterTutorial: Vollständigen Klon mit einer GitHub Pipeline-Quelle verwenden.

     • Nachdem Sie den CodeCommit Repository-Namen und den Branch ausgewählt haben, wird in den Optionen zur Änderungserkennung eine Meldung angezeigt, die die Amazon CloudWatch Events-Regel enthält, die für diese Pipeline erstellt werden muss. Lassen Sie die Standardwerte in Change detection options (Optionen für die Änderungserkennung) unverändert. Auf diese Weise können CodePipeline Sie Amazon CloudWatch Events verwenden, um Änderungen an Ihrer neuen Pipeline zu erkennen.

   • Für Amazon ECR:

     • Wählen Sie unter Repository-Name den Namen Ihres Amazon ECR-Repositorys aus.

     • Geben Sie im Feld Image tag (Image-Tag) den Image-Namen und die Version an, falls sie nicht LATEST lautet.

     • Wählen Sie unter Ausgabeartefakte den Standard für das Ausgabe-Artefakt aus, z. B. MyApp, der den Image-Namen und die Repository-URI-Informationen enthält, die Sie in der nächsten Stufe verwenden möchten.

       Ein Tutorial zum Erstellen einer Pipeline für Amazon ECS mit CodeDeploy blaugrünen Bereitstellungen, die eine Amazon ECR-Quellstufe umfasst, finden Sie unter. Tutorial: Erstellen Sie eine Pipeline mit einer Amazon ECR-Quelle und Bereitstellung ECS-to-CodeDeploy

     Wenn Sie eine Amazon ECR-Quellstufe in Ihre Pipeline aufnehmen, generiert die Quellaktion eine imageDetail.json Datei als Ausgabeartefakt, wenn Sie eine Änderung festschreiben. Informationen zur imageDetail.json-Datei finden Sie unter Detail.json Image-Datei für Amazon blue/green ECS-Bereitstellungsaktionen.

   Anmerkung

   Das Objekt und der Dateityp müssen mit dem Bereitstellungssystem kompatibel sein, das Sie verwenden möchten (z. B. Elastic Beanstalk oder). CodeDeploy Beispiele für unterstützte Dateitypen sind ZIP, TAR und TGZ. Weitere Informationen zu den unterstützten Containertypen für Elastic Beanstalk finden Sie unter Anpassen und Konfigurieren von Elastic Beanstalk-Umgebungen und unterstützten Plattformen. https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/concepts.platforms.html Weitere Informationen zur Bereitstellung von Revisionen mit finden Sie unter Hochladen Ihrer CodeDeploy Anwendungsrevision und Vorbereiten einer Revision. https://docs.aws.amazon.com/codedeploy/latest/userguide/how-to-prepare-revision.html

2. Um die Phase für die automatische Wiederholung zu konfigurieren, wählen Sie Automatische Wiederholung bei Ausfall der Phase aktivieren. Weitere Hinweise zur automatischen Wiederholung finden Sie unter. Konfigurieren Sie eine Phase für die automatische Wiederholung bei einem Fehler

3. Wählen Sie Weiter aus.

Schritt 4: Erstellen Sie eine Build-Phase

Dieser Schritt ist optional, wenn Sie die Erstellung einer Bereitstellungsstufe planen.

1. Führen Sie auf der Seite Schritt 4: Build-Phase hinzufügen eine der folgenden Aktionen aus, und wählen Sie dann Weiter aus:

   • Wählen Sie Buildphase überspringen, wenn Sie eine Test- oder Bereitstellungsphase erstellen möchten.

   • Um die Aktion „Befehle“ für Ihre Build-Phase auszuwählen, wählen Sie „Befehle“.

     Anmerkung

     Für die Ausführung der Aktion „Befehle“ fallen separate Gebühren an AWS CodeBuild. Wenn Sie planen, Build-Befehle als Teil einer CodeBuild Aktion einzufügen, fahren Sie fort und wählen Sie Andere Build-Anbieter aus, und wählen Sie CodeBuild dann.

     Geben Sie im Feld Befehle die Shell-Befehle für Ihre Aktion ein. Weitere Informationen zur Aktion „Befehle“ finden Sie unterAktionsreferenz für Befehle.

   • Um andere Build-Anbieter auszuwählen CodeBuild, wie z. B., wählen Sie Andere Anbieter. Wählen Sie in Build provider (Build-Anbieter) einen benutzerdefinierten Aktionsanbieter von Build-Services aus und geben Sie die Konfigurationsdetails für diesen Anbieter ein. Ein Beispiel zum Hinzufügen von Jenkins als Build-Anbieter finden Sie unter Tutorial: Erstellen einer vierstufigen Pipeline.

   • Wählen Sie unter Build provider (Build-Anbieter) AWS CodeBuild aus.

     Wählen Sie unter Region die AWS Region aus, in der die Ressource vorhanden ist. Das Feld Region gibt an, wo die AWS Ressourcen für diesen Aktionstyp und Anbietertyp erstellt werden. Dieses Feld wird nur für Aktionen angezeigt, bei denen es sich beim Aktionsanbieter um einen handelt. AWS-Service Das Feld Region hat standardmäßig dieselbe AWS Region wie Ihre Pipeline.

     Wählen Sie unter Project name (Projektname) Ihr Build-Projekt aus. Wenn Sie bereits ein Build-Projekt in erstellt haben CodeBuild, wählen Sie es aus. Sie können auch ein Build-Projekt in erstellen CodeBuild und dann zu dieser Aufgabe zurückkehren. Befolgen Sie den Anweisungen unter Erstellen einer Pipeline, die CodeBuild verwendet im CodeBuild-Benutzerhandbuch.

     Unter Build-Spezifikationen ist die CodeBuild Buildspec-Datei optional, und Sie können stattdessen Befehle eingeben. Geben Sie im Feld Build-Befehle einfügen die Shell-Befehle für Ihre Aktion ein. Weitere Informationen zu Überlegungen zur Verwendung von Build-Befehlen finden Sie unterAktionsreferenz für Befehle. Wählen Sie Eine Buildspec-Datei verwenden, wenn Sie Befehle in anderen Phasen ausführen möchten oder wenn Sie eine lange Liste von Befehlen haben.

     Um Ihrer Build-Aktion Umgebungsvariablen hinzuzufügen, wählen Sie unter CodeBuild Umgebungsvariablen die Option Umgebungsvariable hinzufügen aus. Jede Variable besteht aus drei Einträgen:

     • Geben Sie in Name (Name) den Namen oder Schlüssel der Umgebungsvariable ein.

     • Geben Sie in Value (Wert) den Wert der Umgebungsvariable ein. Wenn Sie Parameter für den Variablentyp wählen, stellen Sie sicher, dass es sich bei diesem Wert um den Namen eines Parameters handelt, den Sie bereits im AWS Systems Manager-Parameterspeicher gespeichert haben.

       Anmerkung

       Wir raten dringend davon ab, Umgebungsvariablen zum Speichern vertraulicher Werte, insbesondere AWS Anmeldeinformationen, zu verwenden. Wenn Sie die CodeBuild Konsole oder AWS CLI verwenden, werden Umgebungsvariablen im Klartext angezeigt. Wenn es sich um vertrauliche Werte handelt, sollten Sie stattdessen den TypParameter (Parameter) verwenden.

     • (Optional) Geben Sie in Type (Typ) den Typ der Umgebungsvariablen ein. Gültige Werte sind Plaintext (Klartext) oder Parameter (Parameter). Der Standardwert ist Plaintext (Klartext).

     (Optional) Wählen Sie unter Build-Typ eine der folgenden Optionen aus:

     • Um jeden Build in einer einzigen Build-Aktionsausführung auszuführen, wählen Sie Single Build aus.

     • Um mehrere Builds in derselben Build-Aktionsausführung auszuführen, wählen Sie Batch Build.

     (Optional) Wenn Sie Batch-Builds ausführen möchten, können Sie „Alle Artefakte aus dem Batch an einem einzigen Ort zusammenfassen“ wählen, um alle Build-Artefakte in einem einzigen Ausgabe-Artefakt zu platzieren.

2. Um die Phase für die automatische Wiederholung zu konfigurieren, wählen Sie „Automatische Wiederholung bei Staging-Ausfall aktivieren“. Weitere Hinweise zur automatischen Wiederholung finden Sie unter. Konfigurieren Sie eine Phase für die automatische Wiederholung bei einem Fehler

3. Wählen Sie Weiter aus.

Schritt 5: Erstellen Sie eine Testphase

Dieser Schritt ist optional, wenn Sie eine Build- oder Bereitstellungsphase erstellen möchten.

1. Führen Sie auf der Seite Schritt 5: Testphase hinzufügen eine der folgenden Aktionen aus, und wählen Sie dann Weiter aus:

   • Wählen Sie Testphase überspringen, wenn Sie eine Build- oder Bereitstellungsphase erstellen möchten.

   • Wählen Sie unter Testanbieter den Anbieter der Testaktion aus und füllen Sie die entsprechenden Felder aus.

2. Wählen Sie Weiter aus.

Schritt 6: Erstellen Sie eine Bereitstellungsphase

Dieser Schritt ist optional, falls Sie bereits eine Build-Stufe erstellt haben.

1. Führen Sie auf der Seite Schritt 6: Bereitstellungsphase hinzufügen eine der folgenden Aktionen aus, und wählen Sie dann Weiter aus:

   • Wählen Sie Bereitstellungsphase überspringen, wenn Sie in den vorherigen Schritten eine Build- oder Testphase erstellt haben.

     Anmerkung

     Diese Option wird nicht angezeigt, wenn Sie die Build- oder Testphase bereits übersprungen haben.

   • Wählen Sie unter Deploy provider (Bereitstellungsanbieter) eine benutzerdefinierte Aktion aus, die Sie für einen Bereitstellungsanbieter erstellt haben.

     Wählen Sie unter Region (nur für regionsübergreifende Aktionen) die AWS Region aus, in der die Ressource erstellt wird. Das Feld Region gibt an, wo die AWS Ressourcen für diesen Aktionstyp und Anbietertyp erstellt werden. Dieses Feld wird nur für Aktionen angezeigt, bei denen es sich beim Aktionsanbieter um einen handelt. AWS-Service Das Feld Region hat standardmäßig dieselbe AWS Region wie Ihre Pipeline.

   • Unter Deploy provider (Bereitstellungsanbieter) finden Sie folgende Felder für Standardanbieter:

     • CodeDeploy

       Geben Sie im Feld Anwendungsname den Namen einer vorhandenen CodeDeploy Anwendung ein, oder wählen Sie ihn aus. Geben Sie unter Deployment group (Bereitstellungsgruppe) den Namen einer Bereitstellungsgruppe für die Anwendung ein. Wählen Sie Weiter aus. Sie können eine Anwendung, eine Bereitstellungsgruppe oder beides auch in der CodeDeploy-Konsole erstellen.

     • AWS Elastic Beanstalk

       Geben Sie im Feld Anwendungsname den Namen einer vorhandenen Elastic Beanstalk-Anwendung ein, oder wählen Sie ihn aus. Geben Sie unter Environment Name (Umgebungsname) eine Umgebung für die Anwendung ein. Wählen Sie Weiter aus. Sie können in der Elastic Beanstalk-Konsole auch eine Anwendung, eine Umgebung oder beides erstellen.

     • AWS OpsWorks Stacks

       Geben Sie unter Stack den Namen des Stacks ein, den Sie verwenden möchten. Wählen Sie unter Layer (Ebene) die Ebene aus, der Ihre Ziel-Instances angehören. Wählen Sie in App die Anwendung aus, die Sie aktualisieren und bereitstellen möchten. Wenn Sie eine App erstellen müssen, wählen Sie Create a new one in AWS OpsWorks(Eine neue in &OPSlong; erstellen) aus.

       Informationen zum Hinzufügen einer Anwendung zu einem Stack und zum Einbetten von Ebenen finden Sie unter Hinzufügen von Apps im AWS OpsWorks Benutzerhandbuch. AWS OpsWorks

       Ein umfassendes Beispiel dafür, wie Sie eine einfache Pipeline CodePipeline als Quelle für Code verwenden, den Sie auf AWS OpsWorks Ebenen ausführen, finden Sie unter Verwenden CodePipeline mit AWS OpsWorks Stacks.

     • AWS CloudFormation

       Führen Sie eine der folgenden Aktionen aus:

       • Wählen Sie im Aktionsmodus die Option Stapel erstellen oder aktualisieren aus, geben Sie einen Stacknamen und einen Vorlagendateinamen ein und wählen Sie dann den Namen einer Rolle aus, die Sie übernehmen AWS CloudFormation möchten. Geben Sie optional den Namen einer Konfigurationsdatei ein und wählen Sie eine IAM-Funktionsoption.

       • Wählen Sie im Aktionsmodus die Option Änderungssatz erstellen oder ersetzen aus, geben Sie einen Stack-Namen und einen Namen für das Änderungssatz ein, und wählen Sie dann den Namen einer Rolle, die übernommen werden AWS CloudFormation soll. Geben Sie optional den Namen einer Konfigurationsdatei ein und wählen Sie eine IAM-Funktionsoption.

       Informationen zur Integration von AWS CloudFormation Funktionen in eine Pipeline finden Sie unter Continuous Delivery mit CodePipeline im AWS CloudFormation Benutzerhandbuch. CodePipeline

     • Amazon ECS

       Geben Sie im Feld Clustername den Namen eines vorhandenen Amazon ECS-Clusters ein oder wählen Sie ihn aus. Geben Sie unter Service name (Service-Name) den Namen des auf dem Cluster ausgeführten Services ein oder wählen Sie ihn aus. Sie können auch einen neuen Cluster und einen Service erstellen. Geben Sie unter Image filename (Abbild-Dateiname) den Namen der Abbild-Definitionsdatei ein, die den Container und das Abbild Ihres Services beschreibt.

       Anmerkung

       Für die Amazon ECS-Bereitstellungsaktion ist eine imagedefinitions.json Datei als Eingabe für die Bereitstellungsaktion erforderlich. Der Standarddateiname für die Datei ist imagedefinitions.json. Wenn Sie einen anderen Dateinamen verwenden, müssen Sie diesen bereitstellen, wenn Sie die Pipeline-Bereitstellungsphase erstellen. Weitere Informationen finden Sie unter imagedefinitions.json-Datei für Amazon ECS-Standardbereitstellungsaktionen.

       Wählen Sie Weiter aus.

       Anmerkung

       Stellen Sie sicher, dass Ihr Amazon ECS-Cluster mit zwei oder mehr Instances konfiguriert ist. Amazon ECS-Cluster müssen mindestens zwei Instances enthalten, sodass eine als primäre Instance beibehalten wird und eine andere für neue Bereitstellungen verwendet wird.

       Ein Tutorial zum Bereitstellen von Container-basierten Anwendungen mit Ihrer Pipeline finden Sie unter Tutorial: Kontinuierliche Bereitstellung mit CodePipeline.

     • Amazon ECS () Blue/Green

       Geben Sie die CodeDeploy Anwendung und die Bereitstellungsgruppe, die Amazon ECS-Aufgabendefinition und die AppSpec Dateiinformationen ein und wählen Sie dann Weiter.

       Anmerkung

       Die Amazon ECS (Blue/Green) -Aktion erfordert eine Detail.json Image-Datei als Eingabeartefakt für die Bereitstellungsaktion. Da die Amazon ECR-Quellaktion diese Datei erstellt, müssen Pipelines mit einer Amazon ECR-Quellaktion keine Datei bereitstellen. imageDetail.json Weitere Informationen finden Sie unter Detail.json Image-Datei für Amazon blue/green ECS-Bereitstellungsaktionen.

       Ein Tutorial zum Erstellen einer Pipeline für blaugrüne Bereitstellungen zu einem Amazon ECS-Cluster mit finden Sie unter. CodeDeploy Tutorial: Erstellen Sie eine Pipeline mit einer Amazon ECR-Quelle und Bereitstellung ECS-to-CodeDeploy

     • AWS Service Catalog

       Wählen Sie Enter deployment configuration (Bereitstellungskonfiguration eingeben), wenn Sie Felder in der Konsole zum Angeben Ihrer Konfiguration verwenden möchten, oder Konfigurationsdatei, falls Sie über eine separate Konfigurationsdatei verfügen. Geben Sie die Produkt- und Konfigurationsinformationen ein und klicken Sie anschließend auf Weiter.

       Ein Tutorial zur Bereitstellung von Produktänderungen an Service Catalog mit Ihrer Pipeline finden Sie unter. Tutorial: Erstellen Sie eine Pipeline, die im Service Catalog bereitgestellt wird

     • Alexa Skills Kit

       Geben Sie unter Alexa Skill-ID die Skill-ID für Ihre Alexa-Qualifikation ein. Geben Sie unter Client-ID und Clientschlüssel die Anmeldeinformationen ein, die über ein Login with Amazon-Sicherheitsprofil (LWA) generiert wurden. Geben Sie unter Aktualisierungs-Token das Aktualisierungs-Token ein, das Sie mit dem ASK-CLI-Befehl zum Abrufen eines Aktualisierungs-Tokens generiert haben. Wählen Sie Weiter aus.

       Ein Tutorial zur Bereitstellung von Alexa-Qualifikationen mit Ihrer Pipeline und zur Generierung der LWA-Anmeldeinformationen finden Sie unter Tutorial: Erstellen einer Pipeline zum Bereitstellen eines Amazon Alexa-Skills.

     • Amazon S3

       Geben Sie unter Bucket den Namen des gewünschten S3-Buckets ein. Wählen Sie Extract file before deploy (Datei vor Bereitstellung extrahieren), falls das Eingabeartefakt für Ihre Bereitstellungsstufe eine ZIP-Datei ist. Wenn Extract file before deploy (Datei vor Bereitstellung extrahieren) ausgewählt ist, können Sie optional einen Wert für Deployment path (Bereitstellungspfad) als Speicherort eingeben, an dem Ihre ZIP-Datei entzippt wird. Wenn es nicht ausgewählt ist, müssen Sie einen Wert in den S3-Objektschlüssel eingeben.

       Anmerkung

       Die meisten Ausgabeartefakte von Quell- und Build-Stufen werden gezippt. Alle Pipeline-Quellanbieter außer Amazon S3 komprimieren Ihre Quelldateien, bevor Sie sie als Eingabeartefakt für die nächste Aktion bereitstellen.

       (Optional) Geben Sie in Canned ACL die vordefinierte ACL ein, die auf das in Amazon S3 bereitgestellte Objekt angewendet werden soll.

       Anmerkung

       Beim Anwenden einer vordefinierten ACL werden alle auf das Objekt angewandten vorhandenen ACLs überschrieben.

       (Optional) Geben Sie unter Cache control (Cache-Kontrolle) die Cache-Kontroll-Parameter für Anforderungen zum Herunterladen von Objekten aus dem Bucket an. Eine Liste der gültigen Werte finden Sie im Cache-Control-Header-Feld für HTTP-Operationen. Um mehrere Werte in die Cache-Steuerung einzugeben, verwenden Sie ein Komma zwischen den einzelnen Werten. Sie können nach jedem Komma ein Leerzeichen hinzufügen (optional), wie in diesem Beispiel gezeigt.

       

       Der vorherige Beispieleintrag wird in der CLI wie folgt angezeigt:

       "CacheControl": "public, max-age=0, no-transform"

       Wählen Sie Weiter aus.

       Ein Tutorial zum Erstellen einer Pipeline mit einem Amazon S3-Bereitstellungsaktions-Provider finden Sie unter. Tutorial: Erstellen Sie eine Pipeline, die Amazon S3 als Bereitstellungsanbieter verwendet

2. Um die Phase für die automatische Wiederholung zu konfigurieren, wählen Sie Automatische Wiederholung bei Ausfall der Phase aktivieren. Weitere Hinweise zur automatischen Wiederholung finden Sie unter. Konfigurieren Sie eine Phase für die automatische Wiederholung bei einem Fehler

3. Um die Phase für das automatische Rollback zu konfigurieren, wählen Sie Automatisches Rollback bei Stufenausfall konfigurieren aus. Weitere Informationen zum automatischen Rollback finden Sie unter. Konfigurieren Sie eine Phase für das automatische Rollback

4. Klicken Sie auf Nächster Schritt.

Schritt 7: Überprüfen Sie die Pipeline

• Überprüfen Sie auf der Seite Schritt 7: Überprüfen Ihre Pipeline-Konfiguration und wählen Sie dann Pipeline erstellen, um die Pipeline zu erstellen, oder Zurück, um zurückzugehen und Ihre Auswahl zu bearbeiten. Um den Assistenten ohne Erstellen einer Pipeline zu beenden, wählen Sie Cancel aus.

So erstellen Sie die JSON-Datei

1. Erstellen Sie auf einem Terminal (Linux, macOS oder Unix) oder einer Befehlszeile (Windows) eine neue Textdatei in einem lokalen Verzeichnis.

2. (Optional) Sie können eine oder mehrere Variablen auf Pipeline-Ebene hinzufügen. Sie können bei der Konfiguration von CodePipeline Aktionen auf diesen Wert verweisen. Sie können die Variablennamen und Werte hinzufügen, wenn Sie die Pipeline erstellen, und Sie können sich auch dafür entscheiden, Werte zuzuweisen, wenn Sie die Pipeline in der Konsole starten.

   Anmerkung

   Es ist zwar optional, Variablen auf Pipeline-Ebene hinzuzufügen, aber für eine Pipeline, die mit Variablen auf Pipeline-Ebene angegeben ist und für die keine Werte bereitgestellt werden, schlägt die Pipeline-Ausführung fehl.

   Eine Variable auf Pipeline-Ebene wird zur Laufzeit der Pipeline aufgelöst. Alle Variablen sind unveränderlich, was bedeutet, dass sie nicht aktualisiert werden können, nachdem ein Wert zugewiesen wurde. Variablen auf Pipeline-Ebene mit aufgelösten Werten werden bei jeder Ausführung im Verlauf angezeigt.

   Sie stellen Variablen auf Pipeline-Ebene mithilfe des Variablenattributs in der Pipeline-Struktur bereit. Im folgenden Beispiel Variable1 hat die Variable einen Wert vonValue1.

          "variables": [
               {
                   "name": "Timeout",
                   "defaultValue": "1000",
                   "description": "description"
               }
           ]

   Fügen Sie diese Struktur Ihrem Pipeline-JSON oder im folgenden Schritt dem JSON-Beispiel hinzu. Weitere Hinweise zu Variablen, einschließlich Namespace-Informationen, finden Sie unterVariablenreferenz.

3. Öffnen Sie die Datei in einem Texteditor und bearbeiten Sie die Werte entsprechend der Struktur, die Sie erstellen möchten. Sie müssen mindestens den Namen der Pipeline ändern. Sie sollten auch überlegen, ob Sie Folgendes ändern möchten:

   • Den S3-Bucket, in dem Artefakte für diese Pipeline gespeichert sind.

   • Den Speicherort für Ihren Code.

   • Den Bereitstellungsanbieter.

   • Art der Bereitstellung des Codes.

   • Die Tags für Ihre Pipeline.

   Die folgende Beispielstruktur für eine Pipeline mit zwei Phasen zeigt die Werte an, deren Änderung Sie für Ihre Pipeline in Betracht ziehen sollten. Ihre Pipeline enthält wahrscheinlich mehr als zwei Phasen:

   {
       "pipeline": {
           "roleArn": "arn:aws:iam::80398EXAMPLE::role/AWS-CodePipeline-Service",  
           "stages": [
               {
                   "name": "Source",
                   "actions": [
                       {
                           "inputArtifacts": [],
                           "name": "Source",
                           "actionTypeId": {
                               "category": "Source",
                               "owner": "AWS",
                               "version": "1",
                               "provider": "S3"
                           },
                           "outputArtifacts": [
                               {
                                   "name": "MyApp"
                               }
                           ],
                           "configuration": {
                               "S3Bucket": "amzn-s3-demo-source-bucket",
                               "S3ObjectKey": "ExampleCodePipelineSampleBundle.zip",
                               "PollForSourceChanges": "false"
                           },
                           "runOrder": 1                       
                       }
                   ]
               },
               {
                   "name": "Staging",
                   "actions": [
                       {
                           "inputArtifacts": [
                               {
                                   "name": "MyApp"
                               }
                           ],
                           "name": "Deploy-CodeDeploy-Application",
                           "actionTypeId": {
                               "category": "Deploy",
                               "owner": "AWS",
                               "version": "1",
                               "provider": "CodeDeploy"
                           },
                           "outputArtifacts": [],
                           "configuration": {
                               "ApplicationName": "CodePipelineDemoApplication",
                               "DeploymentGroupName": "CodePipelineDemoFleet"
                           },
                           "runOrder": 1
                       }
                   ]
               }
           ],
           "artifactStore": {
               "type": "S3",
               "location": "codepipeline-us-east-2-250656481468"
           },
           "name": "MyFirstPipeline",
           "version": 1,
           "variables": [
               {
                   "name": "Timeout",
                   "defaultValue": "1000",
                   "description": "description"
               }
             ]
           },
           "triggers": [
               {
                   "providerType": "CodeStarSourceConnection",
                   "gitConfiguration": {
                       "sourceActionName": "Source",
                       "push": [
                           {
                               "tags": {
                                   "includes": [
                                       "v1"
                                   ],
                                   "excludes": [
                                       "v2"
                                   ]
                               }
                           }
                       ]
                   }
               }
           ]
       "metadata": {
           "pipelineArn": "arn:aws:codepipeline:us-east-2:80398EXAMPLE:MyFirstPipeline",
           "updated": 1501626591.112,
           "created": 1501626591.112
       },
       "tags": [{
         "key": "Project",
         "value": "ProjectA"
       }]
   } 

   In diesem Beispiel wird der Pipeline Tagging hinzugefügt, indem der Pipeline der Tag-Schlüssel Project und der Wert ProjectA hinzugefügt werden. Weitere Hinweise zum Taggen von Ressourcen in finden Sie CodePipeline unter. Taggen von Ressourcen

   Stellen Sie sicher, dass der PollForSourceChanges-Parameter in Ihrer JSON-Datei wie folgt festgelegt ist:

                   "PollForSourceChanges": "false",

   CodePipeline verwendet Amazon CloudWatch Events, um Änderungen in Ihrem CodeCommit Quell-Repository und Branch oder Ihrem S3-Quell-Bucket zu erkennen. Der nächste Schritt enthält Anweisungen zum manuellen Erstellen dieser Ressourcen für Ihre Pipeline. Wenn das Flag auf false gesetzt wird, werden regelmäßige Prüfungen deaktiviert, die nicht erforderlich sind, wenn die empfohlenen Methoden zur Änderungserkennung verwendet werden.

4. Um eine Build-, Test- oder Bereitstellungsaktion in einer anderen Region als Ihre Pipeline zu erstellen, müssen Sie Ihrer Pipeline-Struktur Folgendes hinzufügen. Detaillierte Anweisungen finden Sie unter Fügen Sie eine regionsübergreifende Aktion hinzu in CodePipeline.

   • Fügen Sie den Region-Parameter der Pipeline-Struktur Ihrer Aktion hinzu.

   • Verwenden Sie den artifactStores Parameter, um einen Artefakt-Bucket für jede AWS Region anzugeben, in der Sie eine Aktion ausführen.

5. Wenn Sie mit der Struktur zufrieden sind, speichern Sie die Datei mit einem Namen wie pipeline.json.

So erstellen Sie eine Pipeline

1. Führen Sie den Befehl create-pipeline aus und verwenden Sie die Parameter --cli-input-json, um die zuvor erstellte JSON-Datei anzugeben.

   Um eine Pipeline zu erstellen, die MySecondPipeline mit einer JSON-Datei namens pipeline.json benannt ist, die den Namen "MySecondPipeline" als Wert für name in der JSON-Datei enthält, würde Ihr Befehl wie folgt aussehen:

   aws codepipeline create-pipeline --cli-input-json file://pipeline.json

   Wichtig

   Achten Sie darauf, dass file:// vor dem Dateinamen steht. Dies ist bei diesem Befehl erforderlich.

   Dieser Befehl gibt die Struktur der gesamten erstellten Pipeline zurück.

2. Um die Pipeline anzuzeigen, öffnen Sie entweder die CodePipeline Konsole und wählen Sie sie aus der Liste der Pipelines aus, oder verwenden Sie den Befehl. get-pipeline-state Weitere Informationen finden Sie unter Pipelines und Details anzeigen in CodePipeline.

3. Wenn Sie die CLI zum Erstellen einer Pipeline verwenden, müssen Sie die empfohlenen Änderungserkennungsressourcen für Ihre Pipeline manuell erstellen:

   • Für eine Pipeline mit einem CodeCommit Repository müssen Sie die CloudWatch Events-Regel manuell erstellen, wie unter beschriebenErstellen Sie eine EventBridge Regel für eine CodeCommit Quelle (CLI).

   • Für eine Pipeline mit einer Amazon S3-Quelle müssen Sie die Regel und den AWS CloudTrail Pfad für CloudWatch Ereignisse manuell erstellen, wie unter beschriebenVerbindung zu Amazon S3-Quellaktionen herstellen, die EventBridge und verwenden AWS CloudTrail.

Schritt 1: Greifen Sie auf die Konsole zu

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

2. Klicken Sie auf der Seite Welcome auf Create pipeline.

   Wenn Sie es zum ersten Mal verwenden CodePipeline, wählen Sie Erste Schritte.

Schritt 2: Vorlage wählen

Wählen Sie eine Vorlage, um eine Pipeline mit einer Bereitstellungsphase, Automatisierung oder einer CI-Pipeline zu erstellen.

1. Führen Sie auf der Seite Schritt 1: Erstellungsoption auswählen eine der folgenden Aktionen aus, und wählen Sie dann Weiter aus:

   • Wählen Sie Bereitstellung, wenn Sie eine Bereitstellungsphase erstellen möchten. Sehen Sie sich die Optionen für Vorlagen an, die auf ECR oder CloudFormation bereitgestellt werden. Wählen Sie in diesem Beispiel Deployment aus, und wählen Sie dann Deployment to CloudFormation aus.

   • Wählen Sie Kontinuierliche Integration, wenn Sie eine CI-Pipeline erstellen möchten. Sehen Sie sich die Optionen für CI-Pipelines an, z. B. das Erstellen für Gradle.

   • Wählen Sie Automatisierung, wenn Sie eine automatisierte Pipeline erstellen möchten. Sehen Sie sich die Optionen für die Automatisierung an, z. B. die Planung eines Python-Builds.

2. 
   
   

Schritt 3: Quelle wählen

• Wählen Sie auf der Seite Schritt 3: Quelltext auswählen unter Quellanbieter den Anbieter für das Repository aus, in dem Ihr Quellcode gespeichert ist, geben Sie die erforderlichen Optionen an und wählen Sie dann Nächster Schritt aus.

  • Für Bitbucket Cloud GitHub (per GitHub App), GitHub Enterprise Server oder GitLab selbstverwaltet: GitLab.com

    1. Wähle unter Verbindung eine bestehende Verbindung aus oder erstelle eine neue. Informationen zum Erstellen oder Verwalten einer Verbindung für Ihre GitHub Quellaktion finden Sie unterGitHub Verbindungen.

    2. Wählen Sie das Repository aus, das Sie als Quellspeicherort für Ihre Pipeline verwenden möchten.

       Wählen Sie, ob Sie einen Trigger hinzufügen oder nach Triggertypen filtern möchten, um Ihre Pipeline zu starten. Weitere Informationen zum Arbeiten mit Triggern finden Sie unterTrigger mit Code-Push- oder Pull-Request-Ereignistypen hinzufügen. Weitere Hinweise zum Filtern mit Glob-Mustern finden Sie unterArbeiten mit Glob-Mustern in der Syntax.

    3. Wählen Sie unter Ausgabe-Artefaktformat das Format für Ihre Artefakte aus.

       • Um die Ausgabeartefakte der GitHub Aktion mit der Standardmethode zu speichern, wählen Sie CodePipeline Standard. Die Aktion greift auf die Dateien aus dem GitHub Repository zu und speichert die Artefakte in einer ZIP-Datei im Pipeline-Artefaktspeicher.

       • Um eine JSON-Datei zu speichern, die einen URL-Verweis auf das Repository enthält, damit Downstream-Aktionen Git-Befehle direkt ausführen können, wählen Sie Full clone (Vollständiger Klon). Diese Option kann nur von CodeBuild nachgeschalteten Aktionen verwendet werden.

         Wenn Sie diese Option wählen, müssen Sie die Berechtigungen für Ihre CodeBuild Projektservice-Rolle aktualisieren, wie unter gezeigt. Problembehebung CodePipeline Ein Tutorial, das Ihnen zeigt, wie Sie die Option „Vollständiger Klon“ verwenden, finden Sie unterTutorial: Vollständigen Klon mit einer GitHub Pipeline-Quelle verwenden.

  • Für Amazon ECR:

    • Wählen Sie unter Repository-Name den Namen Ihres Amazon ECR-Repositorys aus.

    • Geben Sie im Feld Image tag (Image-Tag) den Image-Namen und die Version an, falls sie nicht LATEST lautet.

    • Wählen Sie unter Ausgabeartefakte den Standard für das Ausgabe-Artefakt aus, z. B. MyApp, der den Image-Namen und die Repository-URI-Informationen enthält, die Sie in der nächsten Stufe verwenden möchten.

    Wenn Sie eine Amazon ECR-Quellstufe in Ihre Pipeline aufnehmen, generiert die Quellaktion eine imageDetail.json Datei als Ausgabeartefakt, wenn Sie eine Änderung festschreiben. Informationen zur imageDetail.json-Datei finden Sie unter Detail.json Image-Datei für Amazon blue/green ECS-Bereitstellungsaktionen.

  Anmerkung

  Das Objekt und der Dateityp müssen mit dem Bereitstellungssystem kompatibel sein, das Sie verwenden möchten (z. B. Elastic Beanstalk oder). CodeDeploy Beispiele für unterstützte Dateitypen sind ZIP, TAR und TGZ. Weitere Informationen zu den unterstützten Containertypen für Elastic Beanstalk finden Sie unter Anpassen und Konfigurieren von Elastic Beanstalk-Umgebungen und unterstützten Plattformen. https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/concepts.platforms.html Weitere Informationen zur Bereitstellung von Revisionen mit finden Sie unter Hochladen Ihrer CodeDeploy Anwendungsrevision und Vorbereiten einer Revision. https://docs.aws.amazon.com/codedeploy/latest/userguide/how-to-prepare-revision.html

Schritt 4: Vorlage konfigurieren

Für dieses Beispiel CloudFormation wurde die Bereitstellung für ausgewählt. Fügen Sie in diesem Schritt die Konfiguration für Ihre Vorlage hinzu.

1. Geben Sie in Schritt 4: Vorlage konfigurieren im Feld Stack-Name einen Namen für Ihre Pipeline ein.

2. Bearbeiten Sie die Platzhalter-IAM-Richtlinie für die Berechtigungen, die für Ihre Vorlage gelten.

3. Wählen Sie „Pipeline aus Vorlage erstellen“

4. Es wird eine Meldung angezeigt, die besagt, dass Ihre Pipeline-Ressourcen erstellt werden.

Schritt 5: Sehen Sie sich die Pipeline an

• Nachdem Sie Ihre Pipeline erstellt haben, können Sie sie in der CodePipeline Konsole und den Stack in anzeigen CloudFormation. Die Pipeline wird nach dem Erstellen ausgeführt. Weitere Informationen finden Sie unter Pipelines und Details anzeigen in CodePipeline. Weitere Informationen über die Durchführung von Änderungen an Ihrer Pipeline finden Sie unter Eine Pipeline bearbeiten in CodePipeline.