Crea e configura cron job

Target Pub/Sub

Se scegli il tipo di destinazione Pub/Sub:

1. Specifica il nome dell'argomento in cui verrà pubblicato il job. Questo è un argomento Pub/Sub che hai già configurato nel tuo progetto.

2. Specifica un messaggio da inviare all'argomento. Viene inviato come parametro data all'interno del messaggio Pub/Sub. Per un esempio, consulta la Guida rapida.

3. Aggiungi gli attributi del messaggio necessari.

4. Imposta eventuali configurazioni aggiuntive utilizzando la sezione Configure optional settings.

Cloud Scheduler pubblicherà i messaggi in questo argomento come account di servizio delle API di Google.

OK

Target HTTP App Engine

Se scegli il tipo di destinazione HTTP App Engine, devi utilizzare l'app App Engine e la regione associata al progetto corrente. Se vuoi utilizzare un'altra app App Engine al di fuori del progetto attuale, scegli HTTP come destinazione, non HTTP App Engine. Le regole firewall di destinazione devono consentire le richieste dall'intervallo IP 0.1.0.2/32.

Imposta il modulo come segue:

1. Nell'elenco Tipo di target, seleziona HTTP App Engine.

2. Specifica il nome del servizio App Engine che esegue il gestore per il job Cloud Scheduler. Se omesso, viene usato il servizio default. Se vuoi impostarlo, puoi trovare i nomi dei servizi nella console Google Cloud.

3. Facoltativamente, specifica la versione. Se il criterio non viene configurato, viene usata la versione attualmente pubblicata. Le versioni disponibili sono disponibili nella console Google Cloud.

4. Facoltativamente, specifica l'istanza. Se il criterio non viene configurato, è possibile utilizzare qualsiasi istanza disponibile. Le versioni disponibili sono disponibili nella console Google Cloud.

5. Specifica l'URL relativo dell'endpoint App Engine che verrà contattato dal job. Se utilizzi il valore predefinito /, il job utilizzerà PROJECT-ID.appspot.com dove PROJECT-ID è l'ID progetto attuale.

   Nota: se non utilizzi il servizio predefinito, l'URL di destinazione visualizzato nell'interfaccia utente della console Google Cloud è nel formato SERVICE.PROJECT-ID.r.appspot.com/*. Lo stesso URL visualizzato nella finestra del terminale utilizzando l'interfaccia a riga di comando è nel formato https://SERVICE-dot-PROJECT-ID.r.appspot.com/. Le due forme sono equivalenti.

6. Imposta il metodo HTTP da utilizzare durante l'esecuzione del job. Il valore predefinito è POST.

7. Aggiungi le intestazioni di cui hai bisogno alla richiesta.

8. (Facoltativo) Specifica i dati del corpo da inviare alla destinazione. Questi dati vengono inviati nel corpo della richiesta come byte quando è selezionato il metodo HTTP POST o PUT.

Gli endpoint App Engine target devono trovarsi nello stesso progetto e possono essere protetti con login: admin nell'elemento handlers del file app.yaml.

OK

Target HTTP

Se scegli il tipo di target HTTP:

1. Specifica l'URL completo dell'endpoint che verrà contattato dal job.

2. Specifica il metodo HTTP. Il valore predefinito è POST.

3. (Facoltativo) Specifica i dati da inviare alla destinazione. Questi dati vengono inviati nel corpo della richiesta come byte quando è selezionato il metodo HTTP POST o PUT.

4. Aggiungi le intestazioni di cui hai bisogno.

5. Per creare un job di destinazione HTTP che richiede l'autenticazione, consulta Utilizzare l'autenticazione con destinazioni HTTP.

Gli endpoint HTTP scelti come target devono essere accessibili pubblicamente.

Nota: quando utilizzi una destinazione HTTP, Cloud Scheduler potrebbe segnalare un errore di richiesta non riuscito anche se la destinazione è stata restituita correttamente. Questo può verificarsi in caso di mancata corrispondenza tra le impostazioni di timeout del servizio di destinazione e quelle di Cloud Scheduler. Consulta la descrizione del Job per impostare il campo attempt_deadline.

OK

Puoi utilizzare Cloud Scheduler per configurare unità di lavoro pianificate, note come cron job, inviate ai target in base a una pianificazione ricorrente, chiamata anche intervallo o frequenza del job.

Deve essere eseguita una sola istanza di un job in qualsiasi momento. In rare circostanze, è possibile che vengano richieste più istanze dello stesso job. Di conseguenza, il gestore delle richieste dovrebbe essere idempotente e il codice deve garantire che non si verifichino effetti collaterali dannosi in caso contrario.

Nota: Cloud Scheduler fornisce headers che possono aiutare con la deduplicazione delle richieste dei job, rendendo il gestore di richieste idempotente. In particolare, la richiesta del job può essere identificata in modo univoco utilizzando il nome del job e l'ora in cui è pianificata.

Cloud Scheduler è destinato ai job ricorrenti. Se devi eseguire un job una sola volta, ti consigliamo di utilizzare Cloud Tasks, che può pianificare un'attività fino a 30 giorni in anticipo.

Prima di iniziare

Assicurati di aver configurato l'ambiente per Cloud Scheduler.

Scegli un tipo di target

Cloud Scheduler può richiamare i seguenti tipi di destinazioni:

• Endpoint HTTP

• Argomenti Pub/Sub

• Servizi App Engine

Richiama i servizi di destinazione limitati al traffico in entrata interno

Cloud Scheduler può richiamare internamente i seguenti servizi:

• Cloud Functions
• Cloud Run (nell'URL run.app, non nei domini personalizzati)

Per richiamare internamente queste destinazioni, la destinazione deve trovarsi nello stesso progetto Google Cloud o perimetro dei Controlli di servizio VPC del job Cloud Scheduler.

Per saperne di più sulla protezione delle destinazioni limitando il traffico in entrata, consulta Limitazione del traffico in entrata (per Cloud Run) e Configurazione delle impostazioni di rete (per Cloud Functions).

Crea un job

Puoi creare un job utilizzando la console Google Cloud o Google Cloud CLI.

Console

1. Nella console Google Cloud, vai a Cloud Scheduler.
   

   Vai a Cloud Scheduler

2. Fai clic su Crea job.

3. Nel campo Nome, fornisci un nome per il job univoco per il progetto.

   Dopo aver eliminato il job associato, puoi riutilizzare il nome di un job in un progetto.

4. Nell'elenco Regione, seleziona una regione.

   Se utilizzi un target HTTP di App Engine, devi scegliere la stessa regione della tua app App Engine. Per ulteriori informazioni, vedi Regioni supportate per target.

5. Se vuoi, fornisci una breve descrizione del job, ad esempio un promemoria dello svolgimento del job.

   Questa descrizione viene visualizzata nella console accanto al nome del job.

6. Specifica la frequenza di esecuzione del job, utilizzando una stringa di configurazione.

   Ad esempio, la stringa 0 1 * * 0 esegue il job una volta alla settimana all'01:00 ogni domenica mattina. La stringa che fornisci qui può essere qualsiasi stringa compatibile con unix-cron. Per maggiori informazioni, consulta Configurare pianificazioni cron job.

7. Nell'elenco Fuso orario, scegli il fuso orario da utilizzare per la pianificazione del job.

8. Fai clic su Continua.

9. Specifica il Tipo di target:

   • HTTP

   • Pub/Sub: devi specificare il nome dell'argomento Pub/Sub che hai già configurato nel progetto e in cui verrà pubblicato il job.

   • HTTP App Engine: devi utilizzare l'app App Engine e la regione associata al progetto corrente.

10. Fai clic su Continua.

11. Facoltativamente, per configurare qualsiasi comportamento relativo ai nuovi tentativi, fai clic su Configura impostazioni facoltative. Per specificare la durata, utilizza una sequenza di numeri interi non negativi con i seguenti suffissi:

    • h - ora
    • m - minuto
    • s - secondo
    • ms - millisecondo
    • us - microsecondo
    • ns - nanosecondo

    Non sono consentiti valori negativi e frazionari. Il campo Max retry duration supporta solo i valori h, m e s. Sia Min backoff duration che Max backoff duration supportano l'intero set.

12. Facoltativamente, per i target HTTP e HTTP App Engine, configura una scadenza per i tentativi del job. Se il gestore delle richieste non risponde entro questa scadenza, la richiesta viene annullata e il tentativo viene contrassegnato come non riuscito. Cloud Scheduler esegue un nuovo tentativo del job in base alla configurazione dei nuovi tentativi.

13. Per creare e salvare il job, fai clic su Crea.

    Il job verrà ora eseguito con la frequenza specificata.

gcloud

Quando crei un job utilizzando gcloud CLI, utilizzi comandi diversi per ogni tipo di target:

HTTP

Puoi inviare una richiesta a qualsiasi endpoint HTTP o HTTPS. Gli endpoint HTTP scelti come target devono essere accessibili pubblicamente.

gcloud scheduler jobs create http JOB \
    --location=LOCATION \
    --schedule=SCHEDULE \
    --uri=URI

Sostituisci quanto segue:

• JOB: un nome job che deve essere univoco nel progetto. Tieni presente che non puoi riutilizzare il nome di un job in un progetto anche se elimini il job associato.

• LOCATION: la località in cui viene eseguito il job.

• SCHEDULE: frequenza o intervallo del job in cui viene eseguito il job, ad esempio every 3 hours. La stringa fornita qui può essere qualsiasi stringa compatibile con unix-cron. Anche se non ne consigliamo più l'uso, la sintassi cron di App Engine precedente è ancora supportata per i job esistenti.

  Per maggiori informazioni, consulta Configurare pianificazioni cron job.

• URI: l'URI completo dell'endpoint che verrà contattato dal job.

Gli altri parametri sono descritti nel riferimento della riga di comando gcloud:

• Facoltativamente, specifica il metodo HTTP. Il valore predefinito è POST.

• (Facoltativo) Specifica i dati da inviare alla destinazione. Questi dati vengono inviati nel corpo della richiesta come byte quando è selezionato il metodo HTTP POST o PUT.

• Facoltativamente, imposta i valori per i tentativi, che specificano come ripetere il job di App Engine in caso di errore. Nella maggior parte dei casi, saranno sufficienti i valori predefiniti.

• Per creare un job di destinazione HTTP che richiede l'autenticazione, consulta la pagina relativa all'utilizzo dell'autenticazione con destinazioni HTTP.

Esempio

gcloud scheduler jobs create http my-http-job \
    --schedule "0 1 * * 0" \
    --uri "http://myproject/my-url.com" \
    --http-method GET

Nota: quando utilizzi una destinazione HTTP, Cloud Scheduler potrebbe segnalare un errore di richiesta non riuscito anche se la destinazione è stata restituita correttamente. Questo può accadere in caso di mancata corrispondenza tra le impostazioni di timeout del servizio di destinazione e quelle di Cloud Scheduler. Consulta la descrizione del Job per impostare il campo attempt_deadline.

Pub/Sub

Devi utilizzare un argomento Pub/Sub che hai già configurato nel progetto. Cloud Scheduler pubblicherà i messaggi in questo argomento come account di servizio API di Google.

gcloud scheduler jobs create pubsub JOB \
    --location=LOCATION \
    --schedule=SCHEDULE \
    --topic=TOPIC

Sostituisci quanto segue:

• JOB: un nome job che deve essere univoco nel progetto. Tieni presente che non puoi riutilizzare il nome di un job in un progetto anche se elimini il job associato.

• LOCATION: la località in cui viene eseguito il job.

• SCHEDULE: frequenza o intervallo del job in cui viene eseguito il job, ad esempio every 3 hours. La stringa fornita qui può essere qualsiasi stringa compatibile con unix-cron. Anche se non ne consigliamo più l'uso, la sintassi cron di App Engine precedente è ancora supportata per i job esistenti.

  Per maggiori informazioni, consulta Configurare pianificazioni cron job.

• TOPIC: il nome dell'argomento in cui il job verrà pubblicato. Utilizza il flag --message-body o --message-body-from-file per specificare un messaggio da inviare all'argomento. Viene inviato come parametro data all'interno del messaggio Pub/Sub. Per un esempio in merito, consulta la quickstart.

Gli altri parametri sono descritti nel riferimento della riga di comando gcloud.

Esempio

gcloud scheduler jobs create pubsub myjob \
    --schedule "0 1 * * 0" \
    --topic cron-topic \
    --message-body "Hello"

HTTP App Engine

La destinazione App Engine HTTP è disponibile solo per l'app App Engine associata al progetto corrente. Se vuoi utilizzare un'altra app App Engine al di fuori del progetto attuale, scegli HTTP come destinazione, non App Engine HTTP. Le regole firewall di destinazione devono consentire le richieste dall'intervallo IP 0.1.0.2/32.

Gli endpoint App Engine possono essere protetti con login: admin nell'elemento handlers nel file app.yaml.

gcloud scheduler jobs create app-engine \
    --JOB=JOB \
    --location=LOCATION \
    --schedule=SCHEDULE

Sostituisci quanto segue:

• JOB: un nome job che deve essere univoco nel progetto. Tieni presente che non puoi riutilizzare il nome di un job in un progetto anche se elimini il job associato.

• LOCATION: la località in cui viene eseguito il job. Deve essere uguale alla località dell'app App Engine.

• SCHEDULE: frequenza o intervallo del job con cui viene eseguito il job, ad esempio every 3 hours. La stringa fornita qui può essere qualsiasi stringa compatibile con unix-cron. Anche se non ne consigliamo più l'uso, la sintassi cron di App Engine precedente è ancora supportata per i job esistenti.

  Per maggiori informazioni, consulta Configurare pianificazioni cron job.

Gli altri parametri sono descritti nel riferimento della riga di comando gcloud:

• Specifica l'URL relativo dell'endpoint App Engine che contatterà il job. Se utilizzi il valore predefinito /, il job utilizzerà PROJECT-ID.appspot.com dove PROJECT-ID è l'ID progetto attuale.

• Specifica il nome del servizio App Engine che esegue il gestore per il job Cloud Scheduler. Se omesso, viene usato il servizio default. Se vuoi impostarlo, puoi trovare i nomi dei servizi nella console Google Cloud.

• Facoltativamente, imposta il metodo HTTP da utilizzare durante l'esecuzione del job. Il valore predefinito è POST.

• Facoltativamente, specifica la versione. Se il criterio non viene configurato, viene usata la versione pubblicata. Le versioni disponibili sono disponibili nella console Google Cloud.

• Facoltativamente, specifica l'istanza. Se il criterio non viene configurato, è possibile utilizzare qualsiasi istanza disponibile. Le versioni disponibili sono disponibili nella console Google Cloud.

• (Facoltativo) Specifica i dati da inviare alla destinazione. Questi dati vengono inviati nel corpo della richiesta come byte quando è selezionato il metodo HTTP POST o PUT.

• Facoltativamente, imposta i valori per i tentativi, che specificano come ripetere il job di App Engine in caso di errore. Nella maggior parte dei casi, i valori predefiniti sono sufficienti.

Esempio

gcloud scheduler jobs create app-engine my-appengine-job \
    --schedule "0 1 * * 0" \
    --relative-url "/cron-handler"

Nota: se non utilizzi il servizio predefinito, l'URL di destinazione restituito alla finestra del terminale è nel formato https://SERVICE-dot-PROJECT-ID.r.appspot.com/. Lo stesso URL visualizzato nell'interfaccia utente della console Google Cloud è nel formato SERVICE.PROJECT-ID.r.appspot.com/*. I due moduli sono equivalenti.

Modifica un job

Puoi modificare la configurazione di un job.

Console

1. Nella console Google Cloud, vai a Cloud Scheduler.
   

   Vai a Cloud Scheduler

2. Seleziona il job da modificare.

3. Fai clic su Modifica.

4. Segui i passaggi per definire la pianificazione, configurare l'esecuzione e configurare le impostazioni facoltative durante la creazione di un job.

gcloud

Quando modifichi un job utilizzando gcloud CLI, utilizzi comandi diversi per ogni tipo di target:

HTTP

Puoi inviare una richiesta a qualsiasi endpoint HTTP o HTTPS. Gli endpoint HTTP scelti come target devono essere accessibili pubblicamente.

gcloud scheduler jobs update http JOB \
    --location=LOCATION \
    --schedule=SCHEDULE \
    --uri=URI

Sostituisci quanto segue:

• JOB: un nome job che deve essere univoco nel progetto. Tieni presente che non puoi riutilizzare il nome di un job in un progetto anche se elimini il job associato.

• LOCATION: la località in cui viene eseguito il job. Se non specifichi la località, gcloud CLI utilizzerà la località predefinita. Se il job che vuoi modificare si trova in una località diversa, devi specificare la località oltre a NAME per consentire l'identificazione del job. Non puoi aggiornare la località del job.

• SCHEDULE: frequenza o intervallo del job in cui viene eseguito il job, ad esempio every 3 hours. La stringa fornita qui può essere qualsiasi stringa compatibile con unix-cron. Anche se non ne consigliamo più l'uso, la sintassi cron di App Engine precedente è ancora supportata per i job esistenti.

  Per maggiori informazioni, consulta Configurare pianificazioni cron job.

• URI: l'URI completo dell'endpoint che verrà contattato dal job.

Gli altri parametri sono descritti nel riferimento della riga di comando gcloud.

Esempio

gcloud scheduler jobs update http my-http-job \
    --schedule "0 1 * * 0" \
    --uri "http://myproject/my-url.com" \
    --http-method GET

Nota: quando utilizzi una destinazione HTTP, Cloud Scheduler potrebbe segnalare un errore di richiesta non riuscito anche se la destinazione è stata restituita correttamente. Questo può accadere in caso di mancata corrispondenza tra le impostazioni di timeout del servizio di destinazione e quelle di Cloud Scheduler. Consulta la descrizione del Job per impostare il campo attempt_deadline.

Pub/Sub

Devi utilizzare un argomento Pub/Sub che hai già configurato nel progetto. Cloud Scheduler pubblicherà i messaggi in questo argomento come account di servizio API di Google.

gcloud scheduler jobs update pubsub JOB \
    --location=LOCATION \
    --schedule=SCHEDULE \
    --topic=TOPIC

Sostituisci quanto segue:

• JOB: un nome job che deve essere univoco nel progetto. Tieni presente che non puoi riutilizzare il nome di un job in un progetto anche se elimini il job associato.

• LOCATION: la località in cui viene eseguito il job. Se non specifichi la località, gcloud CLI utilizzerà la località predefinita. Se il job che vuoi modificare si trova in una località diversa, devi specificare la località oltre a NAME per consentire l'identificazione del job. Non puoi aggiornare la località del job.

• SCHEDULE: frequenza o intervallo del job con cui viene eseguito il job, ad esempio every 3 hours. La stringa fornita qui può essere qualsiasi stringa compatibile con unix-cron. Anche se non ne consigliamo più l'uso, la sintassi cron di App Engine precedente è ancora supportata per i job esistenti.

  Per maggiori informazioni, consulta Configurare pianificazioni cron job.

• TOPIC: il nome dell'argomento in cui il job verrà pubblicato. Utilizza il flag --message-body o --message-body-from-file per specificare un messaggio da inviare all'argomento. Viene inviato come parametro data all'interno del messaggio Pub/Sub. Per un esempio in merito, consulta la quickstart.

Gli altri parametri sono descritti nel riferimento della riga di comando gcloud.

Esempio

gcloud scheduler jobs update pubsub myjob \
    --schedule "0 1 * * 0" \
    --topic cron-topic --message-body "Hello"

HTTP App Engine

La destinazione App Engine HTTP è disponibile solo per l'app App Engine associata al progetto corrente. Se vuoi utilizzare un'altra app App Engine al di fuori del progetto attuale, scegli HTTP come destinazione, non App Engine HTTP.

Gli endpoint App Engine possono essere protetti con login: admin nell'elemento handlers nel file app.yaml.

gcloud scheduler jobs update app-engine JOB \
    --location=LOCATION \
    --schedule=SCHEDULE

Sostituisci quanto segue:

• JOB: un nome job che deve essere univoco nel progetto. Tieni presente che non puoi riutilizzare il nome di un job in un progetto anche se elimini il job associato.

• LOCATION: la località in cui viene eseguito il job (uguale a quella dell'app App Engine di destinazione). Se non specifichi la località, gcloud CLI utilizzerà la località predefinita. Se il job che vuoi modificare si trova in una località diversa, devi specificare la località oltre a NAME per consentire l'identificazione del job. Non puoi aggiornare la località del job.

• SCHEDULE: frequenza o intervallo del job con cui viene eseguito il job, ad esempio every 3 hours. La stringa fornita qui può essere qualsiasi stringa compatibile con unix-cron. Anche se non ne consigliamo più l'uso, la sintassi cron di App Engine precedente è ancora supportata per i job esistenti.

  Per maggiori informazioni, consulta Configurare pianificazioni cron job.

Gli altri parametri sono descritti nel riferimento della riga di comando gcloud.

Esempio

gcloud scheduler jobs update app-engine my-appengine-job \
    --schedule "0 1 * * 0" \
    --relative-url "/cron-handler"

Nota: se non utilizzi il servizio predefinito, l'URL di destinazione restituito alla finestra del terminale è nel formato https://SERVICE-dot-PROJECT-ID.r.appspot.com/. Lo stesso URL visualizzato nell'interfaccia utente della console Google Cloud è nel formato SERVICE.PROJECT-ID.r.appspot.com/*. I due moduli sono equivalenti.

Metti in pausa un job

Puoi mettere in pausa l'esecuzione di un job.

Console

1. Nella console Google Cloud, vai a Cloud Scheduler.
   

   Vai a Cloud Scheduler

2. Seleziona il job da mettere in pausa.

3. Fai clic su Metti in pausa.

gcloud

1. Apri una finestra del terminale sulla macchina in cui hai installato gcloud CLI.

2. Esegui il comando:

   gcloud scheduler jobs pause MY_JOB
   

   Sostituisci MY_JOB con il nome del job da mettere in pausa.

Mentre un job è in pausa, puoi anche modificarlo. Dopo aver modificato il job, rimane in pausa finché non lo riprendi.

Riprendi un job

Puoi riprendere l'esecuzione di un job in pausa.

Console

1. Nella console Google Cloud, vai a Cloud Scheduler.
   

   Vai a Cloud Scheduler

2. Seleziona il job da riprendere.

   Il job deve essere già in pausa.

3. Fai clic su Riprendi.

gcloud

1. Apri una finestra del terminale sulla macchina in cui hai installato gcloud CLI.

2. Esegui il comando:

   gcloud scheduler jobs resume MY_JOB
   

   Sostituisci MY_JOB con il nome del job da riprendere.

Eliminazione di un job

Puoi eliminare un job.

Console

1. Nella console Google Cloud, vai a Cloud Scheduler.
   

   Vai a Cloud Scheduler

2. Seleziona il job da eliminare.

3. Fai clic su Elimina.

gcloud

1. Apri una finestra del terminale sulla macchina in cui hai installato gcloud CLI.

2. Esegui il comando:

   gcloud scheduler jobs delete MY_JOB
   

   Sostituisci MY_JOB con il nome del job da eliminare.