Creazione di una macchina a stati Step Functions che utilizza Lambda

In questo tutorial, creerai un flusso di lavoro in un unico passaggio utilizzando AWS Step Functions per richiamare una AWS Lambda funzione.

Nota

Step Functions si basa su macchine e attività a stati. In Step Functions, le macchine a stati sono chiamate flussi di lavoro, che sono una serie di passaggi guidati dagli eventi. Ogni fase di un flusso di lavoro è denominata stato. Ad esempio, uno stato Task rappresenta un'unità di lavoro svolta da un altro AWS servizio, ad esempio chiamarne un altro AWS servizio o un'API.

Per ulteriori informazioni, consultare:

• Che cos'è AWS Step Functions?

• Chiama altri servizi AWS

Lambda è ideale per Task gli stati, perché le funzioni Lambda sono senza server e facili da scrivere. Puoi scrivere codice nel AWS Management Console o nel tuo editor preferito. AWS gestisce i dettagli relativi alla fornitura di un ambiente informatico per la funzione e alla sua esecuzione.

Fase 1: Creazione di una funzione Lambda

La funzione Lambda riceve i dati degli eventi e restituisce un messaggio di saluto.

Importante

Assicurati che la tua funzione Lambda utilizzi lo stesso AWS account e la stessa AWS regione della tua macchina a stati.

1. Apri la console Lambda e scegli Crea funzione.

2. Nella pagina Create function (Crea funzione), scegliere Author from scratch (Crea da zero).

3. Nel campo Function name (Nome funzione), immettere HelloFunction.

4. Mantieni le selezioni predefinite per tutte le altre opzioni, quindi scegli Crea funzione.

5. Dopo aver creato la funzione Lambda, copia l'Amazon Resource Name (ARN) della funzione visualizzato nell'angolo superiore destro della pagina. Per copiare l'ARN, fate clic su. Di seguito è riportato un esempio di ARN:

   arn:aws:lambda:us-east-1:123456789012:function:HelloFunction

6. Copia il codice seguente per la funzione Lambda nella sezione Codice sorgente della HelloFunctionpagina.

   export const handler = async(event, context, callback) => {
       callback(null, "Hello from " + event.who + "!");
   };

   Questo codice assembla un saluto utilizzando il campo who dei dati di input, forniti dall'oggetto event passato alla funzione. I dati di input per questa funzione vengono aggiunti in seguito, quando si avvia una nuova esecuzione. Il metodo callback restituisce il saluto assemblato dalla funzione.

7. Seleziona Deploy (Implementa).

Fase 2: testare la funzione Lambda

Prova la tua funzione Lambda per vederla in funzione.

1. Scegli Test (Esegui test).

2. Per Event name (Nome evento) immettere HelloEvent.

3. Sostituisci i dati JSON degli eventi con i seguenti.

   {
       "who": "AWS Step Functions"
   }

   La "who" voce corrisponde al event.who campo della funzione Lambda, che completa il saluto. Immetterai gli stessi dati di input quando eseguirai la tua macchina a stati.

4. Scegli Salva, quindi scegli Test.

5. Per esaminare i risultati del test, in Execution result (Risultato esecuzione), espandi Details (Dettagli).

Passaggio 3: Creare una macchina a stati

Usa la console Step Functions per creare una macchina a stati che richiami la funzione Lambda creata nel passaggio 1.

1. Apri la console Step Functions e scegli Crea macchina a stati.

   Importante

   Assicurati che la tua macchina a stati utilizzi lo stesso AWS account e la stessa regione della funzione Lambda che hai creato in precedenza.

2. Nella finestra di dialogo Scegli un modello, seleziona Vuoto.

3. Scegli Seleziona. Questo apre Workflow Studio inModalità di progettazione.

4. Nel browser States a sinistra, assicurati di aver scelto la scheda Azioni. Successivamente, esegui queste operazioni:

   1. Trascina e rilascia l'API AWS Lambda Invoke nello stato vuoto denominato Drag first state here.

      

5. Nel pannello Inspector a destra, configura la funzione Lambda:

   1. Nella sezione Parametri API, scegli la funzione Lambda che hai creato in precedenza nell'elenco a discesa Nome funzione.

   2. Mantieni la selezione predefinita nell'elenco a discesa Payload.

6. (Facoltativo) Scegliete Definizione per visualizzare la definizione della macchina a stati Amazon States Language (ASL), che viene generata automaticamente in base alle selezioni effettuate nella scheda Azioni e nel pannello Inspector.

7. Specificate un nome per la vostra macchina a stati. Per fare ciò, scegli l'icona di modifica accanto al nome della macchina a stati predefinita di MyStateMachine. Quindi, nella configurazione della macchina a stati, specifica un nome nella casella Nome macchina a stati.

   Ad esempio, è possibile inserire il nome LambdaStateMachine.

   Nota

   I nomi delle macchine a stati, delle esecuzioni e delle attività non devono superare gli 80 caratteri di lunghezza. Questi nomi devono essere univoci per l'account e la AWS regione e non devono contenere nessuno dei seguenti elementi:

   • Spazi bianchi

   • Caratteri jolly () ? *

   • Caratteri tra parentesi quadre () < > { } [ ]

   • Caratteri speciali () " # % \ ^ | ~ ` $ & , ; : /

   • Caratteri di controllo (\\u0000- \\u001f o \\u007f -\\u009f).

   Se la macchina a stati è di tipo Express, è possibile fornire lo stesso nome a più esecuzioni della macchina a stati. Step Functions genera un ARN di esecuzione univoco per ogni esecuzione della macchina a stati Express, anche se più esecuzioni hanno lo stesso nome.

   Step Functions consente di creare nomi per macchine a stati, esecuzioni e attività ed etichette che contengono caratteri non ASCII. Questi nomi non ASCII non funzionano con Amazon. CloudWatch Per assicurarti di poter tenere traccia delle CloudWatch metriche, scegli un nome che utilizzi solo caratteri ASCII.

8. (Facoltativo) Nella configurazione della macchina a stati, specificate altre impostazioni del flusso di lavoro, come il tipo di macchina a stati e il relativo ruolo di esecuzione.

   Per questo tutorial, mantieni tutte le selezioni predefinite nelle impostazioni della macchina a stati.

9. Scegli Crea.

10. Nella finestra di dialogo Conferma creazione del ruolo, scegliete Conferma per continuare.

    Puoi anche scegliere Visualizza le impostazioni del ruolo per tornare alla configurazione della macchina a stati.

    Nota

    Se elimini il ruolo IAM creato da Step Functions, Step Functions non può ricrearlo in un secondo momento. Allo stesso modo, se modifichi il ruolo (ad esempio, rimuovendo Step Functions dai principi nella policy IAM), Step Functions non può ripristinare le impostazioni originali in un secondo momento.

Fase 4: Esegui la macchina a stati

Dopo aver creato la macchina a stati, puoi eseguirla.

1. Nella pagina Macchine a stati, scegli LambdaStateMachine.

2. Selezionare Start execution (Avvia esecuzione).

   Viene visualizzata la finestra di dialogo Avvia esecuzione.

3. (Facoltativo) Per identificare l'esecuzione, è possibile specificare un nome nella casella Nome. Per impostazione predefinita, Step Functions genera automaticamente un nome di esecuzione univoco.

   Nota

   Step Functions consente di creare nomi per macchine a stati, esecuzioni e attività ed etichette che contengono caratteri non ASCII. Questi nomi non ASCII non funzionano con Amazon. CloudWatch Per assicurarti di poter tenere traccia delle CloudWatch metriche, scegli un nome che utilizzi solo caratteri ASCII.

4. Nell'area Input, sostituite i dati di esecuzione di esempio con i seguenti.

   {
       "who" : "AWS Step Functions"
   }

   "who"è il nome chiave utilizzato dalla funzione Lambda per ottenere il nome della persona da salutare.

5. Selezionare Start Execution (Avvia esecuzione).

   L'esecuzione della macchina a stati inizia e viene visualizzata una nuova pagina che mostra l'esecuzione in esecuzione.

6. La console Step Functions ti indirizza a una pagina intitolata con il tuo ID di esecuzione. Questa pagina è nota come pagina dei dettagli di esecuzione. In questa pagina è possibile esaminare i risultati dell'esecuzione man mano che l'esecuzione procede o dopo il suo completamento.

   Per esaminare i risultati dell'esecuzione, scegliete i singoli stati nella vista Grafico, quindi scegliete le singole schede Dettagli del passaggio nel riquadro per visualizzare i dettagli di ogni stato, inclusi rispettivamente input, output e definizione. Per i dettagli sulle informazioni sull'esecuzione che è possibile visualizzare nella pagina Dettagli di esecuzione, vederePagina dei dettagli di esecuzione: panoramica dell'interfaccia.

   

Nota

Puoi anche passare payload mentre richiami Lambda da una macchina a stati. Per ulteriori informazioni ed esempi su come richiamare Lambda inserendo il payload nel Parameters campo, vedere. Richiama Lambda con Step Functions