Creazione di un flusso di lavoro con Workflow Studio in Step Functions - AWS Step Functions
Creazione di una macchina a statiProgetta un flusso di lavoroEsegui il tuo flusso di lavoroModifica il tuo flusso di lavoroEsporta il flusso di lavoroCreazione di un prototipo di flusso di lavoro con segnaposti

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

Creazione di un flusso di lavoro con Workflow Studio in Step Functions

Impara a creare, modificare ed eseguire flussi di lavoro utilizzando Step Functions Workflow Studio. Quando il flusso di lavoro è pronto, puoi salvarlo, eseguirlo ed esportarlo.

Creazione di una macchina a stati

In Workflow Studio, puoi scegliere un modello iniziale o un modello vuoto per creare un flusso di lavoro.

Un modello iniziale è un progetto di ready-to-run esempio che crea automaticamente il prototipo e la definizione del flusso di lavoro e distribuisce tutte le AWS risorse correlate di cui il progetto ha bisogno per il vostro progetto. Account AWSÈ possibile utilizzare questi modelli iniziali per distribuirli ed eseguirli così come sono oppure utilizzare i prototipi del flusso di lavoro per svilupparli. Per ulteriori informazioni sui modelli iniziali, consulta. Implementa una macchina a stati utilizzando un modello di avvio per Step Functions

Con un modello vuoto, puoi utilizzare la modalità Progettazione o Codice per creare il tuo flusso di lavoro personalizzato.

Crea una macchina a stati utilizzando un modello di avvio

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

  2. Nella finestra di dialogo Scegli un modello, effettuate una delle seguenti operazioni per scegliere un progetto di esempio:

    • Digitate Task Timer nella casella Cerca per parola chiave, quindi scegliete Task Timer dai risultati della ricerca.

    • Sfoglia i progetti di esempio elencati in Tutti nel riquadro a destra, quindi scegli Task Timer.

  3. Seleziona Successivo per continuare.

  4. Step Functions elenca quelli AWS servizi utilizzati nel progetto di esempio selezionato. Mostra anche un grafico del flusso di lavoro per il progetto di esempio. Implementa questo progetto sul tuo Account AWS o usalo come punto di partenza per creare i tuoi progetti. In base a come vuoi procedere, scegli Esegui una demo o Sviluppa su di essa.

  5. Scegli Usa modello per continuare con la selezione.

  6. Esegui una di queste operazioni:

    • Se hai selezionato Costruisci su di esso, Step Functions crea il prototipo del flusso di lavoro, ma non distribuisce le risorse nella definizione del flusso di lavoro, quindi puoi continuare a creare il tuo prototipo di flusso di lavoro.

      In Workflow Studiomodalità di progettazione, puoi aggiungere stati al tuo prototipo di flusso di lavoro. In alternativa, puoi passare Modalità codice a utilizzare l'editor di codice integrato per modificare la definizione Amazon States Language (ASL) della tua macchina a stati dalla console Step Functions.

      Importante

      Potrebbe essere necessario aggiornare il segnaposto Amazon Resource Name (ARN) per le risorse utilizzate nel progetto di esempio prima di poter eseguire il flusso di lavoro.

    • Se hai selezionato Esegui una demo, Step Functions crea un progetto di sola lettura che utilizza un AWS CloudFormation modello per distribuire le AWS risorse di quel modello sul tuo. Account AWSÈ possibile visualizzare la definizione della macchina a stati scegliendo la modalità Codice.

      Scegli Distribuisci ed esegui per distribuire il progetto e creare le risorse.

      Tieni presente che la creazione di risorse e IAM autorizzazioni può richiedere fino a 10 minuti per la distribuzione. Durante la distribuzione delle risorse, puoi aprire il link AWS CloudFormation Stack ID per vedere quali risorse vengono fornite.

      Dopo aver creato tutte le risorse, dovresti vedere il progetto nella pagina State machines della console.

      Importante

      Potrebbero essere applicate tariffe standard per ogni servizio utilizzato nel CloudFormation modello.

Crea un flusso di lavoro utilizzando un modello vuoto

Quando vuoi iniziare da un'area di lavoro pulita, crea un flusso di lavoro dal modello vuoto.

  1. Apri la console Step Functions.

  2. Scegli Create state machine (Crea macchina a stati).

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

  4. Scegliete Seleziona per aprire Workflow Studio inmodalità di progettazione.

    Ora puoi iniziare a progettare il tuo flusso di lavoro modalità di progettazione o a scrivere la definizione del flusso di lavoro inModalità codice.

  5. Scegli Config per gestire la configurazione del tuo flusso di lavoro in. modalità Config Ad esempio, fornisci un nome per il tuo flusso di lavoro e scegline il tipo.

Progetta un flusso di lavoro

Quando conosci il nome dello stato che desideri aggiungere, usa la casella di ricerca nella parte superiore Stati del browser per trovarlo. Altrimenti, cerca lo stato che ti serve nel browser e aggiungilo all'area di disegno.

Puoi riordinare gli stati del flusso di lavoro trascinandoli in una posizione diversa nel flusso di lavoro. Mentre trascini uno stato sull'area di lavoro, viene visualizzata una linea che indica dove lo stato verrà inserito nel flusso di lavoro, come mostrato nella schermata seguente:

Schermata illustrativa che mostra la linea blu che indica la destinazione di uno stato.

Dopo che uno stato è stato inserito nell'area di disegno, il relativo codice viene generato automaticamente e aggiunto all'interno della definizione del flusso di lavoro. Per visualizzare la definizione, attiva l'interruttore Definition nel pannello Inspector. Puoi scegliere di Modalità codice modificare la definizione con l'editor di codice integrato.

Dopo aver rilasciato uno stato sull'area di disegno, puoi configurarlo nel Pannello Inspector pannello a destra. Questo pannello contiene le schede Configurazione, Input, Output e Gestione degli errori per ciascuno degli stati o delle API azioni che posizionate sull'area di disegno. È possibile configurare gli stati da includere nei flussi di lavoro nella scheda Configurazione.

Ad esempio, la scheda Configurazione per l'APIazione Lambda Invoke offre le seguenti opzioni:

  • Nome dello stato: è possibile identificare lo stato con un nome personalizzato o accettare il nome generato di default.

  • APImostra quale API azione viene utilizzata dallo stato.

  • Tipo di integrazione: è possibile scegliere il tipo di integrazione del servizio utilizzato per richiamare API azioni su altri servizi.

  • Il nome della funzione fornisce opzioni per:

    • Inserisci il nome di una funzione: puoi inserire il nome della tua funzione o il suoARN.

    • Ottieni il nome della funzione in fase di esecuzione dall'input dello stato: È possibile utilizzare questa opzione per ottenere dinamicamente il nome della funzione dall'input dello stato in base al percorso specificato.

    • Seleziona il nome della funzione: puoi selezionare direttamente tra le funzioni disponibili nel tuo account e nella tua regione.

  • Payload: puoi scegliere di utilizzare lo state input, un JSON oggetto o nessun payload da passare come payload alla tua funzione Lambda. Se lo desideriJSON, puoi includere sia valori statici che valori selezionati dall'input dello stato.

  • (Facoltativo) In alcuni stati è possibile selezionare Attendi il completamento dell'attività o Attendi la richiamata. Se disponibile, puoi scegliere uno dei seguenti modelli di integrazione dei servizi:

    • Nessuna opzione selezionata: Step Functions utilizzerà il modello di Richiesta e risposta integrazione. Step Functions attenderà una HTTP risposta e poi passerà allo stato successivo. Step Functions non aspetterà il completamento di un lavoro. Quando non sono disponibili opzioni, lo stato utilizzerà questo modello.

    • Attendi il completamento dell'operazione: Step Functions utilizzerà il modello di Esegui un processo (.sync) integrazione.

    • Attendi la richiamata: Step Functions utilizzerà il modello di Attendere un callback con il token dell’attività integrazione.

  • (Facoltativo) Per accedere a risorse configurate in modo diverso Account AWS all'interno dei flussi di lavoro, Step Functions fornisce l'accesso su più account. IAMil ruolo per l'accesso tra account diversi offre opzioni per:

    • Fornisci IAM ruolo ARN: specifica il IAM ruolo che contiene le autorizzazioni di accesso alle risorse appropriate. Queste risorse sono disponibili in un account di destinazione, che è un account Account AWS verso il quale si effettuano chiamate tra account.

    • Ottieni IAM il ruolo ARN in fase di esecuzione dall'input dello stato: specifica un percorso di riferimento a una coppia chiave-valore esistente nell'JSONinput dello stato che contiene il ruolo. IAM

  • Lo stato successivo consente di selezionare lo stato successivo a cui si desidera passare.

  • (Facoltativo) Il campo dei commenti non influirà sul flusso di lavoro, ma puoi utilizzarlo per annotare il flusso di lavoro.

Alcuni stati avranno opzioni di configurazione generiche aggiuntive. Ad esempio, la configurazione ECS RunTask dello stato di Amazon contiene un API Parameters campo popolato con valori segnaposto. Per questi stati, puoi sostituire i valori segnaposto con configurazioni adatte alle tue esigenze.

Per eliminare uno stato

È possibile premere backspace, fare clic con il pulsante destro del mouse e scegliere Elimina stato oppure scegliere Elimina nella barra degli strumenti Design.

Esegui il tuo flusso di lavoro

Quando il flusso di lavoro è pronto, puoi eseguirlo e visualizzarne l'esecuzione dalla console Step Functions.

Per eseguire un flusso di lavoro in Workflow Studio

  1. In modalità Progettazione, Codice o Config, scegliete Esegui.

    La finestra di dialogo Avvia esecuzione si apre in una nuova scheda.

  2. Nella finestra di dialogo Avvia esecuzione, effettuate le seguenti operazioni:

    1. (Facoltativo) Per identificare l'esecuzione, è possibile specificare un nome o utilizzare il nome di esecuzione generato di default.

      Nota

      Step Functions accetta nomi per macchine a stati, esecuzioni, attività ed etichette che contengono non ASCII caratteri. Poiché i nomi senza ASCII caratteri non funzionano con Amazon CloudWatch, ti consigliamo di utilizzare solo ASCII caratteri per tenere traccia delle metriche. CloudWatch

    2. (Facoltativo) Nella casella Input, inserisci i valori di input nel JSON formato per eseguire il flusso di lavoro.

    3. Selezionare Start execution (Avvia esecuzione).

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

Modifica il tuo flusso di lavoro

Puoi modificare visivamente un flusso di lavoro esistente in Workflow Studio. modalità di progettazione

Nella console Step Functions, scegli il flusso di lavoro che desideri modificare dalla pagina State machines. Il flusso di lavoro viene aperto in modalità Progettazione di Workflow Studio.

È inoltre possibile modificare la definizione del flusso di lavoro inModalità codice. Scegli il pulsante Codice per visualizzare o modificare la definizione del flusso di lavoro in Workflow Studio.

Nota

Se riscontri errori nel flusso di lavoro, devi correggerli in modalità Progettazione. Non puoi passare alla modalità Codice o Config se nel flusso di lavoro sono presenti errori.

Esporta il flusso di lavoro

Puoi esportare la definizione del flusso di lavoro Amazon States Language (ASL) e il grafico del flusso di lavoro:

  1. Scegli il tuo flusso di lavoro nella console Step Functions.

  2. Nella pagina dei dettagli della macchina a stati, scegli Modifica.

  3. Scegli il pulsante a discesa Azioni, quindi esegui una o entrambe le seguenti operazioni:

    • Per esportare il grafico del flusso di lavoro in un PNG file SVG o, in Esporta grafico, seleziona il formato desiderato.

    • Per esportare la definizione del flusso di lavoro come YAML file JSON o, in Esporta definizione, selezionate il formato desiderato.

Creazione di un prototipo di flusso di lavoro con segnaposti

È possibile utilizzare Workflow Studio o Workflow Studio Application Composer per creare prototipi di nuovi flussi di lavoro che contengono risorse segnaposto che sono risorse denominate che non esistono ancora.

Per creare un prototipo di flusso di lavoro:

  1. Accedi alla console Step Functions.

  2. Scegli Create state machine (Crea macchina a stati).

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

  4. Scegliete Seleziona per aprire Workflow Studio inmodalità di progettazione.

  5. Si apre la modalità Progettazione di Workflow Studio. Progetta il tuo flusso di lavoro in Workflow Studio. Per includere risorse segnaposto:

    1. Scegli lo stato per il quale desideri includere una risorsa segnaposto, quindi in Configurazione:

      • Per gli stati Lambda Invoke, scegli Nome funzione, quindi scegli Inserisci il nome della funzione. Puoi anche inserire un nome personalizzato per la tua funzione.

      • Per gli stati di Amazon SQS Send Message, scegli Queue URL, quindi scegli Entra in coda URL. Inserisci una coda segnaposto. URL

      • Per gli stati di Amazon SNS Publish, scegli un argomento da ArgomentoARN.

      • Per tutti gli altri stati elencati in Azioni, puoi utilizzare la configurazione predefinita.

      Nota

      Se riscontrate errori nel flusso di lavoro, dovete correggerli in modalità Progettazione. Non puoi passare alla modalità Codice o Config se nel flusso di lavoro sono presenti errori.

    2. (Facoltativo) Per visualizzare la ASL definizione generata automaticamente del flusso di lavoro, scegli Definizione.

    3. (Facoltativo) Per aggiornare la definizione del flusso di lavoro in Workflow Studio, scegliete il pulsante Codice.

      Nota

      Se notate errori nella definizione del flusso di lavoro, dovete correggerli in modalità Codice. Non puoi passare alla modalità Design o Config se esistono errori nella definizione del flusso di lavoro.

  6. (Facoltativo) Per modificare il nome della macchina a stati, scegliete l'icona di modifica accanto al nome della macchina a stati predefinita di MyStateMachinee specificate un nome nella casella Nome macchina a stati.

    È inoltre possibile passare modalità Config alla modifica del nome predefinito della macchina a stati.

  7. Specificate le impostazioni del flusso di lavoro, ad esempio il tipo di macchina a stati e il relativo ruolo di esecuzione.

  8. Scegli Create (Crea) .

Ora hai creato un nuovo flusso di lavoro con risorse segnaposto che possono essere utilizzate per creare prototipi. Puoi esportare la definizione del flusso di lavoro e il grafico del flusso di lavoro.

  • Per esportare la definizione del flusso di lavoro come YAML file JSON o file, in modalità Progettazione o Codice, scegli il pulsante a discesa Azioni. Quindi, in Definizione di esportazione, seleziona il formato che desideri esportare. È possibile utilizzare questa definizione esportata come punto di partenza per lo sviluppo locale con. AWS Toolkit for Visual Studio Code

  • Per esportare il grafico del flusso di lavoro in un PNG file SVG or, in modalità Progettazione o Codice, scegli il pulsante a discesa Azioni. Quindi, in Definizione di esportazione, selezionate il formato desiderato.