ID regione
REGION_ID
è un codice abbreviato assegnato da Google in base all'area geografica selezionata al momento della creazione dell'app. Il codice non corrisponde a un paese o a una provincia, anche se alcuni ID regione possono sembrare simili ai codici paese e provincia 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.
In questa pagina viene descritto in che modo le richieste HTTP degli utenti raggiungono la versione appropriata di un servizio. Le richieste possono essere indirizzate nei seguenti modi:
Queste opzioni si applicano solo alle app di cui è stato eseguito il deployment. Quando esegui test in locale, il comportamento di routing dipende dall'ambiente di runtime e sviluppo specifico in uso.
Routing con gli URL
Quando l'app è in esecuzione in App Engine, puoi utilizzare il seguente URL per inviare richieste HTTP all'app:
https://PROJECT_ID.REGION_ID.r.appspot.com
dove PROJECT_ID
è l'ID del progetto Google Cloud che contiene l'app.
Questo URL invia richieste al servizio predefinito dell'app alla versione che hai configurato per ricevere il traffico.
URL per servizi e versioni
Se crei più di un servizio nella tua app, ogni servizio ha il proprio URL. Ogni versione di un servizio ha anche un proprio URL, quindi puoi eseguire il deployment e testare una nuova versione prima di configurare quella versione per ricevere traffico.
Gli URL per servizi e versioni specifici sono nel seguente formato:
VERSION-dot-SERVICE-dot-PROJECT_ID.REGION_ID.r.appspot.com
Puoi omettere VERSION-dot-
se non devi scegliere come target una versione specifica.
Per recuperare gli ID dei servizi e delle versioni della tua app, puoi utilizzare uno dei seguenti strumenti:
Console
Nella console Google Cloud puoi visualizzare le pagine Istanze, Servizi e Versioni corrispondenti.
gcloud
Esegui il comando gcloud app instances list
per elencare gli ID risorsa all'interno di un progetto Google Cloud specifico.
API
Per recuperare gli ID risorsa in modo programmatico, consulta i metodi list
nell'API Admin.
URL di esempio
Di seguito sono riportati alcuni esempi di URL per App Engine, che mostrano sia il dominio appspot.com
assegnato da App Engine alla tua app sia un dominio personalizzato che puoi configurare per la tua app.
- Invia la richiesta a un'istanza disponibile del servizio
default
: https://PROJECT_ID.REGION_ID.r.appspot.com
https://CUSTOM_DOMAIN
Le richieste vengono ricevute da qualsiasi versione configurata per il traffico nel servizio
default
.- Invia la richiesta a un'istanza disponibile del servizio
- Invia una richiesta a un'istanza disponibile di un servizio specifico:
https://SERVICE_ID-dot-PROJECT_ID.REGION_ID.r.appspot.com
https://SERVICE_ID.CUSTOM_DOMAIN
Le richieste vengono ricevute da qualsiasi versione configurata per il traffico nel servizio scelto come target. Se il servizio che hai scelto come target non esiste, la richiesta viene instradata temporaneamente.
- Invia una richiesta a un'istanza disponibile di una versione specifica nella
- Servizio
default
: https://VERSION_ID-dot-default-dot-PROJECT_ID.REGION_ID.r.appspot.com
https://VERSION_ID.CUSTOM_DOMAIN
Quando un servizio non viene scelto come target, vengono inviate richieste al servizio
default
.
Routing flessibile
Se una richiesta corrisponde alla parte PROJECT_ID.REGION_ID.r.appspot.com
del nome host, ma include un servizio, una versione o un nome di istanza inesistente, viene instradata al servizio default
. Il routing soft non si applica ai domini personalizzati; le richieste a questi ultimi restituiranno un codice di stato HTTP 404
se il nome host non è valido.
Routing target
Se presenti, viene garantito il raggiungimento del target dei seguenti pattern URL. Queste richieste non vengono mai intercettate e reindirizzate dai pattern definiti nel file dispatch:
- Invia la richiesta a un'istanza disponibile di un servizio e di una versione specifici:
https://VERSION-dot-SERVICE-dot-PROJECT_ID.REGION_ID.r.appspot.com
https://VERSION_ID.SERVICE_ID.PROJECT_ID.CUSTOM_DOMAIN
Routing con un file dispatch
Puoi creare un file dispatch per eseguire l'override delle regole di routing basate su URL di App Engine e definire le tue regole di routing personalizzate. Con un file dispatch, puoi inviare le richieste in arrivo a un servizio specifico in base al percorso o al nome host nell'URL della richiesta.
Creazione di un file dispatch
Per creare un file dispatch:
Crea un file denominato
dispatch.yaml
nella directory principale del progetto o nella directory principale del serviziodefault
.Definisci le regole di routing nel file come descritto, consulta il riferimento a
dispatch.yaml
.
Tieni presente quanto segue in merito alle regole di routing:
- Puoi definire fino a 20 regole di routing. Ogni regola deve contenere gli elementi
url
eservice
. - Le regole 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 si applicano anche agli URL che definisci nel
file
cron.yaml
.
Ad esempio, puoi creare un file dispatch per instradare le richieste mobile come https://simple-sample.uc.r.appspot.com/mobile/
a un frontend mobile e le richieste dei worker, come https://simple-sample.uc.r.appspot.com/work/
, a un backend statico:
dispatch:
# Send all mobile traffic to the mobile frontend.
- url: "*/mobile/*"
service: mobile-frontend
# Send all work to the one static backend.
- url: "*/work/*"
service: static-backend
Deployment del file dispatch
Per eseguire il deployment del file dispatch utilizzando gcloud
, esegui questo comando:
gcloud app deploy dispatch.yaml
Routing con Cloud Load Balancing
Cloud Load Balancing è un prodotto separato che consente configurazioni di rete avanzate per tutte le applicazioni in esecuzione su Google Cloud.
Quando il bilanciamento del carico HTTP(S) è abilitato per le app serverless, puoi:
Configura la tua app serverless per gestire da un indirizzo IP IPv4 e/o IPv6 dedicato non condiviso con altri servizi.
Riutilizza gli stessi certificati SSL e le stesse chiavi private che utilizzi per Compute Engine, Google Kubernetes Engine e Cloud Storage. In questo modo non è necessario gestire certificati separati per le app serverless.
Il bilanciatore del carico non interferisce né interagisce con le regole di routing nel file dispatch.yaml
. Le regole dispatch.yaml
non vengono valutate finché un
NEG serverless non indirizza il traffico ad App Engine.
Tieni presente quanto segue:
- Ti consigliamo di utilizzare i controlli in entrata in modo che la tua app riceva solo le richieste inviate dal bilanciatore del carico (e dal VPC, se lo utilizzi). In caso contrario, gli utenti possono utilizzare l'URL di App Engine della tua app per ignorare il bilanciatore del carico, i criteri di sicurezza di Google Cloud Armor, i certificati SSL e le chiavi private trasmesse attraverso il bilanciatore del carico.
Metriche incoerenti quando l'ambiente flessibile di App Engine utilizza Cloud Load Balancing
La dashboard dell'ambiente flessibile di App Engine mostra tutte le metriche solo per le richieste instradate tramite un backend gestito dall'ambiente flessibile. Se utilizzi l'ambiente flessibile di App Engine con Cloud Load Balancing, alcune metriche nella tabella delle metriche di App Engine vengono riportate come metriche dalla tabella loadbalancing
. Per ulteriori informazioni, consulta Logging e monitoraggio del bilanciamento del carico HTTP(S).
Ulteriori dettagli sugli URL di App Engine
Comprensione dell'ID regione negli URL
REGION_ID
è un codice abbreviato assegnato da Google in base all'area geografica selezionata al momento della creazione dell'app. Il codice non corrisponde a un paese o a una provincia, anche se alcuni ID regione possono sembrare simili ai codici paese e provincia 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.
Per visualizzare l'ID regione della tua app puoi utilizzare i seguenti strumenti:
Console
Nella console Google Cloud, puoi visualizzare gli URL per le istanze, i servizi e le versioni della tua app.
Tutti questi URL includono l'ID regione.
gcloud
Quando esegui il deployment di un'app o di un servizio, il comando gcloud app deploy
mostra l'URL al termine del deployment. Questo URL include l'ID regione.
Per visualizzare l'URL di un servizio di cui è già stato eseguito il deployment:
Inserisci il comando
gcloud app versions list
per elencare le versioni di un servizio specifico. Ad esempio, per elencare le versioni del servizio predefinito, inseriscigcloud app versions list --service=default
.Inserisci il comando
gcloud app versions describe
. L'output di tale comando include l'URL della versione con l'ID regione dell'app. Ad esempio, per descrivere la versione 20191023t101741 per il servizio predefinito, inseriscigcloud app versions describe 20191023t101741 --service=default
Il nome di dominio è incluso nei dati della richiesta
Il nome di dominio utilizzato per la richiesta è incluso nei dati della richiesta che vengono passati all'app. Pertanto, puoi utilizzare i dati della richiesta per controllare la modalità di risposta dell'app in base al nome di dominio nella richiesta. Ad esempio, se vuoi
reindirizzare a un dominio ufficiale, puoi codificare la tua app in modo che controlli l'intestazione della richiesta Host
,
quindi rispondere di conseguenza in base al nome di dominio.