ID regione
REGION_ID
è un codice abbreviato che viene assegnato da Google
in base alla regione selezionata al momento della creazione dell'app. Il codice non corrisponde a un paese o a una provincia, anche se alcuni ID regione possono essere simili ai codici paese e di provincia di uso comune. Per le app create dopo febbraio 2020, il campo 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.
dispatch.yaml
consente di ignorare le regole di routing.
Puoi utilizzare dispatch.yaml
per inviare richieste in entrata a un servizio specifico (noto in precedenza come moduli) in base al percorso o al nome host nell'URL.
Per saperne di più, vedi Modalità di routing delle richieste.
Un'app può avere un solo file dispatch.yaml
e le regole di routing in quel file si applicano a tutti i servizi e a tutte le versioni dell'app.
Le regole di routing si applicano anche agli URL utilizzati in un file cron.
Deployment del file dispatch
Il file dispatch.yaml
deve trovarsi nella stessa directory del codice sorgente di Go.
Prima di eseguire il deployment del file dispatch, devi assicurarti che sia stato già eseguito il deployment di tutti i servizi definiti nel file in App Engine. Per eseguire il deployment del file dispatch.yaml
, esegui il comando gcloud app deploy
dalla directory che contiene dispatch.yaml
:
gcloud app deploy dispatch.yaml
Syntax
L'elemento principale nel file dispatch.yaml
è dispatch:
e contiene un elenco di definizioni di routing specificate dai seguenti elementi secondari.
Le regole che definisci nel file dispatch devono utilizzare pattern URL HTTP che includono la notazione ".
" per separare i sottodomini. Gli URL definiti con la notazione HTTPS "-dot-
" non sono supportati.
Le regole di invio dipendono dall'ordine e viene applicata solo la prima regola che corrisponde a un URL.
Elemento | Descrizione |
---|---|
service |
Specifica il nome del servizio che gestirà le richieste che corrispondono al pattern |
url |
Nell'elemento
Suggerimento: puoi includere pattern glob come il carattere jolly Un pattern URL che può includere il nome host e il percorso dell'URL. I caratteri globi possono essere utilizzati per la corrispondenza con i pattern. I caratteri Glob possono essere specificati solo all'inizio e alla fine del pattern.
I percorsi URL che iniziano con |
Esempio
Di seguito è riportato un file dispatch di esempio che instrada le richieste a https://simple-sample.uc.r.appspot.com
e richieste come https://simple-sample.uc.r.appspot.com/favicon.ico
al servizio default
. Tutti i contenuti statici vengono pubblicati dal servizio default
. Le richieste mobile come https://simple-sample.uc.r.appspot.com/mobile/
vengono indirizzate a un frontend mobile, mentre le richieste worker come https://simple-sample.uc.r.appspot.com/work/
vengono indirizzate a un backend statico.
Se preferisci regole di routing generali che soddisfano molte richieste possibili, puoi definire regole con ambiti più ampi. Ad esempio:
Puoi anche scrivere espressioni più rigorose:
Limiti
Il file dispatch può contenere fino a 20 regole di routing. Quando specifichi la stringa URL, il nome host o il percorso non possono contenere più di 100 caratteri.
Eliminazione di tutte le regole di invio
Per eliminare tutte le regole di invio:
Modifica i contenuti del file
dispatch.yaml
in:dispatch: []
Esegui il deployment del file
dispatch.yaml
in App Engine.