Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Eine Pipeline, Phasen und Aktionen erstellen Sie können die AWS CodePipeline Konsole oder die verwenden AWS CLI , um eine Pipeline zu erstellen. Pipelines müssen mindestens zwei Stufen enthalten. Die erste Stufe einer Pipeline muss eine Quellstufe sein. Die Pipeline muss mindestens eine weitere Stufe besitzen, bei der es sich um eine Build- oder Bereitstellungsstufe handelt. **Wichtig** Im Rahmen der Erstellung einer Pipeline wird ein vom Kunden bereitgestellter S3-Artefakt-Bucket von CodePipeline for Artifacts verwendet. (Dies unterscheidet sich von dem Bucket, der für eine S3-Quellaktion verwendet wird.) Wenn sich der S3-Artefakt-Bucket in einem anderen Konto befindet als das Konto für Ihre Pipeline, stellen Sie sicher, dass der S3-Artefakt-Bucket denjenigen gehört AWS-Konten , die sicher und zuverlässig sind. Sie können Ihrer Pipeline Aktionen hinzufügen, die sich von Ihrer Pipeline AWS-Region unterscheiden. Eine regionsübergreifende Aktion ist eine Aktion, bei der an der Anbieter für eine Aktion AWS-Service ist und sich der Aktionstyp oder der Anbietertyp in einer anderen AWS Region als Ihrer Pipeline befinden. Weitere Informationen finden Sie unter [Fügen Sie eine regionsübergreifende Aktion hinzu in CodePipeline](actions-create-cross-region.md). Sie können auch Pipelines erstellen, die containerbasierte Anwendungen erstellen und bereitstellen, indem Sie Amazon ECS als Bereitstellungsanbieter verwenden. Bevor Sie eine Pipeline erstellen, die containerbasierte Anwendungen mit Amazon ECS bereitstellt, müssen Sie eine Image-Definitionsdatei erstellen, wie unter beschrieben. [Referenz zu Abbild-Definitionsdateien](file-reference.md) CodePipeline verwendet Methoden zur Erkennung von Änderungen, um Ihre Pipeline zu starten, wenn eine Quellcodeänderung übertragen wird. Diese Erkennungsmethoden basieren auf dem Quelltyp: + CodePipeline verwendet Amazon CloudWatch Events, um Änderungen in Ihrem CodeCommit Quell-Repository und Branch oder Ihrem S3-Quell-Bucket zu erkennen. **Anmerkung** Wenn Sie die Konsole zum Erstellen oder Ändern einer Pipeline verwenden, werden die Ressourcen für die Änderungserkennung für Sie erstellt. Wenn Sie die AWS CLI verwenden, um die Pipeline zu erstellen, müssen Sie die zusätzlichen Ressourcen selbst erstellen. Weitere Informationen finden Sie unter [CodeCommit Quellaktionen und EventBridge](triggering.md). **Topics** + [Erstellen Sie eine benutzerdefinierte Pipeline (Konsole)](#pipelines-create-console) + [Erstellen einer Pipeline (CLI)](#pipelines-create-cli) + [Erstellen Sie eine Pipeline aus statischen Vorlagen](#pipelines-create-templates) ## Erstellen Sie eine benutzerdefinierte Pipeline (Konsole) Um eine benutzerdefinierte Pipeline in der Konsole zu erstellen, müssen Sie den Speicherort der Quelldatei und Informationen zu den Anbietern angeben, die Sie für Ihre Aktionen verwenden werden. Wenn Sie die Konsole zum Erstellen einer Pipeline verwenden, müssen Sie eine Source-Stufe und eine der folgenden Stufen einschließen: + Eine Build-Stufe. + Eine Bereitstellungsstufe. Wenn Sie den Pipeline-Assistenten verwenden, CodePipeline erstellt er die Namen der Stufen (Quelle, Build, Staging). Diese Namen können nicht geändert werden. Sie können spezifischere Namen (z. B. BuildToGamma oder DeployToProd) für Stufen verwenden, die Sie später hinzufügen. **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](https://console.aws.amazon.com/codesuite/codepipeline/home). 1. Klicken Sie auf der Seite **Welcome** auf **Create pipeline**. Wenn Sie es zum ersten Mal verwenden CodePipeline, wählen Sie **Get Started**. 1. Wählen Sie auf der Seite **Schritt 1: Erstellungsoption auswählen** unter **Erstellungsoptionen** die Option **Benutzerdefinierte Pipeline erstellen** aus. Wählen Sie **Weiter** aus. 1. 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](limits.md). 1. Wählen Sie **unter Pipeline-Typ** eine der folgenden Optionen aus. Die Pipeline-Typen unterscheiden sich in ihren Eigenschaften und im Preis. Weitere Informationen finden Sie unter [Arten von Pipelines](pipeline-types.md). + 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 Pipelines vom Typ V1 und bieten zusätzliche Parameterunterstützung, z. B. Trigger für Git-Tags und Variablen auf Pipeline-Ebene. 1. Führen Sie unter **Service role** (Service-Rolle) einen der folgenden Schritte aus: + Wählen Sie **Neue Servicerolle** aus, um die Erstellung 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](how-to-custom-role.md#how-to-update-role-new-services). Weitere Informationen über die Service-Rolle und ihre Richtlinienanweisung finden Sie unter [Verwalten Sie die CodePipeline Servicerolle](how-to-custom-role.md). 1. (Optional) Wählen Sie unter **Variablen** die Option **Variable hinzufügen** aus, um Variablen auf Pipeline-Ebene hinzuzufügen. Weitere Informationen zu Variablen auf Pipeline-Ebene finden Sie unter[Variablen-Referenz](reference-variables.md). Ein Tutorial mit einer Variablen auf Pipelineebene, die bei der Ausführung der Pipeline übergeben wird, finden Sie unter. [Tutorial: Variablen auf Pipeline-Ebene verwenden](tutorials-pipeline-variables.md) **Anmerkung** Es ist zwar optional, Variablen auf Pipelineebene hinzuzufügen, aber bei einer Pipeline, die mit Variablen auf Pipelineebene spezifiziert ist, für die keine Werte bereitgestellt werden, schlägt die Pipelineausführung fehl. 1. (Optional) Erweitern Sie den Abschnitt **Advanced Settings (Erweiterte Einstellungen)**. 1. Führen Sie unter **Artifact store (Artefakt speichern)** einen der folgenden Schritte aus: 1. Wählen Sie **Standardspeicherort**, um den Standardartefaktspeicher, z. B. den als Standard festgelegten S3-Artefakt-Bucket, für Ihre Pipeline in der Pipeline zu verwenden, die AWS-Region Sie für Ihre Pipeline ausgewählt haben. 1. 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](welcome-introducing-artifacts.md) und [CodePipeline Referenz zur Pipeline-Struktur](reference-pipeline-structure.md). 1. Führen Sie unter **Encryption key (Verschlüsselungsschlüssel)** einen der folgenden Schritte aus: 1. **Um den CodePipeline Standard AWS KMS key für die Verschlüsselung der Daten im Pipeline-Artefaktspeicher (S3-Bucket) zu verwenden, wählen Sie „Verwalteter Standardschlüssel“. AWS ** 1. **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. 1. Wählen Sie **Weiter** aus. **Schritt 2: Erstellen Sie eine Quellstufe** 1. Wählen Sie auf der Seite **Schritt 3: Quellcode hinzufügen** im Feld **Quellanbieter** den Typ des Repositorys 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 (über GitHub App), GitHub Enterprise Server, GitLab .com oder GitLab selbstverwaltet**: 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 unter[GitHub Verbindungen](connections-github.md). 1. Wählen Sie das Repository aus, das Sie als Quellverzeichnis 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 unter[Trigger mit Code-Push- oder Pull-Request-Ereignistypen hinzufügen](pipelines-filter.md). Weitere Informationen zum Filtern mit Glob-Mustern finden Sie unter[Arbeiten mit Glob-Mustern in der Syntax](syntax-glob.md). 1. Wählen Sie unter **Ausgabeartefaktformat** das Format für Ihre Artefakte aus. + Um die Ausgabeartefakte der GitHub Aktion mit der Standardmethode zu speichern, wählen Sie **CodePipelineStandard**. 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 beschrieben. [Problembehebung CodePipeline](troubleshooting.md) Ein Tutorial, das Ihnen zeigt, wie Sie die Option **Vollständiges Klonen** verwenden, finden Sie unter[Tutorial: Vollständigen Klon mit einer GitHub Pipeline-Quelle verwenden](tutorials-github-gitclone.md). + 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. 1. 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 Quellpfad 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 **Ausgabeartefaktformat** das Format für Ihre Artefakte aus. + Um die Ausgabeartefakte der CodeCommit Aktion mit der Standardmethode zu speichern, wählen Sie **CodePipelineStandard**. 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 Ihrer CodeBuild Servicerolle die `codecommit:GitPull` entsprechende Berechtigung hinzufügen, wie unter beschrieben. [Fügen Sie CodeBuild GitClone Berechtigungen für CodeCommit Quellaktionen hinzu](troubleshooting.md#codebuild-role-codecommitclone) Sie müssen außerdem die `codecommit:GetRepository` Berechtigungen zu Ihrer CodePipeline Servicerolle hinzufügen, wie unter beschrieben[Fügen Sie der CodePipeline Servicerolle Berechtigungen hinzu](how-to-custom-role.md#how-to-update-role-new-services). Ein Tutorial, das Ihnen zeigt, wie Sie die Option **Vollständiges Klonen** verwenden, finden Sie unter[Tutorial: Vollständigen Klon mit einer GitHub Pipeline-Quelle verwenden](tutorials-github-gitclone.md). + Nachdem Sie den CodeCommit Repository-Namen und den Branch ausgewählt haben, wird unter **Optionen zur Änderungserkennung** eine Meldung mit der Amazon CloudWatch Events-Regel angezeigt, die 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, um Änderungen für Ihre neue 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** die Standardeinstellung für das Ausgabeartefakt aus, z. B. das MyApp Element, das den Bildnamen und die Repository-URI-Informationen enthält, die in der nächsten Phase verwendet werden sollen. Ein Tutorial zum Erstellen einer Pipeline für Amazon ECS mit CodeDeploy blaugrünen Bereitstellungen, die eine Amazon ECR-Quellphase beinhaltet, finden Sie unter. [Tutorial: Eine Pipeline mit einer Amazon ECR-Quelle und ECS-to-CodeDeploy Bereitstellung erstellen](tutorials-ecs-ecr-codedeploy.md) 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 [ImageDetail.json-Datei für Amazon ECS-Bereitstellungsaktionen blue/green](file-reference.md#file-reference-ecs-bluegreen). **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 Beanstalk-Umgebungen und](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/customize-containers.html) unterstützten Plattformen.](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/concepts.platforms.html) [Weitere Informationen zur Bereitstellung von Revisionen mit finden Sie unter [Upload Your](https://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-steps.html#deployment-steps-uploading-your-app) Application Revision CodeDeploy und Prepare a Revision.](https://docs.aws.amazon.com/codedeploy/latest/userguide/how-to-prepare-revision.html) 1. Um die Phase für die automatische Wiederholung zu konfigurieren, wählen Sie Automatische Wiederholung bei **Stufenausfall aktivieren**. Weitere Informationen zur automatischen Wiederholung finden Sie unter. [Konfigurieren Sie eine Phase für den automatischen Wiederholungsversuch bei einem Fehler](stage-retry.md#stage-retry-auto) 1. Wählen Sie **Weiter** aus. **Schritt 4: Erstellen Sie eine Buildphase** Dieser Schritt ist optional, wenn Sie die Erstellung einer Bereitstellungsstufe planen. 1. Führen Sie auf der Seite **Schritt 4: Buildphase hinzufügen** einen der folgenden Schritte aus und wählen Sie dann **Weiter** aus: + Wählen Sie „**Erstellungsphase ü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 in an AWS CodeBuild. Wenn Sie Build-Befehle als Teil einer CodeBuild Aktion einfügen möchten, fahren Sie fort und wählen Sie Andere Buildanbieter und dann aus CodeBuild. Geben Sie im Feld **Befehle** die Shell-Befehle für Ihre Aktion ein. Weitere Informationen zur Aktion Befehle finden Sie unter[Aktionsreferenz für Befehle](action-reference-Commands.md). + 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](tutorials-four-stage-pipeline.md). + 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 bei dem Aktionsanbieter um einen handelt. AWS-Service Das Feld **Region** ist standardmäßig auf dieselbe AWS Region wie Ihre Pipeline eingestellt. 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](https://docs.aws.amazon.com/codebuild/latest/userguide/how-to-create-pipeline.html#pipelines-create-console) im *CodeBuild-Benutzerhandbuch*. Unter **Buildspezifikationen** 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 unter[Aktionsreferenz für Befehle](action-reference-Commands.md). Wählen Sie **Buildspec-Datei verwenden**, wenn Sie Befehle in anderen Phasen ausführen möchten oder wenn Sie eine lange Befehlsliste haben. Um **Umgebungsvariablen** zu Ihrer Build-Aktion 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 dieser Wert der Name eines Parameters ist, den Sie bereits im AWS Systems Manager Parameter Store gespeichert haben. **Anmerkung** Es wird dringend davon abgeraten, Umgebungsvariablen zum Speichern sensibler Werte, insbesondere von 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 Typ**Parameter (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 Buildtyp** eine der folgenden Optionen aus: + Um jeden Build in einer einzigen Ausführung einer Build-Aktion 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 Speicherort zusammenfassen**“ wählen, um alle Build-Artefakte in einem einzigen Ausgabeartefakt zu platzieren. 1. Um die Phase für die automatische Wiederholung zu konfigurieren, wählen Sie **Automatische Wiederholung bei Stufenausfall aktivieren**. Weitere Informationen zur automatischen Wiederholung finden Sie unter. [Konfigurieren Sie eine Phase für den automatischen Wiederholungsversuch bei einem Fehler](stage-retry.md#stage-retry-auto) 1. 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** einen der folgenden Schritte 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 Testaktionsanbieter aus und füllen Sie die entsprechenden Felder aus. 1. 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** einen der folgenden Schritte 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 bei dem Aktionsanbieter um einen handelt. AWS-Service Das Feld **Region** ist standardmäßig auf dieselbe AWS Region wie Ihre Pipeline eingestellt. + 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 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 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 Layer in AWS OpsWorks finden Sie unter [Hinzufügen von Apps](https://docs.aws.amazon.com/opsworks/latest/userguide/workingapps-creating.html) im *AWS OpsWorks Benutzerhandbuch*. Ein end-to-end 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](https://docs.aws.amazon.com/opsworks/latest/userguide/other-services-cp.html). + **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 Namen der Vorlagendatei ein und wählen Sie dann den Namen einer Rolle aus, die übernommen werden AWS CloudFormation soll. Geben Sie optional den Namen einer Konfigurationsdatei ein und wählen Sie eine IAM-Fähigkeitsoption aus. + Wählen Sie im **Aktionsmodus** die Option **Änderungssatz erstellen oder ersetzen** aus, geben Sie einen Stacknamen und einen Namen des Änderungssatzes ein und wählen Sie dann den Namen einer Rolle aus, die übernommen werden AWS CloudFormation soll. Geben Sie optional den Namen einer Konfigurationsdatei ein und wählen Sie eine IAM-Fähigkeitsoption. Informationen zur Integration von AWS CloudFormation Funktionen in eine Pipeline finden Sie unter [Continuous Delivery with CodePipeline](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/continuous-delivery-codepipeline.html) 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** Die Amazon ECS-Bereitstellungsaktion erfordert eine `imagedefinitions.json` Datei als Eingabe für die Bereitstellungsaktion. Der Standardname der Datei ist imagedefinitions.json. Wenn Sie einen anderen Dateinamen verwenden, müssen Sie diesen während der Erstellung der Pipeline-Bereitstellungsphase angeben. Weitere Informationen finden Sie unter [Datei imagedefinitions.json für Amazon ECS-Standardbereitstellungsaktionen](file-reference.md#pipelines-create-image-definitions). 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 weitere 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](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-cd-pipeline.html). + **Amazon ECS (Blue/Green) (Amazon ECS (Blau/Grün))** Geben Sie die CodeDeploy Anwendungs- und Bereitstellungsgruppe, die Amazon ECS-Aufgabendefinition und die AppSpec Dateiinformationen ein, und wählen Sie dann **Weiter**. **Anmerkung** Die Aktion **Amazon ECS (Blue/Green) (Amazon ECS (Blau/Grün))** erfordert eine imageDetail.json-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 [ImageDetail.json-Datei für Amazon ECS-Bereitstellungsaktionen blue/green](file-reference.md#file-reference-ecs-bluegreen). Ein Tutorial zum Erstellen einer Pipeline für blaugrüne Bereitstellungen in einem Amazon ECS-Cluster mit CodeDeploy finden Sie unter. [Tutorial: Eine Pipeline mit einer Amazon ECR-Quelle und ECS-to-CodeDeploy Bereitstellung erstellen](tutorials-ecs-ecr-codedeploy.md) + **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 in Service Catalog mit Ihrer Pipeline finden Sie unter[Tutorial: Erstellen Sie eine Pipeline, die in Service Catalog bereitgestellt wird](tutorials-S3-servicecatalog.md). + **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](tutorials-alexa-skills-kit.md). + **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 die Option nicht aktiviert ist, müssen Sie einen Wert unter **S3 object key (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 gespeicherte [ACL](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#canned-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 [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9)-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. ![\[Das Bild zeigt das Cache-Kontrollfeld in der Konsole mit dem folgenden Eintrag: public, max-age=0, no-transform\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/cache_control_values.png) 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 S3-Bereitstellungsaktionsanbieter finden Sie unter[Tutorial: Erstellen Sie eine Pipeline, die Amazon S3 als Bereitstellungsanbieter verwendet](tutorials-s3deploy.md). 1. Um die Phase für die automatische Wiederholung zu konfigurieren, wählen Sie **Automatische Wiederholung bei Stufenausfall aktivieren**. Weitere Informationen zur automatischen Wiederholung finden Sie unter. [Konfigurieren Sie eine Phase für den automatischen Wiederholungsversuch bei einem Fehler](stage-retry.md#stage-retry-auto) 1. Um die Phase für automatisches Rollback zu konfigurieren, wählen Sie **Automatisches Rollback bei Stufenausfall konfigurieren**. Weitere Informationen zum automatischen Rollback finden Sie unter. [Konfigurieren Sie eine Phase für das automatische Rollback](stage-rollback-auto.md) 1. 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. Nachdem Sie die Pipeline erstellt haben, können Sie sie in der Konsole anzeigen. Die Pipeline wird nach dem Erstellen ausgeführt. Weitere Informationen finden Sie unter [Pipelines und Details anzeigen in CodePipeline](pipelines-view.md). Weitere Informationen über die Durchführung von Änderungen an Ihrer Pipeline finden Sie unter [Eine Pipeline bearbeiten in CodePipeline](pipelines-edit.md). ## Erstellen einer Pipeline (CLI) Um die zum Erstellen einer Pipeline AWS CLI zu verwenden, erstellen Sie eine JSON-Datei, um die Pipeline-Struktur zu definieren, und führen dann den **create-pipeline** Befehl mit dem `--cli-input-json` Parameter aus. **Wichtig** Sie können den nicht verwenden AWS CLI , um eine Pipeline zu erstellen, die Partneraktionen enthält. Sie müssen stattdessen die CodePipeline Konsole verwenden. Weitere Informationen zur Pipeline-Struktur finden Sie unter [CodePipeline Referenz zur Pipeline-Struktur](reference-pipeline-structure.md) und [create-pipeline](https://docs.aws.amazon.com/cli/latest/reference/codepipeline/create-pipeline.html) in der CodePipeline [API-Referenz](https://docs.aws.amazon.com/cli/latest/reference/codepipeline). Zum Erstellen einer JSON-Datei verwenden Sie die Beispiel-Pipeline-JSON-Datei, bearbeiten Sie und rufen diese Datei dann auf, wenn Sie den Befehl **create-pipeline** ausführen. **Voraussetzungen:** Sie benötigen den ARN der Servicerolle, für die Sie CodePipeline in erstellt haben[Erste Schritte mit CodePipeline](getting-started-codepipeline.md). Sie verwenden die CodePipeline Dienstrolle ARN in der Pipeline-JSON-Datei, wenn Sie den **create-pipeline** Befehl ausführen. Weitere Informationen zum Erstellen einer Servicerolle finden Sie unter [Erstellen Sie die CodePipeline Servicerolle](pipelines-create-service-role.md). Im Gegensatz zur Konsole besteht bei der Ausführung des **create-pipeline** Befehls in der AWS CLI nicht die Möglichkeit, die CodePipeline Servicerolle für Sie zu erstellen. Die Servicerolle muss bereits vorhanden sein. Sie benötigen den Namen eines S3-Buckets, in dem die Artefakte für die Pipeline gespeichert werden. Dieser Bucket muss sich in derselben Region wie die Pipeline befinden. Sie verwenden den Bucketnamen in der Pipeline-JSON-Datei, wenn Sie den Befehl **create-pipeline** ausführen. Im Gegensatz zur Konsole wird bei der Ausführung des **create-pipeline** Befehls in der AWS CLI kein S3-Bucket zum Speichern von Artefakten erstellt. Der Bucket muss bereits vorhanden sein. **Anmerkung** Auch mit dem Befehl **get-pipeline** erhalten Sie eine Kopie der JSON-Struktur dieser Pipeline. Sie können diese dann in einem Texteditor entsprechend modifizieren. **Topics** **So erstellen Sie die JSON-Datei** 1. Erstellen Sie an einem Terminal (Linux, macOS oder Unix) oder einer Befehlszeile (Windows) eine neue Textdatei in einem lokalen Verzeichnis. 1. (Optional) Sie können eine oder mehrere Variablen auf Pipeline-Ebene hinzufügen. Sie können in 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 auch festlegen, dass Werte zugewiesen werden, wenn Sie die Pipeline in der Konsole starten. **Anmerkung** Es ist zwar optional, Variablen auf Pipeline-Ebene hinzuzufügen, aber bei einer Pipeline, die mit Variablen auf Pipelineebene spezifiziert ist und für die keine Werte bereitgestellt werden, schlägt die Pipeline-Ausführung fehl. Eine Variable auf Pipelineebene 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 im Verlauf jeder Ausführung angezeigt. Sie stellen Variablen auf Pipeline-Ebene mithilfe des Variablen-Attributs in der Pipeline-Struktur bereit. Im folgenden Beispiel `Variable1` hat die Variable den Wert`Value1`. ``` "variables": [ { "name": "Timeout", "defaultValue": "1000", "description": "description" } ] ``` Fügen Sie diese Struktur im folgenden Schritt zu Ihrem Pipeline-JSON oder zum Beispiel-JSON hinzu. Weitere Informationen zu Variablen, einschließlich Namespace-Informationen, finden Sie unter[Variablen-Referenz](reference-variables.md). 1. Ö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 Informationen zum Markieren von Ressourcen in finden Sie CodePipeline unter. [Taggen von -Ressourcen](tag-resources.md) 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. 1. 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](actions-create-cross-region.md). + 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. 1. 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 *MySecondPipeline* mit einer JSON-Datei namens pipeline.json zu erstellen, 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. 1. Um die Pipeline anzuzeigen, öffnen Sie entweder die CodePipeline Konsole und wählen Sie sie aus der Pipeline-Liste aus, oder verwenden Sie den Befehl. **get-pipeline-state** Weitere Informationen finden Sie unter [Pipelines und Details anzeigen in CodePipeline](pipelines-view.md). 1. 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 Ereignisregel manuell erstellen, wie unter beschrieben[Eine EventBridge Regel für eine CodeCommit Quelle erstellen (CLI)](pipelines-trigger-source-repo-changes-cli.md). + Für eine Pipeline mit einer Amazon S3 S3-Quelle müssen Sie die Regel und den AWS CloudTrail Trail für CloudWatch Ereignisse manuell erstellen, wie unter beschrieben[Verbindung zu Amazon S3 S3-Quellaktionen herstellen, die EventBridge und verwenden AWS CloudTrail](create-cloudtrail-S3-source.md). ## Erstellen Sie eine Pipeline aus statischen Vorlagen Sie können in der Konsole eine Pipeline erstellen, die eine Vorlage verwendet, um eine Pipeline mit von Ihnen festgelegtem Quellcode und Eigenschaften zu konfigurieren. Sie müssen den Speicherort der Quelldatei und Informationen zu den Quellanbietern angeben, die Sie für Ihre Aktionen verwenden werden. Sie können eine Quellaktion für Amazon ECR oder ein von unterstütztes Drittanbieter-Repository angeben, z. B. CodeConnections GitHub Die Vorlage erstellt einen Stack-In CloudFormation für Ihre Pipeline, der die folgenden Ressourcen enthält: + Eine Pipeline wird mit dem Pipeline-Typ V2 erstellt. Wählen Sie **unter Pipeline-Typ** eine der folgenden Optionen aus. Die Pipeline-Typen unterscheiden sich in ihren Eigenschaften und im Preis. Weitere Informationen finden Sie unter [Arten von Pipelines](pipeline-types.md). + Eine Servicerolle wird für Ihre Pipeline erstellt und in der Vorlage referenziert. + Ein Artefaktspeicher wird mithilfe des Standardartefaktspeichers, z. B. des als Standard festgelegten S3-Artefakt-Buckets, für Ihre Pipeline in der Pipeline erstellt, die AWS-Region Sie für Ihre Pipeline ausgewählt haben. Eine Sammlung von Open-Source-Startvorlagen, die für den Assistenten zur Erstellung statischer Vorlagen verwendet werden, finden Sie im Repository unter. [https://github.com/aws/codepipeline-starter-templates](https://github.com/aws/codepipeline-starter-templates) Wenn Sie statische Vorlagen verwenden, um eine Pipeline zu erstellen, wird die Pipeline-Struktur in jeder Vorlage entsprechend den Anforderungen des Anwendungsfalls konfiguriert. In diesem Verfahren CloudFormation wird beispielsweise die Vorlage für eine Bereitstellung als Beispiel verwendet. Die Vorlage generiert eine Pipeline **DeployToCloudFormationService**mit dem Namen der folgenden Struktur: + Eine Erstellungsphase, die eine Quellaktion mit einer Konfiguration enthält, die Sie im Assistenten angeben. + Eine Bereitstellungsphase mit einer Bereitstellungsaktion und einem zugehörigen Ressourcenstapel CloudFormation. Wenn Sie eine statische Vorlage verwenden, um eine Pipeline zu erstellen, CodePipeline erstellt die Namen der Stufen (Source, Build, Staging). Diese Namen können nicht geändert werden. Sie können spezifischere Namen (z. B. BuildToGamma oder DeployToProd) für Stufen verwenden, die Sie später hinzufügen. **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](https://console.aws.amazon.com/codesuite/codepipeline/home). 1. Klicken Sie auf der Seite **Welcome** auf **Create pipeline**. Wenn Sie es zum ersten Mal verwenden CodePipeline, wählen Sie **Get Started**. **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 in ECR oder CloudFormation bereitgestellt werden. Wählen Sie für dieses Beispiel **Deployment** und anschließend Deployment to CloudFormation aus. + Wählen Sie **Continuous Integration**, wenn Sie eine CI-Pipeline erstellen möchten. Sehen Sie sich die Optionen für CI-Pipelines an, z. B. Building to 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. 1. ![\[Das Bild zeigt die Option „Vorlage auswählen“, wobei die CloudFormation Bereitstellung im Assistenten ausgewählt wurde\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/create-static-choose-template-depl.png) ![\[Das Bild zeigt die Seite „Quelle auswählen“ im Assistenten\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/create-static-choose-template-CI.png) ![\[Das Bild zeigt die Option „Vorlage auswählen“ mit der im Assistenten ausgewählten Automatisierung\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/create-static-choose-template-auto.png) **Schritt 3: Quelle wählen** + Wählen Sie auf der Seite **Schritt 3: Quelle auswählen** unter **Quellanbieter** den Anbieter für das Repository aus, in dem Ihr Quellcode gespeichert ist, geben Sie die erforderlichen Optionen an und klicken Sie dann auf **Nächster Schritt**. + Für **Bitbucket Cloud GitHub (über GitHub App), GitHub Enterprise Server, GitLab .com oder GitLab selbstverwaltet**: 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 unter[GitHub Verbindungen](connections-github.md). 1. Wählen Sie das Repository aus, das Sie als Quellverzeichnis 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 unter[Trigger mit Code-Push- oder Pull-Request-Ereignistypen hinzufügen](pipelines-filter.md). Weitere Informationen zum Filtern mit Glob-Mustern finden Sie unter[Arbeiten mit Glob-Mustern in der Syntax](syntax-glob.md). 1. Wählen Sie unter **Ausgabeartefaktformat** das Format für Ihre Artefakte aus. + Um die Ausgabeartefakte der GitHub Aktion mit der Standardmethode zu speichern, wählen Sie **CodePipelineStandard**. 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 beschrieben. [Problembehebung CodePipeline](troubleshooting.md) Ein Tutorial, das Ihnen zeigt, wie Sie die Option **Vollständiges Klonen** verwenden, finden Sie unter[Tutorial: Vollständigen Klon mit einer GitHub Pipeline-Quelle verwenden](tutorials-github-gitclone.md). + 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** die Standardeinstellung für das Ausgabeartefakt aus, z. B. das MyApp Element, das den Bildnamen und die Repository-URI-Informationen enthält, die in der nächsten Phase verwendet werden sollen. 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 [ImageDetail.json-Datei für Amazon ECS-Bereitstellungsaktionen blue/green](file-reference.md#file-reference-ecs-bluegreen). **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 Beanstalk-Umgebungen und](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/customize-containers.html) unterstützten Plattformen.](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/concepts.platforms.html) [Weitere Informationen zur Bereitstellung von Revisionen mit finden Sie unter [Upload Your](https://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-steps.html#deployment-steps-uploading-your-app) Application Revision CodeDeploy und Prepare a 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. ![\[Das Bild zeigt die Seite „Vorlage konfigurieren“ im Assistenten\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/create-static-conf-template.png) 1. Geben Sie in **Schritt 4: Vorlage konfigurieren** im Feld **Stackname** einen Namen für Ihre Pipeline ein. 1. Bearbeiten Sie die Platzhalter-IAM-Richtlinie für die Berechtigungen, die für Ihre Vorlage gelten. 1. Wählen Sie **Pipeline aus Vorlage erstellen** aus 1. 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 anzeigen und den Stack darin anzeigen CloudFormation. Die Pipeline wird nach dem Erstellen ausgeführt. Weitere Informationen finden Sie unter [Pipelines und Details anzeigen in CodePipeline](pipelines-view.md). Weitere Informationen über die Durchführung von Änderungen an Ihrer Pipeline finden Sie unter [Eine Pipeline bearbeiten in CodePipeline](pipelines-edit.md).