Modalità di instradamento delle richieste

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.

Questa pagina descrive come le richieste HTTP degli utenti raggiungono la versione appropriata di un servizio. Le richieste possono essere inoltrate nei seguenti modi:

Se testi l'app utilizzando il server di sviluppo locale, le funzionalità di routing e invio disponibili sono leggermente diverse. Per creare in modo programmatico URL che funzionino sia con i server di produzione sia con quelli di sviluppo, utilizza la variabile $_SERVER['HTTP_HOST'].

Per scoprire di più, consulta la sezione sul routing nel server di sviluppo.

Routing con URL

Una volta che 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 della tua app nella 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 il proprio URL, quindi puoi eseguire il deployment e testare una nuova versione prima di configurarla per ricevere il 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 in modo programmatico gli ID risorsa, 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 appspot.com dominio 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 serviziodefault.

  • 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 di destinazione. Se il servizio scelto come target non esiste, la richiesta viene indirizzata in modo flessibile.

  • Invia una richiesta a un'istanza disponibile di una versione specifica nel
    Servizio default:
    
https://VERSION_ID-dot-default-dot-PROJECT_ID.REGION_ID.r.appspot.com
https://VERSION_ID.CUSTOM_DOMAIN

    Quando un servizio non è scelto come target, le richieste vengono inviate 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 istanza che non esiste, la richiesta viene indirizzata al servizio default. Il routing graduale non si applica ai domini personalizzati; le richieste inviate a questi domini restituiranno un codice di stato HTTP 404 se il nome host non è valido.

Percorso mirato

I seguenti pattern URL raggiungono sicuramente il target, se esistenti. Queste richieste non vengono mai intercettate e reindirizzate dagli schemi che hai definito 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

  • Se utilizzi servizi con scalabilità manuale, puoi scegliere come target e inviare una richiesta a un'istanza includendone l'ID. L'ID istanza è un numero intero compreso tra 0 e il numero totale di istanze in esecuzione e può essere specificato come segue:

    Invia una richiesta a un servizio e a una versione specifici all'interno di un'istanza specifica: 

    https://INSTANCE_ID-dot-VERSION_ID-dot-SERVICE_ID-dot-PROJECT_ID.REGION_ID.r.appspot.com
https://INSTANCE_ID.VERSION_ID.SERVICE_ID.CUSTOM_DOMAIN

Instradamento 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 entrata a un servizio specifico in base al percorso o al nome dell'host nell'URL della richiesta.

Creazione di un file dispatch

Per creare un file dispatch:

  1. Crea un file denominato dispatch.yaml nella directory principale del progetto o nella directory principale del servizio default.

  2. Definisci le regole di routing nel file come descritto nella documentazione di riferimento dispatch.yaml.

Tieni presente quanto segue sulle regole di routing:

  • Puoi definire fino a 20 regole di routing. Ogni regola deve contenere gli elementi url e service.
  • 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 definiti nel file cron.

Ad esempio, puoi creare un file dispatch per inoltrare le richieste mobile comehttps://simple-sample.uc.r.appspot.com/mobile/ a un frontend mobile e le richieste dei lavoratori 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

Eseguire il deployment del file dispatch

Per eseguire il deployment del file dispatch, esegui il seguente 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 tue applicazioni in esecuzione su Google Cloud.

Quando il bilanciamento del carico HTTP(S) è abilitato per le app serverless, puoi:

  • Configura l'app serverless in modo che venga pubblicata da un indirizzo IP IPv4 e/o IPv6 dedicato che 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 o interagisce con le regole di routing nel tuo 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 di immissione in modo che la tua app riceva solo le richieste inviate dal bilanciatore del carico (e dalla VPC, se la utilizzi). In caso contrario, gli utenti possono utilizzare l'URL App Engine della tua app per bypassare il bilanciatore del carico, i criteri di sicurezza di Google Cloud Armor, i certificati SSL e le chiavi private trasmessi tramite il bilanciatore del carico.

Routing nel server di sviluppo

Rilevamento degli indirizzi delle istanze

Il server di sviluppo locale crea tutte le istanze di scalabilità manuale all'avvio. Le istanze per i servizi di scalabilità automatica e di base vengono gestite in modo dinamico. Il server assegna una porta a ogni servizio e i client possono fare affidamento sul server per il bilanciamento del carico e la selezione automatica di un'istanza. Le assegnazioni delle porte per l'indirizzamento di ciascun servizio vengono visualizzate nello stream di messaggi di log del server. Ecco le porte per un'app che definisce tre servizi (il tipo di scalabilità di ciascun servizio non è pertinente):

INFO Starting module "default" running at: http://localhost:8084
INFO Starting module "service1" running at: http://localhost:8082
INFO Starting module "service2" running at: http://localhost:8083

Quando utilizzi l'indirizzo di un servizio (ad esempio http://localhost:8082/), il server seleziona (o crea) un'istanza del servizio e invia la richiesta a questa istanza.

Il server assegna porte univoche a ogni istanza di un servizio. Per rilevare queste porte, devi utilizzare il server di amministrazione. Esiste una porta univoca per il server di amministrazione, che viene visualizzata nel log dei messaggi:

INFO Starting admin server at: http://localhost:8000

Questo indirizzo ti reindirizza alla console del server di amministrazione. Da qui puoi fare clic su Istanze per visualizzare lo stato dinamico delle istanze dell'app:

Screenshot della console di amministrazione di dev_appserver

Viene visualizzata una voce separata per ogni istanza manuale e di base. I numeri di istanza sono link con indirizzi di porta univoci per ogni istanza. Puoi passare il mouse sopra un link per visualizzare la porta assegnata a quell'istanza o fare clic sul link per inviare una richiesta direttamente a quell'istanza.

Invia file

Se la tua app include un file dispatch.yaml, lo stream di messaggi di log includerà una porta di Dispatcher:

INFO Starting dispatcher running at: http://localhost:8080

Le richieste a questa porta vengono instradate in base alle regole nel file di invio. Il server non supporta le regole dei file dispatch.yaml che includono hostname (ad esempio url: "customer1.myapp.com/*"). Le regole con pattern di percorso relativi (url: "*/fun") funzioneranno, quindi puoi utilizzare URL come http://localhost/fun/mobile per raggiungere le istanze. Il server segnerà un errore nello stream di log se provi ad avviare un'applicazione con un file dispatch.yaml contenente regole basate sull'host.

Limitare l'accesso a un servizio

Per impostazione predefinita, tutti i servizi sono pubblici. Se vuoi limitare l'accesso a un servizio, aggiungi l'elemento login: admin ai suoi handler.

Ulteriori dettagli sugli URL di App Engine

Informazioni sull'ID regione negli URL

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.

Per visualizzare l'ID regione della tua app, puoi utilizzare i seguenti strumenti:

Console

Nella console Google Cloud, puoi visualizzare gli URL delle istanze, dei servizi e delle 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 visualizza 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:

  1. Inserisci il comando gcloud app versions list per elencare le versioni di un servizio specifico. Ad esempio, per elencare le versioni del servizio predefinito, inserisci gcloud app versions list --service=default.

  2. Inserisci il comando gcloud app versions describe. L'output di questo comando include l'URL della versione con l'ID regione dell'app. Ad esempio, per descrivere la versione 20191023t101741 per il servizio predefinito, inserisci gcloud 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 trasmessi all'app. Pertanto, puoi utilizzare i dati della richiesta per controllare la risposta dell'app in base al nome di dominio nella richiesta. Ad esempio, se vuoi eseguire un reindirizzamento a un dominio ufficiale, puoi programmare la tua app in modo che controlli l'intestazione della richiesta Host e poi risponda di conseguenza in base al nome di dominio.