

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.

# Beispiel 2: Erstellen Sie eine Amazon S3-Pipeline mit AWS CloudFormation
<a name="tutorials-cloudformation-s3"></a>

Diese exemplarische Vorgehensweise zeigt Ihnen, wie Sie mithilfe der AWS CloudFormation Konsole eine Infrastruktur erstellen, die eine Pipeline umfasst, die mit einem Amazon S3-Quell-Bucket verbunden ist. In diesem Tutorial verwenden Sie die bereitgestellte Beispielvorlagendatei, um Ihren Ressourcenstapel zu erstellen, der Ihren Quell-Bucket, Ihren Artefaktspeicher, Ihre Pipeline und Ressourcen zur Änderungserkennung wie Ihre Amazon CloudWatch Events-Regel und Ihren Amazon Events-Trail umfasst. CloudTrail Nachdem Sie Ihren Ressourcenstapel erstellt haben AWS CloudFormation, können Sie Ihre Pipeline in der Konsole anzeigen. AWS CodePipeline Die Pipeline ist eine zweistufige Pipeline mit einer Amazon S3-Quellphase und einer CodeDeploy Bereitstellungsphase.

**Voraussetzungen:**

Sie müssen über die folgenden Ressourcen verfügen, um die AWS CloudFormation Beispielvorlage verwenden zu können:
+ Sie müssen die Amazon EC2-Instances erstellt haben, auf denen Sie den CodeDeploy Agenten installiert haben. Sie müssen eine CodeDeploy Anwendung und eine Bereitstellungsgruppe erstellt haben. Verwenden Sie Amazon EC2 und die CodeDeploy Ressourcen, in [Tutorial: Eine einfache Pipeline (CodeCommit Repository) erstellen](tutorials-simple-codecommit.md) denen Sie erstellt haben.
+ Wählen Sie die folgenden Links, um die AWS CloudFormation Beispielvorlagendateien für die Erstellung einer Pipeline mit einer Amazon S3-Quelle herunterzuladen: 
  + Laden Sie die Beispielvorlage für Ihre Pipeline herunter: [YAML](samples/codepipeline-s3-events-yaml.zip) \| [JSON](samples/codepipeline-s3-events-json.zip)
  + Laden Sie die Beispielvorlage für Ihren CloudTrail Bucket und Ihren Trail herunter: [ YAML ](samples/codepipeline-s3-cloudtrail-yaml.zip) \| JSON [samples/codepipeline-s3-cloudtrail-json.zip](samples/codepipeline-s3-cloudtrail-json.zip)
  + Entpacken Sie die Dateien und speichern Sie sie auf Ihrem lokalen Computer.
+ Laden Sie die Beispielanwendung von [ SampleApp \_ Linux.zip ](samples/SampleApp_Linux.zip) herunter.

  Speichern Sie die ZIP-Datei auf Ihrem lokalen Computer. Laden Sie die ZIP-Datei hoch, nachdem der Stack erstellt wurde.

**Erstellen Sie Ihre Pipeline in AWS CloudFormation**

1. Öffnen Sie die AWS CloudFormation Konsole und wählen Sie ** Create Stack**. Wählen Sie **Mit neuen Ressourcen (Standard)**.

1. **Wählen Sie unter Vorlage auswählen ** die Option Vorlage ** hochladen aus**. **Wählen Sie Datei ** auswählen und wählen Sie dann die Vorlagendatei von Ihrem lokalen Computer aus. Wählen Sie **Weiter** aus.

1. Geben Sie in das Feld **Stack Name (Stack-Name)** einen Namen für Ihre Pipeline ein. Die durch die Beispielvorlage angegebenen Parameter werden angezeigt. Legen Sie die folgenden Parameter fest: 

   1. Geben Sie unter den Namen Ihrer CodeDeploy Anwendung ein. ** ApplicationName ** Sie können den `DemoApplication`-Standardnamen ersetzen.

   1. Geben Sie in ** BetaFleet ** den Namen Ihrer CodeDeploy Bereitstellungsgruppe ein. Sie können den `DemoFleet`-Standardnamen ersetzen.

   1. Geben ** SourceObjectKey ** Sie ein`SampleApp_Linux.zip`. Laden Sie diese Datei in Ihren Bucket hoch, nachdem die Vorlage den Bucket und die Pipeline erstellt hat.

1. Wählen Sie **Weiter** aus. Übernehmen Sie die Standardeinstellungen auf der folgenden Seite und wählen Sie **Next (Weiter)** aus.

1. Wählen Sie unter ** Capabilities ** die Option ** Ich bestätige, dass AWS CloudFormation möglicherweise IAM-Ressourcen erstellt werden**, und wählen Sie dann ** Create stack ** aus.

1. Nachdem die Erstellung Ihres Stacks abgeschlossen wurde, zeigen Sie die Ereignisliste an, um zu überprüfen, ob Fehler aufgetreten sind.

   **Fehlersuche**

   Der IAM-Benutzer, der die Pipeline erstellt, benötigt AWS CloudFormation möglicherweise zusätzliche Berechtigungen, um Ressourcen für die Pipeline zu erstellen. Die folgenden Berechtigungen sind in der Richtlinie erforderlich, um die erforderlichen Amazon CloudWatch Events-Ressourcen für die Amazon S3-Pipeline erstellen AWS CloudFormation zu können:

   ```
   {
        "Effect": "Allow",
        "Action": [
           "events:PutRule",
           "events:PutEvents",
           "events:PutTargets",
           "events:DeleteRule",
           "events:RemoveTargets",
           "events:DescribeRule"
        ],
        "Resource": "{{resource_ARN}}"
   }
   ```

1. Sehen Sie sich CloudFormation auf der ** Registerkarte ** Ressourcen für Ihren Stack die Ressourcen an, die für Ihren Stack erstellt wurden. 
**Anmerkung**  
Um die erstellte Pipeline anzuzeigen, suchen Sie unter dem ** Tab ** Ressourcen für Ihren Stack nach der ** Spalte ** Logische ID in CloudFormation. Notieren Sie sich den Namen in der ** Spalte ** Physikalische ID für die Pipeline. In CodePipeline können Sie die Pipeline mit derselben physischen ID (Pipeline-Name) in der Region anzeigen, in der Sie Ihren Stack erstellt haben.

   Wählen Sie den S3-Bucket mit einer `sourcebucket`-Beschriftung im Namen aus, z. B. `s3-cfn-codepipeline-sourcebucket-y04EXAMPLE.`. Wählen Sie nicht den Pipeline-Artefakt-Bucket aus.

   Der Quell-Bucket ist leer, da die Ressource von CloudFormation neu erstellt wird. Öffnen Sie die Amazon S3-Konsole und suchen Sie nach Ihrem `sourcebucket` Bucket. Wählen Sie **Upload (Hochladen)** aus, und folgen Sie den Anweisungen, um Ihre `SampleApp_Linux.zip`-ZIP-Datei hochzuladen.
**Anmerkung**  
Wenn Amazon S3 der Quellanbieter für Ihre Pipeline ist, müssen Sie alle Quelldateien, die als eine einzige ZIP-Datei verpackt sind, in Ihren Bucket hochladen. Andernfalls schlägt die Quellaktion fehl.

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CodePipeline Konsole unter [ https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).

   Wählen Sie unter **Pipelines** Ihre Pipeline und dann **View (Anzeigen)** aus. Das Diagramm zeigt die Quell- und Bereitstellungsphase Ihrer Pipeline an.

1. Führen Sie die Schritte im folgenden Verfahren aus, um Ihre AWS CloudTrail -Ressourcen zu erstellen.

**Erstellen Sie Ihre AWS CloudTrail Ressourcen in AWS CloudFormation**

1. Öffnen Sie die AWS CloudFormation Konsole und wählen Sie ** Create Stack**.

1. Wählen Sie unter **Choose a template (Auswahl einer Vorlage)** die Option **Upload a template to Amazon S3 (Vorlage auf Amazon S3 hochladen)**. Wählen Sie ** Durchsuchen ** und wählen Sie dann die Vorlagendatei für die AWS CloudTrail Ressourcen von Ihrem lokalen Computer aus. Wählen Sie **Weiter** aus.

1. Geben Sie unter **Stack name (Stack-Name)** einen Namen für Ihren Ressourcenstapel ein. Die durch die Beispielvorlage angegebenen Parameter werden angezeigt. Legen Sie die folgenden Parameter fest: 

   1. **SourceObjectKey**Übernehmen Sie unter die Standardeinstellung für die ZIP-Datei der Beispielanwendung.

1. Wählen Sie **Weiter** aus. Übernehmen Sie die Standardeinstellungen auf der folgenden Seite und wählen Sie **Next (Weiter)** aus.

1. Wählen Sie unter ** Funktionen ** die Option ** Ich bestätige, dass AWS CloudFormation möglicherweise IAM-Ressourcen erstellt werden**, und wählen Sie dann ** Erstellen ** aus.

1. Nachdem die Erstellung Ihres Stacks abgeschlossen wurde, zeigen Sie die Ereignisliste an, um zu überprüfen, ob Fehler aufgetreten sind.

   Die folgenden Berechtigungen sind in der Richtlinie erforderlich, um die erforderlichen CloudTrail Ressourcen für die Amazon S3-Pipeline erstellen AWS CloudFormation zu können:

   ```
   {
        "Effect": "Allow",
        "Action": [
           "cloudtrail:CreateTrail",
           "cloudtrail:DeleteTrail",
           "cloudtrail:StartLogging",
           "cloudtrail:StopLogging",
           "cloudtrail:PutEventSelectors"
        ],
        "Resource": "{{resource_ARN}}"
   }
   ```

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CodePipeline Konsole unter [ https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).

   Wählen Sie unter **Pipelines** Ihre Pipeline und dann **View (Anzeigen)** aus. Das Diagramm zeigt die Quell- und Bereitstellungsphase Ihrer Pipeline an.

1. Führen Sie in Ihrem Quell-Bucket einen Commit für eine Änderung durch und übertragen Sie diese. Ihre Ressourcen für die Änderungserkennung übernehmen die Änderung und Ihre Pipeline startet.