Abilita i nuovi tentativi per le funzioni basate su eventi (2ª generazione)
Questo documento descrive come abilitare i nuovi tentativi per le funzioni basate su eventi. I nuovi tentativi automatici non sono disponibili per le funzioni HTTP.
Semantica del nuovo tentativo
Cloud Functions offre l'esecuzione "atleast-once" di una funzione basata su eventi per ogni evento emesso da un'origine evento. Per impostazione predefinita, se la chiamata di una funzione termina con un errore, la funzione non viene richiamata di nuovo e l'evento viene eliminato. Quando abiliti i nuovi tentativi su una funzione basata su eventi, Cloud Functions riprendi una chiamata di funzione non riuscita fino a quando non viene completata correttamente o fino alla scadenza della finestra di nuovo tentativo.
Questa finestra per i nuovi tentativi scade dopo 24 ore. Cloud Functions riprova a utilizzare le funzioni basate su eventi appena create utilizzando una strategia di backoff esponenziale, con un backoff crescente compreso tra 10 e 600 secondi.Quando i nuovi tentativi non sono abilitati per una funzione (impostazione predefinita), la funzione
segnala sempre che è stata eseguita correttamente e i codici di risposta di 200 OK
potrebbero
essere visualizzati nei suoi log. Ciò si verifica anche se la funzione ha riscontrato un errore. Per
chiarire quando la tua funzione rileva un errore, assicurati di
segnalare gli errori
in modo adeguato.
Perché le funzioni basate su eventi non vengono completate
In rare occasioni, è possibile che una funzione venga chiusa prematuramente a causa di un errore interno. Per impostazione predefinita, la funzione potrebbe essere oggetto di un nuovo tentativo automatico.
Più in genere, una funzione basata su eventi potrebbe non riuscire a essere completata correttamente a causa di errori generati nel codice della funzione stessa. Ciò potrebbe verificarsi:
- La funzione contiene un bug e il runtime genera un'eccezione.
- La funzione non può raggiungere un endpoint di servizio o si verifica un timeout durante il tentativo.
- La funzione genera intenzionalmente un'eccezione (ad esempio, quando un parametro non supera la convalida).
- Una funzione Node.js restituisce una promessa rifiutata o passa un valore diverso da
null
a un callback.
In ognuno di questi casi, l'esecuzione della funzione viene interrotta per impostazione predefinita e l'evento viene ignorato. Per riprovare la funzione quando si verifica un errore, puoi modificare il criterio predefinito per i nuovi tentativi impostando la proprietà "Riprova in caso di errore". Questo fa sì che l'evento venga ripetuto più volte fino al completamento della funzione o fino alla scadenza del timeout per il nuovo tentativo.
Abilita o disabilita i nuovi tentativi
Per abilitare o disabilitare i nuovi tentativi, puoi utilizzare lo strumento a riga di comando gcloud
o la console Google Cloud. Per impostazione predefinita, i nuovi tentativi sono disattivati.
Configura i nuovi tentativi dallo strumento a riga di comando gcloud
Per abilitare i nuovi tentativi utilizzando lo strumento a riga di comando gcloud
, includi il flag --retry
durante il deployment della funzione:
gcloud functions deploy FUNCTION_NAME --retry FLAGS...
Per disabilitare i nuovi tentativi, esegui nuovamente il deployment della funzione senza il flag --retry
:
gcloud functions deploy FUNCTION_NAME FLAGS...
Configura i nuovi tentativi dalla console
Se stai creando una nuova funzione:
- Nella schermata Crea funzione, in Attivatore, scegli il tipo di evento che agisca da trigger per la funzione.
- Seleziona la casella di controllo Riprova in caso di errore per abilitare i nuovi tentativi.
Se stai aggiornando una funzione esistente:
- Nella pagina Panoramica di Cloud Functions, fai clic sul nome della funzione che stai aggiornando per aprire la schermata Dettagli funzione, quindi scegli Modifica dalla barra dei menu per visualizzare il riquadro Trigger.
- Seleziona o deseleziona la casella di controllo Riprova in caso di errore per attivare o disattivare i nuovi tentativi.
Best practice
In questa sezione vengono descritte le best practice per l'utilizzo di nuovi tentativi.
Utilizza Riprova per gestire gli errori temporanei
Poiché la funzione viene ripetuta continuamente fino alla riuscita dell'esecuzione, gli errori permanenti come i bug devono essere eliminati dal codice tramite test prima di abilitare nuovi tentativi. I nuovi tentativi sono ideali per gestire errori intermittenti o temporanei che hanno un'alta probabilità di risoluzione al momento di nuovi tentativi, come un endpoint di servizio instabile o un timeout.
Imposta una condizione di fine per evitare loop infiniti di nuovi tentativi
Una best practice consiste nel proteggere la funzione dai loop continui quando utilizzi nuovi tentativi. Per farlo, includi una condizione di fine ben definita, prima dell'inizio dell'elaborazione della funzione. Tieni presente che questa tecnica funziona solo se la funzione viene avviata correttamente ed è in grado di valutare la condizione di fine.
Un approccio semplice ma efficace consiste nell'ignorare gli eventi con timestamp precedenti a un determinato orario. Ciò consente di evitare esecuzioni eccessive quando gli errori sono persistenti o hanno una durata maggiore del previsto.
Ad esempio, questo snippet di codice elimina tutti gli eventi più vecchi di 10 secondi:
Node.js
Python
Go
Java
C#
Ruby
PHP
Distinguere tra funzioni che è possibile ritentare e errori irreversibili
Se per la funzione sono abilitati nuovi tentativi, qualsiasi errore non gestito attiverà un nuovo tentativo. Assicurati che il codice acquisisca tutti gli errori che non dovrebbero comportare un nuovo tentativo.
Node.js
Python
Go
Java
C#
Ruby
PHP
Rendi idempotenti le funzioni basate su eventi ritentabili
Le funzioni basate su eventi che è possibile ritentare devono essere idempotenti. Ecco alcune linee guida generali per rendere questa funzione idempotente:
- Molte API esterne (come Stripe) ti consentono di fornire una chiave di idempotenza come parametro. Se utilizzi un'API di questo tipo, devi utilizzare l'ID evento come chiave di idempotenza.
- L'idempotenza funziona bene con la consegna "at-least-once", perché consente di riprovare in sicurezza. Pertanto, una best practice generale per scrivere codice affidabile è combinare l'idempotenza con nuovi tentativi.
- Assicurati che il tuo codice sia internamente idempotente. Ad esempio:
- Assicurati che le mutazioni possano verificarsi più di una volta senza modificare il risultato.
- Esegui una query sullo stato del database in una transazione prima di modificare lo stato.
- Assicurati che tutti gli effetti collaterali siano idempotenti.
- Impone un controllo transazionale all'esterno della funzione, indipendentemente dal codice. Ad esempio, uno stato permanente che registra che un determinato ID evento è già stato elaborato.
- Gestire chiamate di funzione duplicate fuori banda. Ad esempio, imposta un processo di pulizia separato dopo chiamate di funzione duplicate.
Configura il criterio per i nuovi tentativi
A seconda delle esigenze della tua Cloud Function, ti consigliamo di configurare direttamente il criterio per riprovare. Questo ti consente di configurare qualsiasi combinazione di quanto segue:
- Riduci la finestra per i nuovi tentativi da 7 giorni a meno di 10 minuti.
- Modificare il tempo minimo e massimo di backoff per la strategia di nuovo tentativo di backoff esponenziale.
- Modifica la strategia per riprovare immediatamente.
- Configura un argomento messaggi non recapitabili.
- Imposta un numero massimo e minimo di tentativi di consegna.
Per configurare il criterio per i nuovi tentativi:
- Scrivi una funzione HTTP.
- Utilizza l'API Pub/Sub per creare un abbonamento Pub/Sub, specificando l'URL della funzione come destinazione.
Consulta la documentazione di Pub/Sub sulla gestione degli errori per ulteriori informazioni sulla configurazione diretta di Pub/Sub.
Passaggi successivi
- Deployment di Cloud Functions.
- Chiamata alle funzioni trigger Cloud Pub/Sub.
- Chiamata alle funzioni di trigger di Cloud Storage.
- Tutorial su Cloud Functions con Cloud Pub/Sub.
- Tutorial su Cloud Functions con Cloud Storage.