Esegui job in base a una pianificazione

Questa pagina descrive come eseguire job Cloud Run in base a una pianificazione utilizzando Cloud Scheduler.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per le operazioni descritte in questa pagina, chiedi all'amministratore di concederti i ruoli IAM sul tuo job Cloud Run:

Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il job Cloud Run si interfaccia con le API Google Cloud, ad esempio le librerie client di Cloud, consulta la guida alla configurazione delle identità dei servizi. Per ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestione dell'accesso.

Prima di iniziare

Crea un job Cloud Run.

Configura un job Cloud Run per l'esecuzione in base a una pianificazione

Per eseguire un job Cloud Run in base a una pianificazione:

Console

  1. Vai ai job Cloud Run

  2. Fai clic sul job che vuoi eseguire in base a una pianificazione.

  3. Fai clic sulla scheda Trigger.

  4. Fai clic su Aggiungi trigger dello scheduler.

  5. Se non hai ancora abilitato l'API Cloud Scheduler per il tuo progetto, ti verrà chiesto di farlo nel riquadro all'estrema destra: fai clic su Abilita API.

  6. Compila il modulo del job di Cloud Scheduler

    immagine

  7. In Definisci una pianificazione:

    1. Assegna un nome al job Cloud Scheduler.

    2. Seleziona una regione per il job Cloud Scheduler. Non deve necessariamente corrispondere alla regione utilizzata per il job Cloud Run.

    3. Specifica la frequenza per l'esecuzione del job utilizzando il formato unix-cron, ad esempio 0 12 * * *

    4. Seleziona il tuo fuso orario.

  8. Fai clic su Continua.

  9. Nel menu a discesa Account di servizio, seleziona un account di servizio che abbia l'autorizzazione per richiamare l'attuale servizio Cloud Run.

  10. Fai clic su Crea per creare il job Cloud Scheduler che eseguirà il job Cloud Run alla frequenza specificata.

Riga di comando

  1. Assicurati di creare prima un job Cloud Run.

  2. Esegui il comando:

    gcloud scheduler jobs create http SCHEDULER_JOB_NAME \
  --location SCHEDULER_REGION \
  --schedule="SCHEDULE" \
  --uri="https://CLOUD_RUN_REGION-run.googleapis.com/apis/run.googleapis.com/v1/namespaces/PROJECT-ID/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 scheduler.
    • SCHEDULER_REGION con una regione supportata da Cloud Scheduler, ad esempio europe-west2.
    • CLOUD_RUN_REGION con la regione per il tuo job Cloud Run. Per l'anteprima, utilizza europe-west9.
    • SCHEDULE con la frequenza desiderata, ad esempio 0 12 * * *
    • PROJECT-ID con il tuo ID progetto.
    • PROJECT-NUMBER con il numero di progetto.
    • JOB-NAME con il tuo job Cloud Run.

Terraform

Per creare un job Cloud Scheduler che esegue un job Cloud Run:

resource "google_cloud_scheduler_job" "job" {
  provider         = google-beta
  name             = "schedule-job"
  description      = "test http job"
  schedule         = "*/8 * * * *"
  attempt_deadline = "320s"
  region           = "us-central1"
  project          = data.google_project.project.project_id

  retry_config {
    retry_count = 3
  }

  http_target {
    http_method = "POST"
    uri         = "https://${google_cloud_run_v2_job.default.location}-run.googleapis.com/apis/run.googleapis.com/v1/namespaces/${data.google_project.project.number}/jobs/${google_cloud_run_v2_job.default.name}:run"

    oauth_token {
      service_account_email = google_service_account.cloud_run_invoker_sa.email
    }
  }

  depends_on = [resource.google_project_service.cloudscheduler_api, resource.google_cloud_run_v2_job.default, resource.google_cloud_run_v2_job_iam_binding.binding]
}

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Cloud Scheduler eseguirà il job Cloud Run con la frequenza specificata.

Passaggi successivi

Dopo aver utilizzato questa funzionalità, puoi: