Questa pagina descrive come eseguire job Cloud Run in base a una pianificazione utilizzando Cloud Scheduler.
Se il tuo progetto Google Cloud si trova all'interno di un perimetro di Controlli di servizio VPC in una rete Virtual Private Cloud, consulta Eseguire job in base a una pianificazione in un perimetro di Controlli di servizio VPC per istruzioni su come pianificare i job per questo caso d'uso.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per le operazioni descritte in questa pagina, chiedi all'amministratore di concederti i ruoli IAM nel tuo job Cloud Run:
- Amministratore Cloud Scheduler
(
roles/cloudscheduler.admin
) o un ruolo personalizzato con l'autorizzazionecloudscheduler.jobs.create
- Cloud Run Invoker (
roles/run.invoker
) per eseguire i job utilizzando Google Cloud CLI o Cloud Run Developer (roles/run.developer
) per eseguire i job utilizzando la console Google Cloud .
Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM Cloud Run e Autorizzazioni IAM Cloud Run. Se il tuo job Cloud Run interagisce con le APIGoogle Cloud , come le librerie client Cloud, consulta la guida alla configurazione dell'identità del servizio. Per ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestire l'accesso.
Prima di iniziare
Configura un job Cloud Run da eseguire in base a una pianificazione
Per eseguire un job Cloud Run in base a una pianificazione:
Console
Fai clic sul job da eseguire in base a una pianificazione.
Fai clic sulla scheda Attivatori.
Fai clic su Aggiungi trigger dello scheduler.
Se non hai ancora abilitato l'API Cloud Scheduler per il tuo progetto, ti viene chiesto di farlo nel riquadro all'estrema destra: fai clic su Abilita API.
Compila il modulo del job Cloud Scheduler
Nella sezione Definisci una pianificazione:
Assegna un nome al job Cloud Scheduler.
Seleziona una regione per il job Cloud Scheduler. Non deve corrispondere alla regione utilizzata per il job Cloud Run.
Specifica la frequenza di esecuzione del job utilizzando il formato unix-cron, ad esempio
0 12 * * *
Seleziona il tuo fuso orario.
Fai clic su Continua.
Nel menu a discesa Service account, seleziona un account di servizio che disponga dell'autorizzazione per richiamare il servizio Cloud Run corrente.
Fai clic su Crea per creare il job Cloud Scheduler che eseguirà il job Cloud Run alla frequenza specificata.
Riga di comando
Assicurati di creare prima un job Cloud Run.
Esegui il comando:
gcloud scheduler jobs create http SCHEDULER_JOB_NAME \ --location SCHEDULER_REGION \ --schedule="SCHEDULE" \ --uri="https://run.googleapis.com/v2/projects/PROJECT-ID/locations/CLOUD_RUN_REGION/jobs/JOB-NAME:run" \ --http-method POST \ --oauth-service-account-email PROJECT-NUMBER-compute@developer.gserviceaccount.com
Sostituisci
- SCHEDULER_JOB_NAME con il nome che vuoi assegnare al job di pianificazione.
- SCHEDULER_REGION con una regione supportata da Cloud Scheduler, ad esempio
europe-west2
. - CLOUD_RUN_REGION con la regione del tuo job Cloud Run. Per l'anteprima, utilizza
europe-west9
. - SCHEDULE con la frequenza desiderata, ad esempio
0 12 * * *
- PROJECT-ID con l'ID progetto.
- PROJECT-NUMBER con il numero del tuo progetto.
- JOB-NAME con il tuo job Cloud Run.
Terraform
Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.
Aggiungi quanto segue a una risorsagoogle_cloud_run_v2_job
nella configurazione Terraform:Cloud Scheduler eseguirà il job Cloud Run alla frequenza specificata.
Passaggi successivi
Dopo aver utilizzato questa funzionalità, puoi:
- Visualizza i log dei job
- Monitorare il rendimento dei job
- Creare un job
- Esegui un job
- Gestire i lavori