Avvio di un flusso di lavoro Step Functions in risposta agli eventi - AWS Step Functions
Prerequisito: creazione di una macchina a statiFase 1: creare un bucket in Amazon S3Fase 2: abilitare la notifica degli eventi di Amazon S3 con EventBridgeFase 3: Creare una EventBridge regola AmazonFase 4: test della regola Esempio di input di esecuzione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Avvio di un flusso di lavoro Step Functions in risposta agli eventi

Puoi eseguire una macchina a AWS Step Functions stati in risposta a un evento indirizzato da una EventBridge regola Amazon a Step Functions come destinazione.

Il seguente tutorial mostra come configurare una macchina a stati come destinazione di una EventBridge regola Amazon. Ogni volta che i file vengono aggiunti a un bucket Amazon Simple Storage Service (Amazon S3), EventBridge la regola avvia la macchina a stati.

Un esempio pratico di questo approccio potrebbe essere una macchina a stati che esegue l'analisi di Amazon Rekognition su file di immagine aggiunti al bucket per classificare e assegnare parole chiave.

In questo tutorial, inizierai l'esecuzione di una macchina a Helloworld stati caricando un file in un bucket Amazon S3. Quindi esamini l'input di esempio di tale esecuzione per identificare le informazioni incluse nell'input della notifica di evento di Amazon S3 inviata a. EventBridge

Prerequisito: creazione di una macchina a stati

Prima di poter configurare una macchina a stati come EventBridge destinazione Amazon, devi creare la macchina a stati.

Fase 1: creare un bucket in Amazon S3

Ora che hai una macchina a Helloworld stati, devi creare un bucket Amazon S3 per archiviare i tuoi file. Nella fase 3 di questo tutorial, imposti una regola in modo che quando un file viene caricato in questo bucket, attivi l'esecuzione della tua EventBridge macchina a stati.

  1. Accedi alla console Amazon S3, quindi scegli Crea bucket per creare il bucket in cui desideri archiviare i file e attivare una regola di evento Amazon S3.

  2. Immettere Bucket name (Nome bucket), come username-sfn-tutorial.

    Nota

    I nomi dei bucket devono essere univoci per tutti i nomi di bucket esistenti in tutte le AWS regioni di Amazon S3. Usa il tuo username per rendere questo nome unico. È necessario creare tutte le risorse nella stessa AWS regione.

  3. Mantieni tutte le selezioni predefinite sulla pagina e scegli Crea bucket.

Fase 2: abilitare la notifica degli eventi di Amazon S3 con EventBridge

Dopo aver creato il bucket Amazon S3, configuralo per inviare eventi EventBridge ogni volta che si verificano determinati eventi nel bucket S3, come i caricamenti di file.

  1. Accedi alla console Amazon S3.

  2. Nell'elenco Bucket (Bucket) scegli il nome del bucket per il quale abilitare gli eventi.

  3. Scegliere Properties (Proprietà).

  4. Scorri la pagina verso il basso per visualizzare la sezione Notifiche eventi, quindi scegli Modifica nella EventBridge sottosezione Amazon.

  5. In Invia notifiche ad Amazon EventBridge per tutti gli eventi in questo bucket, scegli Attivato.

  6. Scegli Save changes (Salva modifiche).

    Nota

    Dopo l'attivazione EventBridge, occorrono circa cinque minuti prima che le modifiche abbiano effetto.

Fase 3: Creare una EventBridge regola Amazon

Dopo aver creato una macchina a stati e aver creato il bucket Amazon S3 e averlo configurato per inviare notifiche di eventi a EventBridge, crea una regola. EventBridge

Nota

È necessario configurare la EventBridge regola nella stessa AWS regione del bucket Amazon S3.

Per creare la regola

  1. Vai alla EventBridge console Amazon, scegli Crea regola.

    Suggerimento

    In alternativa, nel riquadro di navigazione della EventBridge console, scegli Regole in Autobus, quindi scegli Crea regola.

  2. Inserisci un nome per la regola (ad esempioS3Step Functions) e, facoltativamente, inserisci una descrizione per la regola.

  3. Per Event bus e Rule type, mantieni le selezioni predefinite.

  4. Scegli Next (Successivo). Verrà aperta la pagina Build event pattern.

  5. Scorri verso il basso fino alla sezione Event pattern ed esegui le seguenti operazioni:

    1. Per Event source, mantieni la selezione predefinita di AWS eventi o eventi EventBridge partner.

    2. Per l'AWS assistenza, scegli Simple Storage Service (S3).

    3. Per il tipo di evento, scegli Amazon S3 Event Notification.

    4. Scegli Evento/i specifico/i, quindi scegli Oggetto creato.

    5. Scegliete uno o più bucket specifici per nome e inserite il nome del bucket che avete creato nel passaggio 1 (username-sfn-tutorial) per archiviare i file.

    6. Scegli Next (Successivo). Si apre la pagina Seleziona obiettivi.

Per creare il target

  1. In Target 1, mantieni la selezione predefinita del AWS servizio.

  2. Nell'elenco a discesa Seleziona una destinazione, seleziona Step Functions state machine.

  3. Nell'elenco Macchina a stati, seleziona la macchina a stati creata in precedenza (ad esempio,Helloworld).

  4. Mantieni tutte le selezioni predefinite nella pagina e scegli Avanti. Si apre la pagina Configura i tag.

  5. Scegliere Next (Successivo) di nuovo. Si apre la pagina Rivedi e crea.

  6. Rivedi i dettagli della regola e scegli Create rule (Crea regola).

    La regola viene creata e viene visualizzata la pagina Regole, che elenca tutte le EventBridge regole Amazon.

Fase 4: test della regola

Ora che tutto è a posto, prova ad aggiungere un file al bucket Amazon S3, quindi esamina l'input dell'esecuzione della macchina a stati risultante.

  1. Aggiungi un file al tuo bucket Amazon S3.

    Accedi alla console Amazon S3, scegli il bucket che hai creato per archiviare i file (username-sfn-tutorial), quindi scegli Carica.

  2. Aggiungi un file, ad esempiotest.png, quindi scegli Carica.

    In questo modo, viene avviata un'esecuzione della macchina a stati, trasmettendo informazioni da AWS CloudTrail come input.

  3. Controllare l'esecuzione della macchina a stati.

    Vai alla console Step Functions e seleziona la macchina a stati utilizzata nella tua EventBridge regola Amazon (Helloworld).

  4. Seleziona l'esecuzione più recente di quella macchina a stati ed espandi la sezione Execution Input.

    Questo input include informazioni come il nome del bucket e il nome dell'oggetto. In un caso d'uso reale, una macchina a stati può utilizzare questo input per eseguire azioni su quell'oggetto.

Esempio di input di esecuzione

L'esempio seguente mostra un input tipico per l'esecuzione della macchina a stati.

{
    "version": "0",
    "id": "6c540ad4-0671-9974-6511-756fbd7771c3",
    "detail-type": "Object Created",
    "source": "aws.s3",
    "account": "123456789012",
    "time": "2023-06-23T23:45:48Z",
    "region": "us-east-2",
    "resources": [
      "arn:aws:s3:::username-sfn-tutorial"
    ],
    "detail": {
      "version": "0",
      "bucket": {
        "name": "username-sfn-tutorial"
      },
      "object": {
        "key": "test.png",
        "size": 800704,
        "etag": "f31d8546bb67845b4d3048cde533b937",
        "sequencer": "00621049BA9A8C712B"
      },
      "request-id": "79104EXAMPLEB723",
      "requester": "123456789012",
      "source-ip-address": "200.0.100.11",
      "reason": "PutObject"
    }
  }