Utilizzo delle funzioni AWS Step Functions tramite AWS Toolkit - AWS Cloud9

AWS Cloud9 non è più disponibile per i nuovi clienti. I clienti esistenti di AWS Cloud9 possono continuare a utilizzare il servizio normalmente. Scopri di più»

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

Utilizzo delle funzioni AWS Step Functions tramite AWS Toolkit

AWS Toolkit fornisce il supporto per AWS Step Functions. Step Functions consente di creare macchine a stati che definiscono i flussi di lavoro per le funzioni AWS Lambda e altri servizi AWS che supportano le applicazioni business-critical.

È possibile utilizzare AWS Toolkit per eseguire le seguenti operazioni con Step Functions:

  • Creare e pubblicare una macchina a stati, che è un flusso di lavoro composto da singoli passaggi.

  • Scaricare un file che definisce un flusso di lavoro della macchina a stati.

  • Eseguire un flusso di lavoro della macchina a stati con un input inserito o selezionato.

Prerequisiti

Step Functions può eseguire il codice e accedere alle risorse AWS (ad esempio, richiamare una funzione Lambda). Per garantire la sicurezza, è necessario concedere l'accesso a Step Functions a quelle risorse utilizzando un ruolo IAM.

Con AWS Toolkit è possibile utilizzare i ruoli IAM generati automaticamente e che sono validi per la regione AWS in cui si crea la macchina a stati. Per creare un ruolo IAM per una macchina a stati, consulta la sezione Funzionamento di AWS Step Functions con IAM nella Guida per gli sviluppatori di AWS Step Functions.

Creazione e pubblicazione di una macchina a stati

Quando si crea una macchina a stati con AWS Toolkit, è possibile scegliere un modello iniziale che definisca un flusso di lavoro per un business case. Dopodiché, puoi modificare o sostituire il modello in base alle tue esigenze. Per ulteriori informazioni sulla definizione di una macchina a stati in un file che ne rappresenta la struttura, consulta la sezione Amazon States Language nella Guida per gli sviluppatori di AWS Step Functions.

  1. Nel riquadro AWS Explorer, apri il menu contestuale (facendo clic con il pulsante destro del mouse) di Step Functions e scegli Create a new Step Function state machine (Crea una nuova macchina a stati Step Functions).

  2. Nel pannello dei comandi, scegli un modello di avvio per il flusso di lavoro della macchina a stati.

  3. Quindi, scegli un formato per il file ASL (Amazon States Language) che definisce la macchina a stati.

    Viene aperto un editor per visualizzare il file ASL che definisce il flusso di lavoro della macchina a stati.

    Nota

    Per informazioni sulla modifica del file ASL per personalizzare il flusso di lavoro, consulta la sezione Struttura della macchina a stati.

  4. Nel file ASL, scegli Publish to Step Functions (Pubblica in Step Functions) per aggiungere la macchina a stati ad AWS Cloud.

    Nota

    È anche possibile scegliere Render graph (Rendering grafico) nel file ASL per consultare una rappresentazione visiva del flusso di lavoro della macchina a stati.

    JSON code for a Hello World example in Amazon States Language, showing state types and choices.
  5. Nel pannello dei comandi, scegli una regione AWS in cui ospitare la macchina a stati Step Functions.

  6. Successivamente, puoi scegliere se creare una nuova macchina a stati Step Functions o aggiornarne una esistente.

    Quick Create

    Questa opzione consente di creare una nuova macchina a stati Step Functions dal file ASL utilizzando step-functions/latest/dg/concepts-standard-vs-express.html. Viene chiesto di specificare quanto segue:

    • Un ruolo IAM, che consente alla macchina a stati Step Functions di eseguire il codice e accedere alle risorse AWS. È possibile scegliere un ruolo IAM generato automaticamente valido per la regione AWS in cui si crea la macchina a stati.

    • Il nome della nuova funzione.

    È possibile verificare che la macchina a stati sia stata creata correttamente e ottenere il rispettivo ARN nella scheda di output di AWS Toolkit.

    Quick Update

    Se è già presente una macchina a stati nella regione AWS, è possibile sceglierne una da aggiornare con il file ASL corrente.

    È possibile verificare che la macchina a stati sia stata aggiornata correttamente e ottenere il rispettivo ARN nella scheda di output di AWS Toolkit.

    Dopo la creazione, la nuova macchina a stati viene visualizzata nella sezione Step Functions del riquadro AWS Explorer. Se non viene visualizzata immediatamente, scegli il menu Toolkit (Kit di strumenti), Refresh Explorer (Aggiorna Explorer).

Esecuzione di una macchina a stati in AWS Toolkit

È possibile utilizzare AWS Toolkit per eseguire macchine a stati remote. La macchina a stati in esecuzione riceve come input un file JSON e lo trasferisce al primo stato nel flusso di lavoro. I singoli stati ricevono JSON come input e in genere trasferiscono JSON come output allo stato successivo. Per ulteriori informazioni, consulta Elaborazione di input e output in Step Functions.

  1. Nel riquadro AWS Explorer, scegli Step Functions. Apri quindi il menu contestuale (facendo clic con il pulsante destro del mouse) di una macchina a stati specifica e scegli Start Execution (Avvia esecuzione).

  2. Nel riquadro Start Execution (Avvia esecuzione), aggiungi l'input in formato JSON per il flusso di lavoro della macchina a stati inserendo il testo direttamente nel campo sottostante o caricando un file dal dispositivo locale.

  3. Scegli Execute (Esegui).

    Nella scheda di output di AWS Toolkit viene visualizzata la conferma di avvio del flusso di lavoro e l'ARN dell'ID processo. È possibile utilizzare tale ID processo per verificare nella console AWS Step Functions se il flusso di lavoro è stato eseguito correttamente. È inoltre possibile visualizzare i timestamp di avvio e fine del flusso di lavoro.

Download di un file per la definizione della macchina a stati e visualizzazione del relativo flusso di lavoro

Scaricare una macchina a stati significa effettuare il download di un file contenente testo JSON che rappresenta la struttura della macchina in questione. È quindi possibile modificare questo file per creare una nuova macchina a stati o aggiornarne una esistente. Per ulteriori informazioni, consulta la sezione Amazon States Language nella Guida per gli sviluppatori di AWS Step Functions.

  1. Nel riquadro AWS Explorer, scegli Step Functions. Apri quindi il menu contestuale (facendo clic con il pulsante destro del mouse) di una macchina a stati specifica e scegli Download Definition (Scarica definizione).

    Nota

    Il menu contestuale offre anche le opzioni Copy Name (Copia nome) e Copy ARN (Copia ARN).

  2. Nella finestra di dialogo Save (Salva), seleziona la cartella dell'ambiente in cui archiviare il file della macchina a stati scaricato, quindi scegli Save (Salva).

    Il file in formato JSON che definisce il flusso di lavoro della macchina a stati viene visualizzato in un editor.

  3. Per consultare una rappresentazione visiva del flusso di lavoro, scegli Render graph (Rendering grafico).

    Viene aperta una finestra con un diagramma di flusso, che mostra la sequenza degli stati nel flusso di lavoro della macchina.

    Rappresentazione visiva del flusso di lavoro della macchina a stati