Gestire i cron job

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 di 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 posizione in cui verrà eseguito il job.

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

  Per ulteriori informazioni, consulta Configurare le pianificazioni dei job cron.

• URI: l'URI completo dell'endpoint con cui il job entrerà in contatto.

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

• (Facoltativo) Specifica il metodo HTTP. Il valore predefinito è POST.

• Se vuoi, specifica i dati da inviare al target. Questi dati vengono inviati nel corpo della richiesta come byte quando è selezionato il metodo HTTP POST o PUT.

• Se vuoi, imposta i valori di ripetizione, che specificano come deve essere eseguito nuovamente il job App Engine in caso di errore. Nella maggior parte dei casi, i valori predefiniti saranno sufficienti.

• Per creare un job target HTTP che richiede l'autenticazione, consulta Utilizzo dell'autenticazione con i target 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 già configurato nel tuo progetto. Cloud Scheduler pubblicherà i messaggi in questo argomento come account di servizio API Google.

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

Sostituisci quanto segue:

• JOB: un nome di 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 posizione in cui verrà eseguito il job.

• SCHEDULE: la frequenza o l'intervallo di esecuzione del job, ad esempio every 3 hours. La stringa che fornisci qui può essere qualsiasi stringa compatibile unix-cron. Sebbene non ne consigliamo più l'utilizzo, la precedente sintassi cron di App Engine è ancora supportata per i job esistenti.

  Per ulteriori informazioni, consulta Configurare le pianificazioni dei job cron.

• TOPIC: il nome dell'argomento a cui verrà pubblicata la pubblicazione. 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 di questo tipo di operazione, consulta la guida rapida.

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

Esempio

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

HTTP App Engine

Il target 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 tuo progetto corrente, scegli HTTP come target, non App Engine HTTP. Le regole del firewall di destinazione devono consentire le richieste dall'intervallo IP 0.1.0.2/32.

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

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

Sostituisci quanto segue:

• JOB: un nome di 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 posizione in cui verrà eseguito il job. Deve corrispondere alla posizione dell'app App Engine.

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

  Per ulteriori informazioni, consulta Configurare le pianificazioni dei job cron.

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

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

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

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

• Se vuoi, specifica la versione. Se non viene impostato, viene utilizzata la versione attualmente pubblicata. Puoi trovare le versioni disponibili nella console Google Cloud.

• (Facoltativo) Specifica l'istanza. Se non viene impostato, può essere utilizzata qualsiasi istanza disponibile. Puoi trovare le versioni disponibili nella console Google Cloud.

• Se vuoi, specifica i dati da inviare al target. Questi dati vengono inviati nel corpo della richiesta come byte quando è selezionato il metodo HTTP POST o PUT.

• Se vuoi, imposta i valori di ripetizione, che specificano come deve essere eseguito nuovamente il job 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"

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 di 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 posizione in cui viene eseguito il job. Se non specifichi la posizione, l'gcloud CLI utilizzerà la tua posizione predefinita. Se il job che vuoi modificare si trova in un'altra località, devi specificare la località oltre a NAME affinché il job possa essere identificato. Non puoi aggiornare la località del lavoro.

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

  Per ulteriori informazioni, consulta Configurare le pianificazioni dei job cron.

• URI: l'URI completo dell'endpoint con cui il job entrerà in contatto.

Gli altri parametri sono descritti nel riferimento 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 già configurato nel tuo progetto. Cloud Scheduler pubblicherà i messaggi in questo argomento come account di servizio API Google.

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

Sostituisci quanto segue:

• JOB: un nome di 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 posizione in cui viene eseguito il job. Se non specifichi la posizione, l'gcloud CLI utilizzerà la tua posizione predefinita. Se il job che vuoi modificare si trova in un'altra località, devi specificare la località oltre a NAME affinché il job possa essere identificato. Non puoi aggiornare la località del lavoro.

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

  Per ulteriori informazioni, consulta Configurare le pianificazioni dei job cron.

• TOPIC: il nome dell'argomento a cui verrà pubblicata la pubblicazione. 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 di questo tipo di operazione, consulta la guida rapida.

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

Esempio

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

HTTP App Engine

Il target 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 tuo progetto corrente, scegli HTTP come target, non App Engine HTTP.

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

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

Sostituisci quanto segue:

• JOB: un nome di 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 posizione in cui viene eseguito il job (corrisponde alla posizione dell'app App Engine di destinazione). Se non specifichi la posizione, l'gcloud CLI utilizzerà la tua posizione predefinita. Se il job che vuoi modificare si trova in un'altra località, devi specificare la località oltre a NAME affinché il job possa essere identificato. Non puoi aggiornare la località del lavoro.

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

  Per ulteriori informazioni, consulta Configurare le pianificazioni dei job cron.

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

Esempio

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