Target Pub/Sub
Se scegli il tipo di destinazione Pub/Sub:Specifica il nome dell'argomento in cui verrà pubblicato il job. Questo è un argomento Pub/Sub che hai già configurato nel tuo progetto.
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.Aggiungi gli attributi del messaggio necessari.
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.
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:
Nell'elenco Tipo di target, seleziona HTTP App Engine.
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, specifica la versione. Se il criterio non viene configurato, viene usata la versione attualmente 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.
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
dovePROJECT-ID
è l'ID progetto attuale.Imposta il metodo HTTP da utilizzare durante l'esecuzione del job. Il valore predefinito è
POST
.Aggiungi le intestazioni di cui hai bisogno alla richiesta.
(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
oPUT
.
Gli endpoint App Engine target devono trovarsi nello stesso progetto e possono essere protetti con login: admin
nell'elemento handlers
del file app.yaml
.
Target HTTP
Se scegli il tipo di target HTTP:Specifica l'URL completo dell'endpoint che verrà contattato dal job.
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
oPUT
.Aggiungi le intestazioni di cui hai bisogno.
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.
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.
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
Nella console Google Cloud, vai a Cloud Scheduler.
Fai clic su Crea job.
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.
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.
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.
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.Nell'elenco Fuso orario, scegli il fuso orario da utilizzare per la pianificazione del job.
Fai clic su Continua.
Specifica il Tipo di target:
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.
Fai clic su Continua.
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 valorih
,m
es
. SiaMin backoff duration
cheMax backoff duration
supportano l'intero set.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.
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 esempioevery 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
oPUT
.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
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 esempioevery 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 parametrodata
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 esempioevery 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
dovePROJECT-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
oPUT
.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"
Modifica un job
Puoi modificare la configurazione di un job.
Console
Nella console Google Cloud, vai a Cloud Scheduler.
Seleziona il job da modificare.
Fai clic su Modifica.
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 aNAME
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 esempioevery 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
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 aNAME
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 esempioevery 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 parametrodata
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 aNAME
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 esempioevery 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"
Metti in pausa un job
Puoi mettere in pausa l'esecuzione di un job.
Console
Nella console Google Cloud, vai a Cloud Scheduler.
Seleziona il job da mettere in pausa.
Fai clic su Metti in pausa.
gcloud
Apri una finestra del terminale sulla macchina in cui hai installato gcloud CLI.
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
Nella console Google Cloud, vai a Cloud Scheduler.
Seleziona il job da riprendere.
Il job deve essere già in pausa.
Fai clic su Riprendi.
gcloud
Apri una finestra del terminale sulla macchina in cui hai installato gcloud CLI.
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
Nella console Google Cloud, vai a Cloud Scheduler.
Seleziona il job da eliminare.
Fai clic su Elimina.
gcloud
Apri una finestra del terminale sulla macchina in cui hai installato gcloud CLI.
Esegui il comando:
gcloud scheduler jobs delete MY_JOB
Sostituisci
MY_JOB
con il nome del job da eliminare.