Questo tutorial mostra come utilizzare Cloud Scheduler e Pub/Sub per attivare una Cloud Function. 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 sottoscriva un argomento Pub/Sub.
- Crea un argomento Pub/Sub per attivare la funzione.
- Creare un job Cloud Scheduler che richiama il trigger Pub/Sub.
- Eseguire il job Cloud Scheduler.
- Verifica l'esito positivo.
Prima di iniziare
Questo tutorial presuppone che tu abbia già utilizzato la guida rapida di Cloud Scheduler. Di conseguenza, avrai a disposizione i seguenti strumenti e risorse:Un progetto Google Cloud con fatturazione abilitata.
L'API Cloud Scheduler e l'API Pub/Sub sono 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 Attivatore, seleziona Richiedi autenticazione. Fai clic su Aggiungi trigger e seleziona Trigger di Pub/Sub. Viene visualizzato il riquadro Trigger Eventarc. Se ti viene richiesto di abilitare 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 nuovo argomento per crearne uno nuovo. La funzione si abbona a questo argomento. Prendi nota del nome dell'argomento: ti servirà più avanti.
- Se richiesto, fai clic su Concedi per consentire al servizio Pub/Sub di creare i token di identità che dovrà utilizzare per attivare la funzione. Ricorda che hai selezionato Richiedi autenticazione per la funzione in precedenza. Pub/Sub utilizza i token di identità per l'autenticazione richiesta.
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. Questo 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 attivatore.
Espandi la sezione Impostazioni di runtime, build, connessioni e sicurezza e seleziona la scheda Runtime.
In Account di servizio 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à di cui dispone la Cloud Function al momento dell'esecuzione.
- Inserisci un nome per l'account di servizio.
- Fai clic su Crea e continua.
- Fai clic su Fine.
Il sistema ti reindirizzerà alla 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 eventuali API richieste, fai clic su Abilita.
Non modificare la lingua predefinita e il codice campione. Il codice non utilizza servizi cloud e non richiede autorizzazioni aggiuntive abilitate. 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.
Se necessario, seleziona una regione in cui eseguire il job.
Assegna un nome al job e, facoltativamente, aggiungi una descrizione.
Specifica la frequenza del job utilizzando il formato unix-cron.
30 16 * * 7Vedi Configurare pianificazioni cron job per ulteriori informazioni.
Seleziona il fuso orario.
Fai clic su Continua.
Nella sezione Configura l'esecuzione, seleziona Pub/Sub come tipo di destinazione.
Seleziona il nome dell'argomento.
Aggiungi una breve stringa Messaggio da inviare alla destinazione.
Fai clic su Crea.
Ora hai un cron job che invia un messaggio al tuo argomento Pub/Sub alle 16:30 di domenica. La tua funzione Cloud Functions è iscritta all'argomento in questione.
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, il primo job creato in un progetto può richiedere alcuni minuti per essere eseguito la prima volta che viene richiamato.
Osserva la colonna Stato dell'ultima esecuzione. Una volta eseguito il job, il valore nella colonna dovrebbe essere "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.
Viene visualizzata la pagina Dettagli funzione. Il grafico Chiamate/secondi dovrebbe mostrare 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 funzione Cloud Functions
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 durante questo tutorial (ad esempio le API Eventarc, Cloud Functions o Pub/Sub), disattivale. 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 da 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,
- 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.