ID regione
REGION_ID è un codice abbreviato assegnato da Google in base alla regione selezionata quando crei l'app. Il codice non corrisponde a un paese o a una provincia, anche se alcuni ID regione possono sembrare simili ai codici di paesi e province di uso comune. Per le app create dopo febbraio 2020, REGION_ID.r è incluso negli URL di App Engine. Per le app esistenti create prima di questa data, l'ID regione è facoltativo nell'URL.
Scopri di più sugli ID regione.
Il file di configurazione queue.yaml viene utilizzato per creare e configurare quasi tutti
delle code di attività
(push o pull)
usati dalla tua app. Tutte le app di App Engine includono
una coda in modalità push preconfigurata e denominata default. Anche se
creare la coda default autonomamente, puoi aggiungere altre code o modificare
configurazione della coda default utilizzando il file queue.yaml.
Per configurare le code push, puoi utilizzare i metodi queue.yaml o
Gestione code di Cloud Tasks, ma
non entrambi contemporaneamente. Combinando
Il metodo di caricamento queue.yaml con metodi di gestione delle code può produrre risposte impreviste
risultati e non è consigliato.
queue.yaml.
Esempio
Di seguito è riportato un esempio di base che definisce una coda denominata e sostituisce la frequenza di elaborazione predefinita:
queue:
- name: my-push-queue
rate: 1/s
Di seguito è riportato un esempio più complesso di configurazione di queue.yaml che dimostra come impostare il numero di tentativi di attività e modificare la frequenza di elaborazione predefinita.
queue:
- name: fooqueue
rate: 1/s
retry_parameters:
task_retry_limit: 7
task_age_limit: 2d
- name: barqueue
rate: 1/s
retry_parameters:
min_backoff_seconds: 10
max_backoff_seconds: 200
max_doublings: 0
- name: bazqueue
rate: 1/s
retry_parameters:
min_backoff_seconds: 10
max_backoff_seconds: 200
max_doublings: 3
Sintassi
Il file queue.yaml è un file YAML la cui direttiva principale è queue.
Questa direttiva contiene zero o più code denominate. Ogni definizione di coda può specificare i seguenti elementi:
| Elemento | Descrizione |
|---|---|
bucket_size (code push) |
Facoltativo. Una coda di attività utilizza l'algoritmo bucket di token per controllare la frequenza di esecuzione delle attività. Ogni coda denominata ha un token bucket che contiene i token, fino al limite 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à e la frequenza è elevata. Il valore massimo per il bucket è 500. Ciò ti consente di avere una velocità elevata, quindi l'elaborazione inizia poco dopo che un'attività viene accodata, ma limita l'utilizzo delle risorse molte attività vengono accodate in un breve arco di tempo. Se non specifichi bucket_size per una coda, il parametro il valore predefinito è 5. Ti consigliamo di impostare un valore maggiore perché la dimensione predefinita potrebbe essere troppo piccola per molti casi d'uso. Per Ad esempio, puoi determinare la dimensione del bucket in base all'elaborazione aliquota. Per ulteriori informazioni su questo elemento, consulta la descrizione comparativa di
|
max_concurrent_requests (code push) |
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 possono aumentare lentamente quando o se sono rimasti inattivi per un po'. La limitazione del numero di attività simultanee offre un maggiore controllo la velocità di esecuzione della coda e il numero di attività potrebbe in esecuzione 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
|
mode |
Facoltativo.
Identifica la modalità coda. Il valore predefinito di questa impostazione è |
name |
Obbligatorio.
Il nome della coda. Si tratta
del nome specificato quando chiami
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 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 |
rate (code push) |
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à è
Se il numero è Per ulteriori informazioni su questo elemento, consulta la descrizione comparativa di
|
retry_parameters |
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 dei nuovi tentativi possono contenere i seguenti sottoelementi:
|
target (code push) |
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 è Se target non è specificato, le attività vengono richiamate nella stessa versione dell'applicazione in cui sono state messe in coda. Quindi, se hai accodato dell'attività dalla versione predefinita dell'applicazione senza specificare una destinazione nella coda, l'attività viene richiamata nella versione predefinita dell'applicazione. Tieni presente che se la versione predefinita dell'applicazione cambia nel tempo che l'attività è in coda e l'orario in cui viene eseguita, verranno eseguite nella nuova versione predefinita. Se utilizzi i servizi insieme a un servizio di spedizione , la richiesta HTTP dell'attività potrebbe essere intercettata e reinstradata a un altro servizio. |
Per tutte le code all'interno di un'app è possibile specificare i seguenti elementi:
| Elemento | Descrizione |
|---|---|
total_storage_limit |
Facoltativo. Una stringa che sostituisce il limite di spazio di archiviazione predefinito disponibile per l'archiviazione in coda di attività (100 milioni). Ad esempio: total_storage_limit: 1.2G queue: - name: fooqueue Questa quota fa parte della quota di spazio di archiviazione totale dell'applicazione (tra cui la quota di datastore e BLOB). Se non viene specificato alcun suffisso, il numero specificato viene interpretato come byte. Sono supportati i seguenti suffissi:
Se |
Deployment del file di configurazione della coda
Il filequeue.yaml deve trovarsi nella directory principale o nella
che definisce il servizio predefinito.
Per eseguire il deployment del file di configurazione della coda, esegui questo comando:
gcloud app deploy queue.yaml
Eliminazione delle code in corso...
Per eliminare una coda:
Rimuovi la definizione della coda dal file
queue.yaml.Carica la modifica nel file
queue.yaml.gcloud app deploy queue.yaml
Elimina la coda nella console Google Cloud, selezionala e fai clic su Elimina coda:
Se elimini una coda dalla console Google Cloud, devi attendere 7 giorni prima di ricrearla con lo stesso nome.