Pianifica una funzione Cloud Functions HTTP

---

Questo tutorial mostra come attivare una funzione Cloud Functions HTTP utilizzando Cloud Scheduler e scegliendo come target un endpoint HTTP. Utilizza una funzione HTTP se hai bisogno che la tua funzione disponga di un endpoint URL e risponda alle richieste HTTP, ad esempio per i webhook.

Tieni presente che puoi anche pianificare una funzione basata su eventi quando la tua funzione deve essere attivata direttamente in risposta a eventi all'interno del tuo progetto Google Cloud, ad esempio messaggi su un argomento Pub/Sub o modifiche in un bucket Cloud Storage. Per ulteriori informazioni, consulta Tipi di Cloud Functions.

La pianificazione dell'esecuzione di una Cloud Functiond è un caso d'uso comune per Cloud Scheduler. In questo tutorial, imparerai a:

1. Creare una semplice funzione Cloud Functions HTTP.
2. Creare un job Cloud Scheduler.
3. Esegui il job Cloud Scheduler.
4. Verifica che la Cloud Function sia stata attivata dal job Cloud Scheduler.

Costi

In questo documento, utilizzi i seguenti componenti fatturabili di Google Cloud:

• Cloud Functions
• Cloud Scheduler

Per generare una stima dei costi in base all'utilizzo previsto, utilizza il Calcolatore prezzi. I nuovi utenti di Google Cloud potrebbero essere idonei per una prova gratuita.

Prima di iniziare

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Abilita le API Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler.

   Abilita le API

5. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the Cloud Run > Cloud Run Invoker role to the service account.

      To grant the role, find the Select a role list, then select Cloud Run > Cloud Run Invoker.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
   6. Click Continue.

   7. Click Done to finish creating the service account.

6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

7. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

8. Abilita le API Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler.

   Abilita le API

9. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the Cloud Run > Cloud Run Invoker role to the service account.

      To grant the role, find the Select a role list, then select Cloud Run > Cloud Run Invoker.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
   6. Click Continue.

   7. Click Done to finish creating the service account.

Tieni presente che devi concedere il ruolo Invoker di Cloud Run perché in Cloud Functions (2a gen.), le autorizzazioni di chiamata sono disponibili gestendo il servizio Cloud Run sottostante.

10. Per impostazione predefinita, Cloud Functions utilizza l'account di servizio Compute Engine predefinito creato automaticamente per il proprio account di servizio di runtime. Puoi usare questo account di servizio per provare il tutorial. Tuttavia, a seconda della configurazione dei criteri dell'organizzazione, all'account di servizio predefinito potrebbe non essere concesso automaticamente il ruolo Editor sul progetto. In questo caso, devi concedere all'account di servizio i seguenti ruoli:
    1. Writer Artifact Registry (roles/artifactregistry.writer)
    2. Writer log (roles/logging.logWriter)
    3. Visualizzatore oggetti Storage (roles/storage.objectViewer)

Crea una funzione Cloud Functions HTTP

Creare una funzione HTTP che viene attivata da Cloud Scheduler.

1. Nella console Google Cloud, vai alla pagina Cloud Functions.

   Vai a Cloud Functions

2. Fai clic su Crea funzione.

3. Nella sezione Nozioni di base, procedi nel seguente modo:

   1. Nell'elenco Ambiente, seleziona 2a generazione.
   2. Inserisci un nome per la funzione.
   3. Nell'elenco Regione, seleziona una regione.

4. Nella sezione Trigger, segui questi passaggi:

   1. Nell'elenco Tipo di trigger, seleziona HTTPS.

   2. Per l'autenticazione, seleziona Richiedi autenticazione.

      Per maggiori informazioni, consulta Autenticare per le chiamate (2ª generazione).

5. Accetta le altre impostazioni predefinite e fai clic su Avanti.

6. Non modificare il linguaggio di runtime predefinito e codice campione. Il codice non utilizza servizi cloud e non richiede l'abilitazione di autorizzazioni aggiuntive. Fai clic su Esegui il deployment.

7. Una volta eseguito il deployment della funzione, fai clic sulla scheda Trigger.

8. Copia l'URL HTTP per la funzione.

Crea un job Cloud Scheduler

Creare un job Cloud Scheduler che attivi un'azione utilizzando HTTP.

1. Nella console Google Cloud, vai alla pagina Cloud Scheduler.

   Vai a Cloud Scheduler

2. Fai clic su Crea job.

3. Inserisci un nome per il job.

4. Nell'elenco Regione, seleziona una regione.

5. Specifica la frequenza per il job utilizzando un formato unix-cron:

   30 16 * * 7
   

   Per ulteriori informazioni, consulta Formato del job Cron e fuso orario.

6. Seleziona un fuso orario nell'elenco Fuso orario.

7. Fai clic su Continua.

8. Nell'elenco Tipo di destinazione, seleziona HTTP.

9. Nel campo URL, inserisci l'URL HTTP della funzione che hai copiato in precedenza.

10. Nell'elenco Intestazione autorizzazione, seleziona Aggiungi token OIDC.

11. Nell'elenco Account di servizio, seleziona l'account di servizio creato in precedenza.

12. Nel campo Pubblico, inserisci l'URL HTTP della funzione che hai copiato in precedenza.

13. Fai clic su Crea.

Hai creato un cron job che esegue la Cloud Function alle 16:30 di domenica.

Esegui il job Cloud Scheduler

Ora puoi eseguire il job che hai creato.

1. Nella console Google Cloud, vai alla pagina Cloud Scheduler.

   Vai a Cloud Scheduler

2. Seleziona la casella di controllo per il job che hai creato e fai clic su Forza esecuzione.

   Quando viene richiamato inizialmente, la configurazione e l'esecuzione del primo job creato in un progetto può richiedere alcuni minuti.

3. Dopo l'esecuzione del job, lo Stato dell'ultima esecuzione dovrebbe indicare Success.

Verifica i risultati in Cloud Functions

Puoi verificare che la Cloud Function venga attivata ed eseguita correttamente dal cron job.

1. Nella console Google Cloud, vai alla pagina Cloud Functions.

   Vai a Cloud Functions

2. Fai clic sul nome della funzione.

   Si apre la pagina Dettagli funzione e il grafico Chiamate/secondo mostra la prima chiamata della funzione.

3. Fai clic sulla scheda Log.

   Dovresti vedere una voce di log simile a POST 200 146 B 5 ms Google-Cloud-Scheduler https://REGION-PROJECT_ID.cloudfunctions.net/FUNCTION_NAME

Esegui la pulizia

Per evitare che al tuo Account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.

Elimina progetto

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per le attività in questo documento, quando lo elimini elimini anche qualsiasi altro lavoro svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

1. Nella console Google Cloud, vai alla pagina Gestisci risorse.

   Vai a Gestisci risorse

2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
3. Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.

Elimina le risorse del tutorial

1. Nella console Google Cloud, vai alla pagina Cloud Scheduler.

   Vai a Cloud Scheduler

2. Seleziona la casella di controllo accanto al job.

3. Fai clic su Elimina e conferma l'eliminazione.

4. Nella console Google Cloud, vai alla pagina Cloud Functions.

   Vai a Cloud Functions

5. Seleziona la casella di controllo accanto alla funzione.

6. Fai clic su Elimina e conferma l'eliminazione.

7. Nella console Google Cloud, vai alla pagina Account di servizio.

   Vai a Service account

8. Seleziona la casella di controllo accanto all'account di servizio che hai creato.

9. Fai clic su Elimina e conferma l'eliminazione.

Passaggi successivi

• Utilizza Cloud Scheduler per attivare Cloud Run in base a una pianificazione