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.
# Tutorial: Erstellen Sie eine Pipeline mit AWS CloudFormation
Die Beispiele enthalten Beispielvorlagen, mit denen Sie eine Pipeline erstellen können, die Ihre Anwendung bei jeder Änderung des Quellcodes auf Ihren Instanzen bereitstellt. AWS CloudFormation Die Beispielvorlage erstellt eine Pipeline, die in AWS CodePipeline angezeigt werden kann. Die Pipeline erkennt den Eingang einer gespeicherten Änderung über Amazon CloudWatch Events.
**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.
**Topics**
+ [
# Beispiel 1: Erstellen Sie eine AWS CodeCommit Pipeline mit AWS CloudFormation
](tutorials-cloudformation-codecommit.md)
+ [
# Beispiel 2: Erstellen Sie eine Amazon S3 S3-Pipeline mit AWS CloudFormation
](tutorials-cloudformation-s3.md)
# Beispiel 1: Erstellen Sie eine AWS CodeCommit Pipeline mit AWS CloudFormation
In dieser exemplarischen Vorgehensweise erfahren Sie, wie Sie mit der AWS CloudFormation Konsole eine Infrastruktur erstellen, die eine Pipeline umfasst, die mit einem CodeCommit Quell-Repository verbunden ist. In diesem Tutorial verwenden Sie die bereitgestellte Beispielvorlagendatei, um Ihren Ressourcenstapel zu erstellen, der Ihren Artefaktspeicher, Ihre Pipeline und Ressourcen zur Änderungserkennung, wie z. B. Ihre Amazon CloudWatch Events-Regel, umfasst. Nachdem Sie Ihren Ressourcen-Stack erstellt haben AWS CloudFormation, können Sie Ihre Pipeline in der Konsole einsehen. AWS CodePipeline Die Pipeline ist eine zweistufige Pipeline mit einer CodeCommit Quellphase und einer CodeDeploy Bereitstellungsphase.
**Voraussetzungen:**
Sie müssen die folgenden Ressourcen für die Verwendung mit der AWS CloudFormation Beispielvorlage erstellt haben:
+ Sie müssen ein Quellrepository erstellt haben. Sie können das AWS CodeCommit Repository verwenden, in dem Sie es erstellt haben[Tutorial: Erstellen Sie eine einfache Pipeline (CodeCommit Repository)](tutorials-simple-codecommit.md).
+ Sie müssen eine CodeDeploy Anwendung und eine Bereitstellungsgruppe erstellt haben. Sie können die in [Tutorial: Erstellen Sie eine einfache Pipeline (CodeCommit Repository)](tutorials-simple-codecommit.md)erstellten CodeDeploy-Ressourcen verwenden.
+ [Wählen Sie einen dieser Links, um die AWS CloudFormation Beispielvorlagendatei für die Erstellung einer Pipeline herunterzuladen: [YAML](samples/codepipeline-codecommit-events-yaml.zip) \$1 JSON](samples/codepipeline-codecommit-events-json.zip)
Entpacken Sie die Datei und speichern Sie sie auf Ihrem lokalen Computer.
+ Laden Sie die Beispielanwendungsdatei [SampleApp\$1Linux.zip](samples/SampleApp_Linux.zip) herunter.
**Erstellen Sie Ihre Pipeline in AWS CloudFormation**
1. Entpacken Sie die Dateien aus [SampleApp\$1Linux.zip](samples/SampleApp_Linux.zip) und laden Sie die Dateien in Ihr AWS CodeCommit Repository hoch. Sie müssen die entpackten Dateien in das Stammverzeichnis Ihres Repositorys hochladen. Sie können den Anweisungen unter [Schritt 2: Fügen Sie Ihrem CodeCommit Repository Beispielcode hinzu](tutorials-simple-codecommit.md#codecommit-add-code) folgen, um die Dateien in Ihr Repository zu übertragen.
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 angeben** 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**
1. Geben Sie **BetaFleet**unter den Namen Ihrer CodeDeploy Bereitstellungsgruppe ein.
1. Geben Sie **BranchName**unter den Repository-Zweig ein, den Sie verwenden möchten.
1. Geben Sie **RepositoryName**unter den Namen Ihres CodeCommit Quell-Repositorys ein.
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 **Stack erstellen** 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, in dem die Pipeline erstellt wird, 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 CodeCommit 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. 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.
**Anmerkung**
Um die erstellte Pipeline anzuzeigen, suchen Sie unter dem Tab **Ressourcen** die Spalte **Logische ID** für Ihren Stack 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-Namen) in der Region anzeigen, in der Sie Ihren Stack erstellt haben.
1. Führen Sie in Ihrem Quellrepository einen Commit für eine Änderung durch und übertragen Sie diese. Ihre Ressourcen für die Änderungserkennung übernehmen die Änderung und Ihre Pipeline startet.
# Beispiel 2: Erstellen Sie eine Amazon S3 S3-Pipeline mit AWS CloudFormation
Diese exemplarische Vorgehensweise zeigt Ihnen, wie Sie mit der AWS CloudFormation Konsole eine Infrastruktur erstellen, die eine Pipeline umfasst, die mit einem Amazon S3 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 umfasst, z. B. Ihre Amazon Events-Regel und Ihren Amazon CloudWatch Events-Trail. CloudTrail Nachdem Sie Ihren Ressourcen-Stack erstellt haben AWS CloudFormation, können Sie Ihre Pipeline in der Konsole einsehen. AWS CodePipeline Die Pipeline ist eine zweistufige Pipeline mit einer Amazon S3 S3-Quellphase und einer CodeDeploy Bereitstellungsphase.
**Voraussetzungen:**
Sie benötigen die folgenden Ressourcen, um sie mit der AWS CloudFormation Beispielvorlage verwenden zu können:
+ Sie müssen die Amazon EC2 EC2-Instances erstellt haben, in denen Sie den CodeDeploy Agenten auf den Instances installiert haben. Sie müssen eine CodeDeploy Anwendung und eine Bereitstellungsgruppe erstellt haben. Verwenden Sie Amazon EC2 und die CodeDeploy Ressourcen, in [Tutorial: Erstellen Sie eine einfache Pipeline (CodeCommit Repository)](tutorials-simple-codecommit.md) denen Sie sie erstellt haben.
+ Wählen Sie die folgenden Links, um die AWS CloudFormation Beispielvorlagendateien für die Erstellung einer Pipeline mit einer Amazon S3 S3-Quelle herunterzuladen:
+ Laden Sie die Beispielvorlage für Ihre Pipeline herunter: [YAML](samples/codepipeline-s3-events-yaml.zip) \$1 [JSON](samples/codepipeline-s3-events-json.zip)
+ [Laden Sie die Beispielvorlage für Ihren CloudTrail Bucket und Trail herunter: [YAML](samples/codepipeline-s3-cloudtrail-yaml.zip) \$1 JSON](samples/codepipeline-s3-cloudtrail-json.zip)
+ Entpacken Sie die Dateien und speichern Sie sie auf Ihrem lokalen Computer.
+ Laden Sie die Beispielanwendung von [SampleApp\$1Linux.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** aus. 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 **BetaFleet**unter 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 **Funktionen** die Option **Ich bestätige, dass AWS CloudFormation möglicherweise IAM-Ressourcen erstellt** werden, und wählen Sie dann **Stack erstellen** 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, in dem die Pipeline erstellt wird, 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 S3-Pipeline erstellen zu können AWS CloudFormation :
```
{
"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 Pipeline anzuzeigen, die erstellt wurde, suchen Sie in der Spalte **Logische ID** auf dem Tab **Ressourcen** für Ihren Stack 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-Namen) 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 S3-Konsole und suchen Sie Ihren `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** aus.
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 auf 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**Akzeptieren 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 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.