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 funzioni Lambda durevoli
Per iniziare a usare le funzioni durevoli Lambda, usa la console Lambda per creare una funzione durevole. In pochi minuti, puoi creare e implementare una funzione durevole che utilizza passaggi e attese per dimostrare l'esecuzione basata su checkpoint.
Mentre svolgi il tutorial, imparerai i concetti fondamentali delle funzioni durevoli, come usare l'DurableContextoggetto, creare checkpoint con passaggi e mettere in pausa l'esecuzione con attese. Imparerai anche come funziona il replay quando la funzione riprende dopo un'attesa.
A scopo di semplificazione, crea la funzione utilizzando il runtime Python o Node.js. Con questi linguaggi interpretati, puoi modificare il codice della funzione direttamente nell'editor del codice integrato della console.
Suggerimento
Per scoprire come creare soluzioni serverless, consulta la Guida allo sviluppo serverless.
Prerequisiti
Se non ne hai uno Account AWS, completa i seguenti passaggi per crearne uno.
Per iscriverti a un Account AWS
Apri la https://portal.aws.amazon.com/billing/registrazione.
Segui le istruzioni online.
Nel corso della procedura di registrazione riceverai una telefonata o un messaggio di testo e ti verrà chiesto di inserire un codice di verifica attraverso la tastiera del telefono.
Quando ti iscrivi a un Account AWS, Utente root dell'account AWSviene creato un. L’utente root dispone dell’accesso a tutte le risorse e tutti i Servizi AWS nell’account. Come best practice di sicurezza, assegna l’accesso amministrativo a un utente e utilizza solo l’utente root per eseguire attività che richiedono l’accesso di un utente root.
AWS ti invia un'email di conferma dopo il completamento della procedura di registrazione. In qualsiasi momento, puoi visualizzare l'attività corrente del tuo account e gestirlo accedendo a https://aws.amazon.com/
Dopo esserti registrato Account AWS, proteggi Utente root dell'account AWS AWS IAM Identity Center, abilita e crea un utente amministrativo in modo da non utilizzare l'utente root per le attività quotidiane.
Proteggi i tuoi Utente root dell'account AWS
-
Accedi Console di gestione AWS
come proprietario dell'account scegliendo Utente root e inserendo il tuo indirizzo Account AWS email. Nella pagina successiva, inserisci la password. Per informazioni sull’accesso utilizzando un utente root, consulta la pagina Signing in as the root user della Guida per l’utente di Accedi ad AWS .
-
Abilita l’autenticazione a più fattori (MFA) per l’utente root.
Per istruzioni, consulta Abilitare un dispositivo MFA virtuale per l'utente Account AWS root (console) nella Guida per l'utente IAM.
Crea un utente con accesso amministrativo
-
Abilita il Centro identità IAM.
Per istruzioni, consulta Abilitazione di AWS IAM Identity Center nella Guida per l’utente di AWS IAM Identity Center .
-
In IAM Identity Center, assegna l’accesso amministrativo a un utente.
Per un tutorial sull'utilizzo di IAM Identity Center directory come fonte di identità, consulta Configurare l'accesso utente con l'impostazione predefinita IAM Identity Center directory nella Guida per l'AWS IAM Identity Center utente.
Accesso come utente amministratore
-
Per accedere con l’utente IAM Identity Center, utilizza l’URL di accesso che è stato inviato al tuo indirizzo e-mail quando hai creato l’utente IAM Identity Center.
Per informazioni sull'accesso utilizzando un utente IAM Identity Center, consulta AWS Accedere al portale di accesso nella Guida per l'Accedi ad AWS utente.
Assegna l’accesso a ulteriori utenti
-
In IAM Identity Center, crea un set di autorizzazioni conforme alla best practice dell’applicazione di autorizzazioni con il privilegio minimo.
Segui le istruzioni riportate nella pagina Creazione di un set di autorizzazioni nella Guida per l’utente di AWS IAM Identity Center .
-
Assegna al gruppo prima gli utenti e poi l’accesso con autenticazione unica (Single Sign-On).
Per istruzioni, consulta Aggiungere gruppi nella Guida per l’utente di AWS IAM Identity Center .
Crea una funzione Lambda durevole con la console
In questo esempio, la tua funzione duratura elabora un ordine attraverso più passaggi con checkpoint automatico. La funzione accetta un oggetto JSON contenente un ID dell'ordine, convalida l'ordine, elabora il pagamento e conferma l'ordine. Ogni passaggio viene controllato automaticamente, quindi se la funzione viene interrotta, riprende dall'ultimo passaggio completato.
La funzione dimostra anche un'operazione di attesa, che sospende l'esecuzione per un breve periodo per simulare l'attesa di una conferma esterna.
Per creare una funzione duratura con la console
Aprire la pagina Funzioni
della console Lambda. -
Scegli Crea funzione.
-
Scegli Crea da zero.
-
Nel riquadro Informazioni base, per Nome funzione inserisci
.myDurableFunction -
Per Runtime, scegli Node.js 24 o Python 3.14.
-
Seleziona Abilita esecuzione duratura.
Lambda crea una funzione durevole con un ruolo di esecuzione che include le autorizzazioni per le operazioni di checkpoint (e). lambda:CheckpointDurableExecutions lambda:GetDurableExecutionState
Nota
I runtime Lambda includono l'SDK Durable Execution, che consente di testare funzioni durevoli senza dipendenze dai pacchetti. Tuttavia, consigliamo di includere l'SDK nel pacchetto di distribuzione per la produzione. Ciò garantisce la coerenza delle versioni ed evita potenziali aggiornamenti di runtime che potrebbero influire sulla funzionalità.
Usa l'editor di codice integrato nella console per aggiungere il tuo codice funzionale durevole.
Invoca la funzione durable utilizzando l'editor di codice della console
Le funzioni durevoli richiedono un ARN qualificato per la chiamata. Prima di poter richiamare la funzione duratura, pubblicane una versione.
Per pubblicare una versione della tua funzione
-
Scegli la scheda Versioni.
-
Selezionare Publish new version (Pubblica nuova versione).
-
Per la descrizione della versione, inserisci
Initial version(opzionale). -
Seleziona Pubblica.
-
Lambda crea la versione 1 della tua funzione. Nota che la funzione ARN ora include
:1alla fine, a indicare che si tratta della versione 1.
Ora crea un evento di test da inviare alla tua funzione. L'evento è un documento in formato JSON contenente un ID dell'ordine.
Per creare un evento di test
-
Nella sezione TEST EVENTS dell'editor di codice della console, scegli Crea evento di test.
-
Per Event name (Nome evento), immettere
myTestEvent. -
Nella sezione JSON dell'evento, sostituisci il codice JSON predefinito con il seguente:
{ "orderId": "order-12345" } -
Scegli Save (Salva).
Per testare la tua funzione duratura e visualizzarne l'esecuzione
Nella sezione TEST EVENTS dell'editor di codice della console, scegli l'icona di esecuzione accanto all'evento di test:
La tua funzione durevole inizia l'esecuzione. Poiché include un'attesa di 10 secondi, la chiamata iniziale viene completata rapidamente e la funzione riprende dopo il periodo di attesa. È possibile visualizzare l'avanzamento dell'esecuzione nella scheda Esecuzioni durevoli.
Per visualizzare l'esecuzione duratura della funzione
-
Scegli la scheda Esecuzioni durevoli.
-
Cerca la tua esecuzione nell'elenco. L'esecuzione mostra lo stato attuale (In esecuzione, Riuscito o Non riuscito).
-
Scegli l'ID di esecuzione per visualizzare i dettagli, tra cui:
Cronologia dell'esecuzione che mostra quando ogni passaggio è stato completato
Cronologia dei checkpoint
Periodi di attesa
Risultati delle fasi
Puoi anche visualizzare i log della tua funzione in CloudWatch Logs per vedere l'output della console di ogni passaggio.
Per visualizzare i record di invocazione della funzione in Logs CloudWatch
-
Apri la pagina Log groups
della console. CloudWatch -
Scegli il nome del gruppo di log per la funzione (
/aws/lambda/myDurableFunction). -
Scorri verso il basso e scegli il flusso di log per le invocazioni delle funzioni che desideri esaminare.
Dovrebbero essere visualizzate le voci di registro per ogni chiamata della funzione, inclusa l'esecuzione iniziale e la riproduzione dopo l'attesa.
Eliminazione
Quando hai finito di lavorare con la funzione durable di esempio, eliminala. Puoi anche eliminare il gruppo di log che memorizza i log della funzione e il ruolo di esecuzione creato dalla console.
Per eliminare la funzione Lambda
-
Aprire la pagina Functions (Funzioni)
della console Lambda. -
Selezionare la funzione creata.
-
Scegliere Operazioni, Elimina.
-
Inserisci
confirmnel campo di immissione del testo, quindi scegli Elimina.
Come eliminare il gruppo di log
-
Apri la pagina Log groups page (Pagina dei gruppi di log)
della console CloudWatch. -
Scegli il gruppo di log della funzione (
/aws/lambda/myDurableFunction). -
Scegli Actions (Azioni), Delete log group(s) (Elimina gruppo/i di log).
-
Nella finestra di dialogo Delete log group(s) (Elimina gruppo/i di log) scegli Delete (Elimina).
Come eliminare il ruolo di esecuzione
-
Apri la pagina Ruoli
della console AWS Identity and Access Management (IAM). -
Seleziona il ruolo di esecuzione della funzione (ad esempio,
myDurableFunction-role-).31exxmpl -
Scegli Elimina.
-
Nella finestra di dialogo Elimina ruolo, immetti il nome del ruolo, quindi scegli Elimina.
Risorse aggiuntive e fasi successive
Ora che hai creato e testato una funzione semplice e duratura utilizzando la console, procedi nel seguente modo:
-
Scopri i casi d'uso più comuni per funzioni durevoli, tra cui transazioni distribuite, elaborazione degli ordini e flussi di lavoro di revisione umana. Vedi esempi.
-
Scopri come monitorare le esecuzioni durevoli delle funzioni con CloudWatch metriche e cronologia delle esecuzioni. Vedi Monitoraggio e debug.
-
Scopri come richiamare funzioni durevoli in modo sincrono e asincrono e come gestire esecuzioni di lunga durata. Vedi Richiamo di funzioni durevoli.
-
Segui le migliori pratiche per scrivere codice deterministico, gestire le dimensioni dei checkpoint e ottimizzare i costi. Consulta le migliori pratiche.
-
Scopri come testare funzioni durevoli a livello locale e nel cloud. Vedi Testare funzioni durevoli.