Il servizio cron di App Engine consente di configurare attività programmate ricorrenti eseguite in orari specifici o a intervalli regolari. Queste attività vengono comunemente noto come cron job. Questi cron job vengono attivati automaticamente dal servizio cron di App Engine. Ad esempio, puoi utilizzarlo per inviare un'email con un report ogni giorno, per aggiornare alcuni dati memorizzati nella cache ogni 10 minuti o per aggiornare alcune informazioni di riepilogo una volta all'ora.
Un cron job invia una richiesta HTTP GET
programmata all'endpoint specificato nella stessa app in cui è configurato il cron job. Il gestore per quell'endpoint
esegue la logica quando viene richiamata.
Impossibile utilizzare il servizio Cron di App Engine per chiamare endpoint web al di fuori dell'app host di App Engine. Non può essere utilizzato per chiamare App Engine endpoint di altre app oltre all'app host.
Le richieste di CronJob sono soggette agli stessi limiti delle altre richieste HTTP. Le applicazioni gratuite possono avere fino a 20 attività pianificate. Le applicazioni a pagamento possono avere fino a 250 attività pianificate.
Per eseguire il deployment o aggiornare le pianificazioni, il tuo account richiede uno dei seguenti requisiti Ruoli di Identity and Access Management:
- Proprietario
- Editor
- Amministratore Cloud Scheduler (
roles/cloudscheduler.admin
)
Puoi impostare l'autorizzazione nella pagina IAM della console Google Cloud.
Informazioni sul file di configurazione cron
Per tutti i runtime, ad eccezione di Java, un file cron.yaml
nella directory radice dell'applicazione (insieme a app.yaml
) configura le attività pianificate per l'app.
Per Java, un file cron.yaml
nel file WEB-INF
directory della tua applicazione (insieme a app.yaml
) configura le attività pianificate
per la tua app.
Di seguito è riportato un esempio di file cron.yaml
:
cron:
- description: "daily summary job"
url: /tasks/summary
schedule: every 24 hours
- description: "monday morning mailout"
url: /mail/weekly
schedule: every monday 09:00
timezone: Australia/NSW
- description: "new daily summary job"
url: /tasks/summary
schedule: every 24 hours
target: beta
Il file cron.yaml
utilizza l'elemento
Sintassi YAML
ed è composto da definizioni per ciascuno dei tuoi cron job. Un job
la definizione deve avere url
e schedule
. Puoi
anche specificare description
, timezone
,
target
e retry_parameters
:
url
- Obbligatorio. L'URL nell'app a cui vuoi che il servizio Cron invii le richieste di lavoro.
schedule
- Obbligatorio. Definisce la pianificazione dell'esecuzione del job. Consulta la sintassi riportata di seguito.
description
- Facoltativa. Descrive il cron job, visibile dalla console Google Cloud.
timezone
-
(Facoltativo) Il nome del fuso orario o "zoneinfo" da utilizzare per la pianificazione dei job. In caso contrario
specifica un fuso orario, la pianificazione utilizza
UTC
, che è noto anche comeGMT
. -
target
-
(Facoltativo) Il nome di un servizio specifico nella tua app. Quando viene specificato
target
, il servizio Cron indirizza la richiesta di job a quel servizio nella tua app. Le richieste di job vengono inoltrate alle versioni del servizio specificato configurate per il traffico. Scopri come vengono instradate le richieste.Considerazioni importanti per
target
:-
Se disponi di
suddivisione del traffico abilitata, le tue richieste di job non verranno suddivise
tra le versioni che hai configurato:
- Suddivisione degli indirizzi IP: le richieste di job del servizio Cron vengono sempre inviate dallo stesso indirizzo IP e, di conseguenza, vengono indirizzate sempre alla stessa versione.
- Suddivisione dei cookie: le richieste di job non includono un cookie con il valore e, di conseguenza, non vengono indirizzati ad altre versioni.
-
Se utilizzi un
di invio, i job possono essere reindirizzati quando viene visualizzato lo stesso URL.
configurato in
dispatch.yaml
. Ad esempio, se l'URL/tasks/hello_service2
è definito in entrambi i seguenti filecron.yaml
edispatch.yaml
, le richieste di job vengono inviate aservice2
, anche se è specificatotarget: service1
:cron.yaml
:cron: - description: "test dispatch vs target" url: /tasks/hello_service2 schedule: every 1 mins target: service1
dispatch.yaml
:dispatch: - url: '*/tasks/hello_service2' service: service2
-
Se disponi di
suddivisione del traffico abilitata, le tue richieste di job non verranno suddivise
tra le versioni che hai configurato:
retry_parameters
- Facoltativa. Specifica di eseguire nuovamente i job non riusciti; consulta la sintassi qui sotto.
Definizione del cron job schedule
I cron job vengono pianificati a intervalli ricorrenti e sono specificati utilizzando un semplice formato simile all'inglese. Puoi definire una pianificazione in modo che il job venga eseguito più volte al giorno oppure in giorni e mesi specifici.
- Intervalli subgiornalieri
Utilizza un intervallo giornaliero secondario per eseguire un job più volte al giorno programmazione. Puoi definire un intervallo di fine o un'ora di inizio intervallo:
Intervallo di fine: definisce il tempo che intercorre tra l'"ora di fine" di un job e l'inizio del job successivo, dove l'"ora di fine" è il tempo in cui il job viene completato o times out . Il servizio Cron esegue i job in questo tipo di intervallo nell'arco delle 24 ore, iniziando un intervallo dopo l'ora di creazione/aggiornamento del job e aspettando l'intervallo specificato tra ogni job.
Esempio: per la pianificazione
every 5 minutes
, il job viene eseguito ogni giorno, con un intervallo di 5 minuti. Se un'istanza di un job in esecuzione su questa pianificazione viene completata alle 02:01, il job successivo attende 5 minuti e ricomincia alle 02:06.Intervallo di inizio: definisce un intervallo di tempo regolare per l'avvio di ogni job da parte del servizio Cron. A differenza dell'intervallo di tempo di fine, l'intervallo di tempo di inizio esegue ogni job indipendentemente dal completamento o dal timeout del job precedente. Puoi impostare un intervallo di tempo entro il quale eseguire il job oppure eseguire i job 24 ore al giorno, a partire dall'inizio dell'intervallo di tempo specificato.
Poiché l'ora di inizio di un job è rigorosa, se viene eseguita un'istanza di un job maggiore dell'intervallo di tempo definito, il servizio Cron può saltare lavoro. È possibile saltare una singola ora di inizio nell'intervallo se un job precedente non è stato completato volte di Google.
Esempio: per
every 5 minutes from 10:00 to 14:00
pianificazione, l'esecuzione del primo job inizia alle ore10:00
e poi ogni 5 minuti. Se il primo job viene eseguito per 7 minuti, il job10:05
viene ignorato e, di conseguenza, il servizio Cron non esegue un'altra istanza di questo job fino al giorno10:10
.
- Intervallo personalizzato
Puoi utilizzare un intervallo personalizzato per definire una pianificazione in cui job può essere eseguito una volta al giorno in uno o più giorni selezionati e in uno o più mesi. I job eseguiti in base a una pianificazione personalizzata vengono eseguiti tutto l'anno, solo alla un orario specifico nei giorni e nei mesi selezionati.
Esempio: per la pianificazione
1,2,3 of month 07:00
, il job viene eseguito una volta alle ore07:00
nei primi tre giorni di ogni mese.
Considerazioni importanti per schedule
:
- Devi decidere se utilizzare un intervallo secondario o un intervallo
intervallo di tempo. Non puoi combinare e utilizzare elementi dei vari tipi di intervallo. Di seguito è riportato un esempio di definizione di pianificazione non valida:
schedule: every 6 hours mon,wed,fri
. - In qualsiasi momento deve essere eseguita una sola istanza di un job. Il servizio Cron progettato per offrire "almeno una volta" la distribuzione dei dati; cioè se un job è pianificato, App Engine invia la richiesta di job almeno una volta. In alcune rare circostanze è possibile che vengano richieste più istanze dello stesso job, pertanto il gestore delle richieste deve essere idempotente e il codice deve garantire che non si verifichino effetti collaterali dannosi in questo caso.
Formattazione del schedule
Per specificare quando viene eseguito il job, devi definire l'elemento schedule
utilizzando la seguente sintassi:
schedule: [TYPE] [INTERVAL_VALUE] [INTERVAL_SCOPE]
Scegli un tipo di intervallo per definire l'elemento schedule
:
- [TYPE]: gli intervalli giornalieri devono includere il prefisso
every
.Esempio:
schedule: every 12 hours
- [INTERVAL_VALUE]: un valore intero e l'unità corrispondente di
nel tempo. Valori validi per l'unità di tempo:
minutes
omins
hours
- [INTERVAL_SCOPE]: non applicabile. Per impostare un'ora di inizio specifica entro l'intervallo in cui vuoi eseguire i job, consulta la sintassi Intervallo di inizio oppure Intervallo personalizzato.
- Esempi di intervallo di tempo di fine
- Utilizza i seguenti esempi per capire come definire il job
programmazioni che utilizzano un intervallo di tempo di fine:
- Attende 5 minuti dopo il deployment per l'esecuzione la prima volta. Dopo ogni
termina, il servizio Cron attende 5 minuti prima di eseguire il job successivo:
schedule: every 5 minutes
- Attende 30 minuti dopo il deployment per la prima esecuzione. Dopo il giorno
ogni job termina, il servizio Cron attende 30 minuti prima di eseguire
job successivo:
schedule: every 30 mins
- Attende 5 minuti dopo il deployment per l'esecuzione la prima volta. Dopo ogni
termina, il servizio Cron attende 5 minuti prima di eseguire il job successivo:
- [TYPE]: gli intervalli giornalieri devono includere il prefisso
every
.Esempio:
schedule: every 12 hours
- [INTERVAL_VALUE]: un valore intero e l'unità corrispondente di
nel tempo. Valori validi per l'unità di tempo:
minutes
omins
hours
- [INTERVAL_SCOPE] Specifica una clausola che corrisponde alla
[INTERVAL_VALUE]. Puoi definire un intervallo di tempo personalizzato o utilizzare l'opzione 24 ore
synchronized
.- Includi la clausola
from [HH:MM] to [HH:MM]
per definire un orario di inizio e un intervallo specifici in cui eseguire i job.Devi specificare i valori dell'ora nel formato 24 ore,
HH:MM
, dove:HH
sono numeri interi da00
a23
.MM
sono numeri interi da00
a59
.
- Usa
synchronized
per specificare un intervallo di 24 ore (from 00:00 to 23:59
) in modo uniforme diviso per il valore [INTERVAL_VALUE].Importante: [INTERVAL_VALUE] deve dividere 24 in un numero intero, altrimenti si verifica un errore. Valori validi per [INTERVAL_VALUE] include:
1
,2
,3
,4
,6
8
,12
o24
.
- Includi la clausola
- Esempi di intervalli di ora di inizio
- Utilizza i seguenti esempi per capire come definire il job
programmazioni che utilizzano un intervallo di inizio:
- In esecuzione ogni 5 minuti dalle 10:00 alle 14:00, tutti i giorni:
schedule: every 5 minutes from 10:00 to 14:00
- Viene eseguito una volta ogni ora dalle 08:00 alle 16:00, ogni giorno:
schedule: every 1 hours from 08:00 to 16:00
- Viene eseguito una volta ogni due ore, ogni giorno a partire dalle ore 00:00:
schedule: every 2 hours synchronized
- In esecuzione ogni 5 minuti dalle 10:00 alle 14:00, tutti i giorni:
- [TYPE]: gli intervalli personalizzati possono includere il prefisso
every
per definire un intervallo ripetitivo oppure puoi definire un elenco specifico di giorni in un mese:- Per definire un intervallo ripetitivo, puoi utilizzare il prefisso
every
.Esempi:
schedule: every day 00:00 schedule: every monday 09:00
- Per definire giorni specifici, devi utilizzare i numeri ordinali. I valori validi vanno dal primo giorno di un mese al numero massimo di giorni del mese, ad esempio:
1st
ofirst
2nd
osecond
3rd
othird
- E fino a:
31st
othirtyfirst
Esempio:
schedule: 1st,3rd tuesday schedule: 2nd,third wednesday of month 09:00
- Per definire un intervallo ripetitivo, puoi utilizzare il prefisso
- [INTERVAL_VALUE]: gli intervalli personalizzati includono un elenco dei
i giorni specifici in cui vuoi eseguire il job. L'elenco deve essere definito in un elenco separato da virgole e può includere uno dei seguenti valori:
- Il valore intero del giorno del mese fino a un massimo
di 31 giorni, ad esempio:
1
2
3
- E fino a:
31
- Il nome del giorno in una combinazione di uno dei seguenti valori lunghi o abbreviati:
monday
omon
tuesday
otue
wednesday
owed
thursday
othu
friday
ofri
saturday
osat
sunday
osun
- Utilizza
day
per specificare tutti i giorni della settimana.
Esempi:
schedule: 2nd monday,thu schedule: 1,8,15,22 of month 09:00 schedule: 1st mon,wednesday,thu of sep,oct,nov 17:00
- Il valore intero del giorno del mese fino a un massimo
di 31 giorni, ad esempio:
- [INTERVAL_SCOPE]: specifica una clausola che corrisponde alla
specificato [INTERVAL_VALUE]. Gli intervalli personalizzati possono includere
of [MONTH]
, che specifica un solo mese in una anno o un elenco di più mesi separati da virgole. Devi anche definire un'ora specifica in cui vuoi che venga eseguito il job, ad esempio:of [MONTH] [HH:MM]
.Per impostazione predefinita, se la clausola
of
è esclusa, l'intervallo personalizzato viene eseguito ogni mese.- [MONTH]: devi specificare i mesi in un elenco separato da virgole
e può includere una combinazione dei seguenti valori lunghi o abbreviati:
january
ojan
february
ofeb
march
omar
april
oapr
may
june
ojun
july
ojul
august
oaug
september
osep
october
ooct
november
onov
december
odec
- Utilizza
month
per specificare tutti i mesi dell'anno.
- [HH:MM]: devi specificare i valori di tempo nel formato 24 ore,
HH:MM
, dove:HH
sono numeri interi da00
a23
.MM
sono numeri interi da00
a59
.
Esempio:
schedule: 1st monday of sep,oct,nov 09:00 schedule: 1 of jan,april,july,oct 00:00
- [MONTH]: devi specificare i mesi in un elenco separato da virgole
e può includere una combinazione dei seguenti valori lunghi o abbreviati:
- Esempi di intervalli personalizzati
- Utilizza i seguenti esempi per capire come definire il job
le pianificazioni che utilizzano un intervallo personalizzato:
- Viene eseguito ogni giorno alle ore 00:00:
schedule: every day 00:00
- Viene eseguito ogni lunedì alle 09:00:
schedule: every monday 09:00
- Verrà eseguita una volta il secondo mercoledì di marzo alle ore 17:00:
schedule: 2nd wednesday of march 17:00
- Viene eseguito sei volte a maggio. Durante le prime due settimane, esegue una
ogni lunedì, mercoledì e venerdì alle 10.00:
schedule: 1st,second mon,wed,fri of may 10:00
- Viene eseguito una volta alla settimana. Ogni sette giorni a partire dal primo giorno di
ogni mese, viene eseguita una volta alle 09:00:
schedule: 1,8,15,22 of month 09:00
- Eseguita a settimane alterne. Il primo e il terzo lunedì di ogni mese,
viene eseguita una volta alle 04:00:
schedule: 1st,third monday of month 04:00
- Viene eseguita tre volte all'anno. Il primo lunedì di settembre,
Da ottobre e novembre, viene eseguita una sola volta alle 09:00:
schedule: 1st monday of sep,oct,nov 09:00
- Viene eseguita una volta ogni trimestre. Il primo giorno di gennaio, aprile,
luglio e ottobre viene eseguito una volta alle 00:00:
schedule: 1 of jan,april,july,oct 00:00
- Viene eseguito ogni giorno alle ore 00:00:
Specificare i nuovi tentativi
Se il gestore delle richieste di un job cron restituisce un codice di stato non compreso tra 200 e 299 (inclusi), App Engine considera il job non riuscito. Di
per impostazione predefinita, i job non riusciti non vengono tentati di nuovo. Puoi fare in modo che i job non riusciti vengano riprovati includendo un blocco retry_parameters
nel file di configurazione.
Ecco un file cron.yaml di esempio che contiene un singolo job cron configurato per ritentare fino a cinque volte con un backoff iniziale di 2,5 secondi che raddoppia ogni volta.
cron:
- description: "retry demo"
url: /retry
schedule: every 10 mins
retry_parameters:
job_retry_limit: 5
min_backoff_seconds: 2.5
max_doublings: 5
Sintassi dei nuovi tentativi cron
I parametri per i nuovi tentativi sono descritti nella tabella seguente.
Elemento | Descrizione |
---|---|
job_retry_limit |
Un numero intero che rappresenta il numero massimo di nuovi tentativi per un
cron job non riuscito. Il valore minimo è 0 , mentre il massimo
è 5 . Se specifichi anche job_age_limit ,
App Engine riprova il cron job fino a quando non raggiunge entrambi i limiti.
Il valore predefinito per job_retry_limit è 0 .
|
job_age_limit |
Il limite di tempo per il nuovo tentativo di un cron job non riuscito, misurato dal momento in cui
viene eseguita per la prima volta il cron job. Il valore è un numero seguito da un'unità di misura del tempo, dove l'unità è s per i secondi, m per i minuti, h per le ore o d per i giorni. Ad esempio, il valore 5d specifica un limite di cinque giorni dopo il primo tentativo di esecuzione del job cron. Se specifichi anche
job_retry_limit , App Engine riprova il cron job fino a quando non
raggiunge entrambi i limiti.
|
min_backoff_seconds |
Numero minimo di secondi di attesa prima di riprovare un cron job dopo non riesce. |
max_backoff_seconds |
Il numero massimo di secondi che devono trascorrere prima di riprovare un cron job dopo non riesce. |
max_doublings |
Il numero massimo di volte in cui l'intervallo tra i tentativi di job cron non riusciti verrà raddoppiato prima che l'aumento diventi costante. La
costante è:
2**(max_doublings - 1) * min_backoff .
|
Convalida delle richieste cron
Ti consigliamo di verificare che le richieste agli URL cron provengano da App Engine e non da un'altra origine. Puoi farlo convalidando Intestazione HTTP e indirizzo IP di origine della richiesta:
Le richieste da parte del servizio Cron conterranno la seguente intestazione HTTP:
"X-Appengine-Cron": "true"
Questa e altre intestazioni sono impostati internamente da App Engine. Se un client invia queste intestazioni, vengono rimosse dalla richiesta.
App Engine invia richieste Cron dall'indirizzo IP
0.1.0.2
. Per i cron job creati con versioni precedenti di gcloud (precedente alla 326.0.0), le richieste di Cron provengono da0.1.0.1
.
Per i runtime Java, in Jetty o Tomcat, puoi eseguire questa convalida in una filtro.
Timeout richiesta
Il timeout della richiesta di cron è di 60 minuti.Per ulteriori informazioni sui timeout delle richieste per ambiente e tipo di scalabilità, consulta Scegliere un ambiente App Engine.
Caricamento di cron job
Per caricare i cron job, devi specificare cron.yaml
come parametro
al seguente comando gcloud:
gcloud app deploy cron.yaml
Eliminazione di cron job
Per eliminare tutti i cron job, modifica il file cron.yaml
in modo che contenga solo:
cron:
Supporto cron nella console Google Cloud
Puoi controllare i cron job pianificati nella pagina Cron job della console Google Cloud.
Puoi anche visitare la pagina Log per vedere quando sono stati aggiunti o rimossi i cron job.