Questo tutorial mostra come attivare una funzione Cloud Functions utilizzando Cloud Scheduler e Pub/Sub. La possibilità di pianificare l'esecuzione di una Cloud Function è un caso d'uso comune per Cloud Scheduler. Imparerai a:
- Creare una Cloud Function semplice che sottoscrive un argomento Pub/Sub.
- Creare un job Cloud Scheduler che pubblica un messaggio nell'argomento Pub/Sub.
- Eseguire il job Cloud Scheduler.
- Verifica che la Cloud Function sia stata attivata dal job Cloud Scheduler.
Prima di iniziare
Questo tutorial presuppone che tu abbia già utilizzato la guida rapida di Cloud Scheduler. Di conseguenza, hai a disposizione i seguenti strumenti e risorse:Un progetto Google Cloud con fatturazione abilitata.
L'API Cloud Scheduler e l'API Pub/Sub sono entrambe abilitate nel progetto. Potrai abilitare l'API Cloud Functions durante il tutorial.
Costi
In questo documento vengono utilizzati i seguenti componenti fatturabili di Google Cloud:
- Cloud Functions
- Pub/Sub
- Cloud Scheduler
Per generare una stima dei costi in base all'utilizzo previsto,
utilizza il Calcolatore prezzi.
crea una Cloud Function con un trigger
Nella console Google Cloud, vai alla pagina Cloud Functions.
Fai clic su Abilita API se richiesto.
Fai clic su Crea funzione. Se viene visualizzato un messaggio che richiede di abilitare le API, fai clic su Abilita per attivarle.
Nella sezione Impostazioni di base, seleziona l'ambiente di 2a generazione, inserisci un nome per la funzione e seleziona una regione.
Nella sezione Trigger, in Tipo di trigger, seleziona Cloud Pub/Sub e fai clic su Altre opzioni. Si apre il riquadro Trigger Eventarc. Se viene visualizzato il messaggio Abilita le API richieste, fai clic su Abilita.
Nel riquadro Trigger Eventarc, assicurati che i primi campi siano compilati come segue oppure, se necessario:
- Tipo di attivatore: origini Google
- Provider di eventi:Cloud Pub/Sub
- Evento:
google.cloud.pubsub.topic.v1.messagePublished
Nel campo Seleziona un argomento Cloud Pub/Sub, seleziona un argomento esistente o fai clic su Crea un argomento per crearne uno nuovo. La funzione sottoscrive questo argomento. Prendi nota del nome dell'argomento: ti servirà in seguito.
- Se richiesto, fai clic su Concedi per consentire al servizio Pub/Sub di creare i token di identità necessari per richiamare la funzione.
Nel campo Account di servizio, fai clic su Crea nuovo account di servizio.
Inserisci un nome per l'account di servizio e fai clic su Crea. Eventarc utilizza questo account di servizio per richiamare la funzione con un token di identità dal servizio Pub/Sub.
Nella sezione Concedi a questo account di servizio l'accesso al progetto, seleziona il ruolo Invoker di Cloud Run. Ciò concede all'account di servizio la possibilità di richiamare la funzione di seconda generazione.
Fai clic su Fine.
Lascia deselezionata l'opzione Riprova in caso di errore. Fai clic su Salva trigger.
Espandi la sezione Impostazioni di runtime, build, connessioni e sicurezza e seleziona la scheda Runtime.
In Account di servizio di runtime, nel campo Account di servizio, fai clic su Crea. Il flusso di creazione dell'account di servizio si apre in una nuova scheda. Questo account di servizio è l'identità della Cloud Function quando viene eseguita.
- Inserisci un nome per l'account di servizio.
- Fai clic su Crea e continua.
- Fai clic su Fine.
Verrà visualizzata la pagina Account di servizio della console Google Cloud. Puoi chiudere questa scheda.
Torna al campo Account di servizio nella pagina di creazione della funzione, fai clic su Aggiorna e seleziona l'account di servizio appena creato.
Tocca Avanti. Se ti viene richiesto di abilitare le API richieste, fai clic su Abilita.
Non modificare la lingua predefinita e codice campione. Il codice non utilizza servizi cloud e non richiede l'abilitazione di autorizzazioni aggiuntive. Fai clic su Esegui il deployment.
Crea un job Cloud Scheduler
Nella console Google Cloud, vai alla pagina Cloud Scheduler.
Fai clic su Crea job.
Inserisci un nome per il job, seleziona una regione in cui eseguire il job e, facoltativamente, aggiungi una descrizione.
Specifica la frequenza del job utilizzando il formato unix-cron.
30 16 * * 7Per ulteriori informazioni, consulta Configurare le pianificazioni dei cron job.
Seleziona il tuo fuso orario.
Fai clic su Continua.
Nella sezione Configura l'esecuzione, seleziona Pub/Sub come tipo di destinazione.
Seleziona l'argomento Pub/Sub.
Aggiungi una breve stringa Message da inviare al target.
Fai clic su Crea.
Ora hai un cron job che invia un messaggio al tuo argomento Pub/Sub alle 16:30 di domenica. La funzione Cloud Functions è iscritta a quell'argomento.
Esegui il job
Ora puoi eseguire il job che hai creato.
Nella console Google Cloud, vai alla pagina Cloud Scheduler.
Seleziona il job che hai creato.
Fai clic su Forza esecuzione.
A causa della configurazione richiesta, l'esecuzione del primo job creato in un progetto può richiedere alcuni minuti la prima volta che viene richiamato.
Osserva la colonna Stato dell'ultima esecuzione. Al termine dell'esecuzione del job, nella colonna dovrebbe essere visualizzato il messaggio "Operazione riuscita".
Complimenti! Hai appena utilizzato la console per vedere i risultati dell'esecuzione di un cron job che invia un messaggio a Pub/Sub. Ora imparerai come verificare che la Cloud Function sia stata effettivamente eseguita.
Verifica i risultati in Cloud Functions
Per verificare che la Cloud Function sia stata attivata correttamente dal cron job:
Nella console Google Cloud, vai alla pagina Cloud Functions.
Fai clic sul nome della funzione.
Si apre la pagina Dettagli funzione. Il grafico Chiamate/secondo mostra la prima chiamata della funzione. Per visualizzare i dettagli della chiamata, fai clic su Log.
Complimenti! La funzione è stata eseguita.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial:
Elimina il job Cloud Scheduler
Nella console Google Cloud, vai alla pagina Cloud Scheduler.
Seleziona la casella di controllo accanto al job.
Fai clic su Elimina e conferma l'eliminazione.
Elimina l'argomento Pub/Sub
Nella console Google Cloud, vai alla pagina Cloud Pub/Sub.
Seleziona la casella di controllo accanto all'argomento.
Fai clic su Elimina e conferma l'eliminazione.
Elimina la Cloud Function
Nella console Google Cloud, vai alla pagina Cloud Functions.
Seleziona la casella di controllo accanto alla funzione.
Fai clic su Elimina e conferma l'eliminazione.
Elimina gli account di servizio
Nella console Google Cloud, vai alla pagina Account di servizio.
Seleziona la casella di controllo accanto agli account di servizio che hai creato.
Fai clic su Elimina e conferma l'eliminazione.
Disabilita le API
Se hai abilitato delle API nel corso di questo tutorial (ad esempio le API Eventarc, Cloud Functions o Pub/Sub), disabilitale. La disabilitazione delle API influisce sull'accesso all'API per il progetto, quindi non disabilitare le API se altre risorse del progetto le utilizzano.
Nella console Google Cloud, vai alla pagina API e servizi.
Fai clic sull'API che vuoi disabilitare. Viene visualizzata una pagina che descrive l'API.
Fai clic su Disabilita API.
Elimina il progetto
Se hai creato un progetto solo per questo tutorial, puoi eliminarlo.
- Nella console Google Cloud, vai alla pagina Gestisci risorse.
- Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
- Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.