View a markdown version of this page

Erstellen Sie eine EventBridge Regel für eine Amazon S3-Quelle (Konsole) - AWS CodePipeline

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.

Erstellen Sie eine EventBridge Regel für eine Amazon S3-Quelle (Konsole)

Bevor Sie eine Regel einrichten EventBridge, müssen Sie einen AWS CloudTrail Trail erstellen. Weitere Informationen finden Sie unter Erstellen eines Trails in der Konsole.

Wichtig

Wenn Sie die Konsole verwenden, um Ihre Pipeline zu erstellen oder zu bearbeiten, werden Ihre EventBridge Regel und Ihr AWS CloudTrail Trail für Sie erstellt.

So erstellen Sie einen Trail

  1. Öffnen Sie die AWS CloudTrail Konsole.

  2. Wählen Sie im Navigationsbereich Trails aus.

  3. Wählen Sie Create Trail (Trail erstellen) aus. Geben Sie unter Trail name (Trail-Name) einen Namen für Ihren Trail ein.

  4. Erstellen oder geben Sie unter Storage location (Speicherort) den Bucket an, der zum Speichern der Protokolldateien verwendet werden soll. Standardmäßig werden Amazon-S3-Buckets und -Objekte als privat eingestuft. Nur der Ressourcenbesitzer (das AWS Konto, das den Bucket erstellt hat) kann auf den Bucket und seine Objekte zugreifen. Der Bucket muss über eine Ressourcenrichtlinie verfügen, die AWS CloudTrail Berechtigungen für den Zugriff auf die Objekte im Bucket gewährt.

  5. Geben Sie unter Trail-Log-Bucket und -Ordner einen Amazon S3-Bucket und das Objektpräfix (Ordnername) an, um Datenereignisse für alle Objekte im Ordner zu protokollieren. Sie können jedem Trail 250 Amazon S3-Objekte hinzufügen. Geben Sie die erforderlichen Informationen zum Verschlüsselungsschlüssel ein und wählen Sie Weiter.

  6. Wählen Sie als Ereignistyp die Option Verwaltungsereignisse aus.

  7. Wählen Sie für Management-Ereignisse die Option Write aus. Der Trail zeichnet die Amazon S3-API-Aktivität auf Objektebene (z. B. GetObject undPutObject) für den angegebenen Bucket und das angegebene Präfix auf.

  8. Wählen Sie Write (Schreiben) aus.

  9. Wenn Sie mit dem Trail zufrieden sind, wählen Sie Create trail.

Um eine EventBridge Regel zu erstellen, die auf Ihre Pipeline mit einer Amazon S3-Quelle abzielt

  1. Öffnen Sie die EventBridge Amazon-Konsole unter https://console.aws.amazon.com/events/.

  2. Wählen Sie im Navigationsbereich Regeln aus. Lassen Sie den Standardbus ausgewählt oder wählen Sie einen Event-Bus. Wählen Sie Regel erstellen aus.

  3. Geben Sie im Feld Name einen Namen für Ihre Regel ein.

  4. Wählen Sie unter Regeltyp die Option Regel mit einem Ereignismuster aus. Wählen Sie Weiter aus.

  5. Wählen Sie unter Ereignisquelle AWS Ereignisse oder EventBridge Partnerereignisse aus.

  6. Wählen Sie unter Beispielereignistyp die Option AWS Ereignisse aus.

  7. Geben Sie im Feld Beispielereignisse S3 als Schlüsselwort ein, nach dem gefiltert werden soll. Wählen Sie AWS API-Aufruf über CloudTrail.

  8. Wählen Sie unter Erstellungsmethode die Option Kundenmuster (JSON-Editor) aus.

    Fügen Sie das unten angegebene Event-Muster ein. Stellen Sie sicher, dass Sie den Bucket-Namen und den S3-Objektschlüssel (oder Schlüsselnamen) hinzufügen, der das Objekt im Bucket eindeutig als identifiziertrequestParameters. In diesem Beispiel wird eine Regel für einen Bucket mit dem Namen amzn-s3-demo-source-bucket und dem Objektschlüssel von erstelltmy-files.zip. Wenn Sie das Fenster Edit (Bearbeiten) zum Angeben von Ressourcen verwenden, wird Ihre Regel für die Verwendung eines benutzerdefinierten Ereignismusters aktualisiert.

    Im Folgenden finden Sie ein Beispiel-Ereignismuster, das Sie kopieren und einfügen können:

    {
    "source": [
        "aws.s3"
    ],
    "detail-type": [
        "AWS API Call via CloudTrail"
    ],
    "detail": {
        "eventSource": [
            "s3.amazonaws.com"
        ],
        "eventName": [
            "CopyObject",
            "CompleteMultipartUpload",
            "PutObject"
        ],
        "requestParameters": {
            "bucketName": [
                "amzn-s3-demo-source-bucket"
            ],
            "key": [
                "my-files.zip"
            ]
        }
    }
}

  9. Wählen Sie Weiter aus.

  10. Wählen Sie unter Zieltypen die Option AWS Service aus.

  11. Wählen Sie unter Ziel auswählen die Option CodePipeline. Geben Sie im Feld Pipeline-ARN den Pipeline-ARN für die Pipeline ein, die nach dieser Regel gestartet werden soll.

    Anmerkung

    Um den Pipeline-ARN zu erhalten, führen Sie den Befehl get-pipeline aus. Der Pipeline-ARN wird in der Ausgabe angezeigt. Er wird in folgendem Format erstellt:

    arn:aws:codepipeline:: region account pipeline-name

    Pipeline-Beispiel-ARN:

    arn: aws: codepipeline: us-east- 2:80398 EXAMPLE:MyFirstPipeline

  12. So erstellen oder spezifizieren Sie eine IAM-Servicerolle, die EventBridge Berechtigungen zum Aufrufen des mit Ihrer Regel verknüpften Ziels gewährt (in diesem Fall lautet das Ziel): EventBridge CodePipeline

    • Wählen Sie Neue Rolle für diese spezifische Ressource erstellen aus, um eine Servicerolle zu erstellen, die Ihnen EventBridge Berechtigungen zum Starten Ihrer Pipeline-Ausführungen gewährt.

    • Wählen Sie Bestehende Rolle verwenden aus, um eine Servicerolle einzugeben, die Ihnen EventBridge Berechtigungen zum Starten Ihrer Pipeline-Ausführungen erteilt.

  13. (Optional) Um Quellüberschreibungen mit einer bestimmten Bild-ID anzugeben, verwenden Sie den Eingangstransformator, um die Daten als JSON-Parameter zu übergeben. Sie können den Eingangstransformator auch verwenden, um Pipeline-Variablen zu übergeben.

    • Erweitern Sie Additional settings (Zusätzliche Einstellungen).

      Wählen Sie unter Zieleingang konfigurieren die Option Eingangstransformator konfigurieren aus.

      Wählen Sie im Dialogfenster die Option Eigenen eingeben. Geben Sie in das Feld Eingabepfad die folgenden Schlüssel-Wert-Paare ein.

      {"revisionValue": "$.detail.object.version-id"}

    • Geben Sie in das Feld Vorlage die folgenden Schlüssel-Wert-Paare ein.

      
                                
                                {
    "sourceRevisions": [
        {
            "actionName": "Source",
            "revisionType": "S3_OBJECT_VERSION_ID",
            "revisionValue": "<revisionValue>"
        }
    ],
     "variables": [
        {
            "name": "Variable_Name",
            "value": "Variable_Value"
        }
    ]
}

    • Wählen Sie Bestätigen aus.

  14. Wählen Sie Weiter aus.

  15. Wählen Sie auf der Seite „Tags“ die Option Weiter aus.

  16. Überprüfen Sie auf der Seite Überprüfen und erstellen die Regelkonfiguration. Wenn Sie mit der Regel zufrieden sind, klicken Sie auf Create rule (Regel erstellen).