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 EC2 Amazon-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 denen Sie erstellt habenTutorial: Erstellen einer einfachen Pipeline (CodeCommit-Repository).

• 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 | JSON

  • Laden Sie die Beispielvorlage für Ihren CloudTrail Bucket und Trail herunter: YAML | JSON

  • Entpacken Sie die Dateien und speichern Sie sie auf Ihrem lokalen Computer.

• Laden Sie die Beispielanwendung von 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).

2. 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.

3. 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.

   2. Geben Sie BetaFleetunter den Namen Ihrer CodeDeploy Bereitstellungsgruppe ein. Sie können den DemoFleet-Standardnamen ersetzen.

   3. Geben SourceObjectKeySie einSampleApp_Linux.zip. Laden Sie diese Datei in Ihren Bucket hoch, nachdem die Vorlage den Bucket und die Pipeline erstellt hat.

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

5. 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.

6. 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"
   }

7. Sehen Sie sich AWS 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 AWS 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 AWS 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.

8. Melden Sie sich bei der an AWS Management Console und öffnen Sie die CodePipeline Konsole unter 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.

9. 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.

2. 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.

3. 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. SourceObjectKeyAkzeptieren Sie unter die Standardeinstellung für die ZIP-Datei der Beispielanwendung.

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

5. 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.

6. 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"
   }

7. Melden Sie sich bei der an AWS Management Console und öffnen Sie die CodePipeline Konsole unter 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.

8. 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.