Pianificare una funzione Cloud Run HTTP

---

Preview — Cloud Run functions

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Questo tutorial mostra come pianificare una funzione Cloud Run HTTP scegliendo come target un endpoint HTTP in Cloud Scheduler. Utilizza una funzione HTTP quando vuoi che la funzione abbia un endpoint URL e risponda alle richieste HTTP, ad esempio per gli webhook.

In alternativa, se hai creato una funzione CloudEvents, utilizza gli trigger di eventi Eventarc per pianificare la risposta della funzione agli eventi all'interno del progetto. Eventarc può attivare messaggi su un argomento Pub/Sub, modifiche in un bucket Cloud Storage e altro ancora. Per saperne di più, consulta Tipi di funzioni Cloud Run.

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

1. Crea una semplice funzione Cloud Run HTTP.
2. Crea un job Cloud Scheduler.
3. Esegui il job Cloud Scheduler.
4. Verifica che il job Cloud Scheduler attivi la funzione Cloud Run.

Costi

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

• Cloud Run
• Cloud Scheduler

Per generare una stima dei costi in base all'utilizzo previsto, utilizza il Calcolatore prezzi. I nuovi Google Cloud utenti potrebbero avere diritto a una prova gratuita.

Prima di iniziare

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler APIs.

   Enable the APIs

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 following roles to the service account: Cloud Run > Cloud Run Invoker, Cloud Run > Cloud Run Builder.

      To grant a role, find the Select a role list, then select the role.

      To grant additional roles, click Add another role and add each additional role.

      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.
   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. Make sure that billing is enabled for your Google Cloud project.

8. Enable the Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler APIs.

   Enable the APIs

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 following roles to the service account: Cloud Run > Cloud Run Invoker, Cloud Run > Cloud Run Builder.

      To grant a role, find the Select a role list, then select the role.

      To grant additional roles, click Add another role and add each additional role.

      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.
   6. Click Continue.

   7. Click Done to finish creating the service account.

Tieni presente che devi concedere il ruolo Invoker di Cloud Run perché nelle funzioni Cloud Run le autorizzazioni di chiamata sono disponibili tramite la gestione del servizio Cloud Run sottostante.

Crea una funzione Cloud Run HTTP

Crea una funzione HTTP attivata da Cloud Scheduler.

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

   Vai a Cloud Run

2. Fai clic su Scrivi una funzione.

3. Nella sezione Configura:

   1. Nel campo Nome servizio, inserisci un nome per la funzione.
   2. Nell'elenco Regione, seleziona una regione.
   3. Non modificare la lingua di runtime predefinita.

   4. Per l'autenticazione, seleziona Richiedi l'autenticazione.

      Se il tuo progetto è soggetto a un criterio dell'organizzazione che limita i domini limitando le chiamate non autenticate, dovrai accedere al servizio di cui è stato eseguito il deployment come descritto in Testare i servizi privati.

      Per ulteriori informazioni, consulta Eseguire l'autenticazione per l'invocazione.

4. Accetta le altre impostazioni predefinite e fai clic su Crea.

5. Copia l'URL HTTP della funzione.

Crea un job Cloud Scheduler

Crea un job Cloud Scheduler che attiva 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 e fuso orario dei job cron.

6. Nell'elenco Fuso orario, seleziona un fuso orario.

7. Fai clic su Continua.

8. Nell'elenco Tipo target, seleziona HTTP.

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

10. Nell'elenco Intestazione di autenticazione, 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 funzione Cloud Run 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 del job che hai creato e fai clic su Forza esecuzione.

   Quando viene invocato per la prima volta, la configurazione e l'esecuzione del primo job creato in un progetto possono richiedere alcuni minuti.

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

Verifica i risultati nelle funzioni Cloud Run

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

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

   Vai a Cloud Run

2. Seleziona Filtra servizi > Tipo di implementazione > Funzione. L'elenco dei servizi viene filtrato in modo da mostrare solo le funzioni.

3. Fai clic sul nome della funzione.

   Viene visualizzata la pagina Dettagli del servizio, che mostra le metriche del servizio.

4. Fai clic sulla scheda Log.

   Dovresti visualizzare una voce di log simile a POST 200 146 B 5 ms Google-Cloud-Scheduler https://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à descritte in questo documento, quando lo elimini elimini anche tutto il 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, il riuso dei progetti può aiutarti a non superare i limiti di quota.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Eliminare le risorse dei tutorial

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

   Vai a Cloud Scheduler

2. Seleziona la casella di controllo accanto al tuo job.

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

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

   Vai a Cloud Run

5. Seleziona la casella di controllo accanto al servizio.

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

• Utilizzare Cloud Scheduler per attivare Cloud Run in base a una pianificazione
• Scrivi funzioni CloudEvents per pianificare la risposta della funzione agli eventi all'interno del progetto.