Riferimento a queue.yaml

Facoltativo. Una coda di attività utilizza l'algoritmo bucket di token per controllare la frequenza di esecuzione delle attività. Ogni coda con nome ha un token bucket che contiene i token, fino al numero massimo specificato dal valore bucket_size. Ogni volta che la tua applicazione esegue un'attività, un token viene rimosso dal bucket. Continua a elaborare le attività nella coda finché il bucket della coda non esaurisce i token. App Engine rifornisce il bucket con nuovi token continuamente in base alla frequenza specificata per la coda.

La dimensione del bucket limita la velocità di elaborazione della coda quando sono presenti molte attività nella coda e la frequenza è elevata. Il valore massimo per la dimensione del bucket è 500. In questo modo puoi avere una frequenza elevata in modo che l'elaborazione inizi poco dopo l'inserimento di un'attività in coda, ma puoi comunque limitare l'utilizzo delle risorse quando molte attività vengono inserite in coda in un breve periodo di tempo.

Se non specifichi bucket_size per una coda, il valore predefinito è 5. Ti consigliamo di impostare un valore più elevato perché la dimensione predefinita potrebbe essere troppo piccola per molti casi d'uso. Ad esempio, puoi determinare le dimensioni del bucket in base alla velocità di elaborazione.

Per ulteriori informazioni su questo elemento, consulta la descrizione comparativa di max_burst_size

Facoltativo. Imposta il numero massimo di attività che possono essere eseguite contemporaneamente dalla coda specificata. Il valore è un numero intero. Per impostazione predefinita, il limite è 1000 attività per coda. Il limite massimo consigliato è di 5000 attività per coda. Tieni presente che le code potrebbero aumentare lentamente quando vengono create per la prima volta o se sono inattive da un po' di tempo.

La limitazione del numero di attività simultanee ti consente di avere un maggiore controllo sulla frequenza di esecuzione della coda e può impedire l'esecuzione di troppe attività contemporaneamente. Inoltre, può evitare la contesa del datastore e mettere a disposizione le risorse per altre code o l'elaborazione online.

Per ulteriori informazioni su questo elemento, consulta la descrizione comparativa di max_concurrent_dispatches nel riferimento all'API Cloud Tasks.

Facoltativo. Identifica la modalità coda. Per impostazione predefinita, questo valore è push, che identifica una coda come coda push. Se vuoi utilizzare le code pull, imposta la modalità su pull.

Obbligatorio. Il nome della coda. Si tratta del nome specificato quando chiami QueueFactory.getQueue().

Un nome coda può contenere lettere maiuscole e minuscole, numeri e trattini. La lunghezza massima di un nome coda è 100 caratteri.

Tutte le app hanno una coda in modalità push denominata predefinita. Questa coda ha una frequenza preimpostata di 5 attività al secondo. Tieni presente che questa coda predefinita non viene visualizzata nella console Google Cloud fino alla prima volta che viene utilizzata o configurata. Puoi configurare la coda predefinita, inclusa la modifica della frequenza predefinita, definendo una coda denominata "predefinita" nel file queue.yaml.

Obbligatorio. La frequenza con cui le attività vengono elaborate in questa coda. Il valore è un numero seguito da una barra e da un'unità di 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 5/m indica che le attività verranno elaborate a una frequenza di 5 volte al minuto. Il valore massimo per rate è 500/s.

Se il numero è 0 (ad es. 0/s), la coda è considerata "in pausa" e non vengono elaborate attività.

Per ulteriori informazioni su questo elemento, consulta la descrizione comparativa di max_dispatches_per_second nel riferimento all'API Cloud Tasks.

Facoltativo. Configura i tentativi di nuovo invio per le attività non riuscite nelle code push. Questa aggiunta ti consente di specificare il numero massimo di volte per riprovare le attività non riuscite in una coda specifica. Puoi anche impostare un limite di tempo per i tentativi di ripetizione e controllare l'intervallo tra i tentativi.

I parametri di ripetizione possono contenere i seguenti elementi secondari:

task_retry_limit

Il numero di nuovi tentativi. Ad esempio, se viene specificato 0 e l'attività non va a buon fine, non viene eseguito alcun nuovo tentativo. Se viene specificato 1 e l'attività non va a buon fine, viene eseguito un nuovo tentativo per l'attività. Se questo parametro non è specificato, l'operazione viene ripetuta a tempo indeterminato. Se viene specificato task_retry_limit con task_age_limit, viene eseguito un nuovo tentativo per l'attività fino a quando non vengono raggiunti entrambi i limiti.

task_age_limit (code push)

Il limite di tempo per ritentare un'attività non riuscita, misurato dal primo tentativo di esecuzione dell'attività. 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 dell'attività. Se questo parametro non è specificato, il tentativo viene ripetuto a tempo indeterminato. Se specificato con task_retry_limit, App Engine riprova l'attività fino a quando non vengono raggiunti entrambi i limiti.

min_backoff_seconds (code push)

Il numero minimo di secondi da attendere prima di riprovare un'attività dopo che non è riuscita. Il valore predefinito è 0.1.

max_backoff_seconds (code push)

Il numero massimo di secondi di attesa prima di riprovare un'attività dopo che non è riuscita. Il valore predefinito è 3600.

max_doublings (code push)

Il numero massimo di volte in cui l'intervallo tra i tentativi di attività non riuscita verrà raddoppiato prima che l'aumento diventi costante. La costante è: 2**max_doublings * min_backoff_seconds. Il valore predefinito è 16.

Facoltativo. Una stringa che indica un servizio/una versione, una versione frontend o un backend su cui eseguire tutte le attività in coda in questa coda. Il valore predefinito è la stringa vuota.

La stringa viene anteposta al nome di dominio della tua app durante la compilazione della richiesta HTTP per un'attività. Ad esempio, se il tuo ID app è my-app e imposti il target su my-version-dot-my-service, il nome host dell'URL verrà impostato su my-version-dot-my-service-dot-my-app.REGION_ID.r.appspot.com.

Se target non è specificato, le attività vengono richiamate nella stessa versione dell'applicazione in cui sono state messe in coda. Pertanto, se hai inserito in coda un compito dalla versione dell'applicazione predefinita senza specificare un target nella coda, il compito viene invocato nella versione dell'applicazione predefinita. Tieni presente che se la versione predefinita dell'applicazione cambia tra il momento in cui l'attività viene messa in coda e il momento in cui viene eseguita, l'attività verrà eseguita nella nuova versione predefinita.

Se utilizzi servizi insieme a un file di invio, la richiesta HTTP dell'attività potrebbe essere intercettata e reindirizzata a un altro servizio.

Facoltativo. Una stringa che sostituisce il limite di spazio di archiviazione della quota predefinito disponibile per lo spazio di archiviazione della coda di attività (100 M). Ad esempio:

total_storage_limit: 1.2G
queue:
  - name: fooqueue

Questa quota fa parte della quota di spazio di archiviazione totale dell'applicazione (inclusa la quota del datastore e dell'archivio BLOB).

Se non viene specificato alcun suffisso, il numero specificato viene interpretato come byte. Sono supportati i seguenti suffissi:

• B (byte)
• K (kilobyte)
• M (megabyte)
• G (gigabyte)
• T (terabyte)

Se total_storage_limit supera lo spazio di archiviazione totale su disco disponibile per un'applicazione, il limite è limitato allo spazio di archiviazione disponibile.