Questa guida mostra come configurare le mappe di URL di Google Cloud. Una mappa URL è un insieme di regole per instradare le richieste HTTP(S) in entrata a
servizi di backend o bucket di backendspecifici.
Una mappa URL minima corrisponde a tutti i percorsi delle richieste in entrata (/*
).
Prima di seguire questa guida, acquisisci familiarità con i concetti della mappa degli URL.
Le mappe di URL vengono utilizzate con i seguenti prodotti Google Cloud:
- Bilanciatore del carico delle applicazioni esterno (modalità globale, classica e regionale)
- Bilanciatore del carico delle applicazioni interno
Le mappe URL utilizzate con i bilanciatori del carico delle applicazioni esterni globali, i bilanciatori del carico delle applicazioni esterni regionali, i bilanciatori del carico delle applicazioni interni e Cloud Service Mesh supportano anche diverse funzionalità avanzate di gestione del traffico. Per ulteriori informazioni, consulta Concetti relativi alle mappe URL: gestione avanzata del traffico.
Valori predefiniti della mappa URL
Le mappe URL hanno due valori predefiniti, come descritto nella tabella seguente.
Tipo predefinito | Impostazione | Significato |
---|---|---|
Valore predefinito della mappa URL | gcloud compute url-maps create
|
Se nessuno dei matcher di percorso o delle regole host corrisponde all'URL in entrata, viene utilizzato il servizio di backend o il bucket di backend predefinito specificato. |
Valore predefinito del matcher percorso | gcloud compute url-maps add-path-matcher
|
Il servizio di backend o il bucket di backend predefinito specificato viene utilizzato
se il percorso
dell'URL corrisponde a un matcher percorso, ma nessuno dei --path-rules
specificati corrisponde. |
Regole host
Una regola host definisce un insieme di host a cui associare le richieste.
In una regola host, il nome host deve essere un nome di dominio completo (FQDN). Il nome host non può essere un indirizzo IPv4 o IPv6. Ad esempio:
- Opere:
example.com
- Opere:
web.example.com
- Opere:
*.example.com
- Non funziona:
35.244.221.250
Configurare le mappe URL
Una mappa URL può inviare traffico a servizi di backendo a bucket di backend. I bucket di backend non sono supportati con i bilanciatori del carico delle applicazioni esterni regionali e i bilanciatori del carico delle applicazioni interni.
Per aggiungere una mappa di URL utilizzando la console Google Cloud, svolgi i seguenti passaggi:
- Vai alla pagina Bilanciamento del carico.
- Fai clic sul nome di un bilanciatore del carico.
- Nella pagina Dettagli del bilanciatore del carico, fai clic su Modifica per il bilanciatore del carico selezionato.
- Seleziona Regole host e percorso.
- Fai clic su Aggiungi regola host e percorso.
Compila il campo Host, il campo Percorsi o entrambi e seleziona un servizio di backend o un bucket di backend.
- Inserisci un nome host completo, ad esempio
web.example.com
. - Inserisci il percorso, ad esempio
/video
. - Nella pagina Regole di host e percorso, nel menu Backend, selezionare un servizio di backend o un bucket di backenddisponibile.
- Inserisci un nome host completo, ad esempio
Cerca il segno di spunta blu a sinistra di Regole host e percorso e fai clic sul pulsante Aggiorna.
Per aggiungere una mappa di URL utilizzando Google Cloud CLI, utilizza il comando
url-maps create
:
gcloud compute url-maps createURL_MAP_NAME \ (--default-backend-bucket=DEFAULT_BACKEND_BUCKET | --default-service=DEFAULT_SERVICE ) \ [--descriptionDESCRIPTION ] \ [--global | --region=REGION ]
Per i bilanciatori del carico delle applicazioni esterni regionali e i bilanciatori del carico delle applicazioni interni, assicurati di includere il flag --region
quando crei la mappa degli URL.
Per creare un'associazione di percorsi, utilizza il comando
gcloud compute url-maps add-path-matcher
:
gcloud compute url-maps add-path-matcherURL_MAP_NAME \ (--default-backend-bucket=DEFAULT_BACKEND_BUCKET | --default-service=DEFAULT_SERVICE ) \ --path-matcher-namePATH_MATCHER \ [--path-rules="PATH =SERVICE or BUCKET "]
Questo comando richiede un servizio di backend o un bucket di backend predefinito a cui può inviare richieste non corrispondenti. Il flag --path-rules
definisce le mappature tra i percorsi delle richieste e i servizi o i bucketdi backend. L'esempio seguente instrada i percorsi di richiesta /video/
e /video/*
al servizio di backend video-service
:
--path-rules="/video=video-service,/video/*=video-service"
Per creare una regola host, utilizza il comando
gcloud compute url-maps add-host-rule
:
gcloud compute url-maps add-host-ruleURL_MAP_NAME \ --hosts=[HOSTS ] --path-matcher-name=PATH_MATCHER
Ad esempio, il seguente valore --hosts
corrisponde alle richieste relative a www.example.com
e a qualsiasi sottodominio di altostrat.com
:
--hosts=[*.altostrat.com,www.example.com]
Per modificare il servizio predefinito o il bucket predefinito di una mappa URL, utilizza il comando
url-maps set-default-service
:
gcloud compute url-maps set-default-serviceURL_MAP_NAME (--default-backend-bucket=DEFAULT_BACKEND_BUCKET | --default-service=DEFAULT_SERVICE )[GCLOUD_WIDE_FLAG ...]
Per creare una mappa URL globale, utilizza la risorsa google_compute_url_map.
Per creare una mappa URL a livello di regione, utilizza la risorsa google_compute_region_url_map.
Convalida la configurazione della mappa degli URL
Prima di eseguire il deployment di una mappa URL, assicurati di convalidare la configurazione della mappa URL per verificare che indirizzi le richieste ai backend appropriati come previsto. Per farlo, aggiungi i test alla configurazione della mappa di URL. Puoi sperimentare con diverse regole della mappa URL ed eseguire tutti i test necessari per assicurarti che la mappa indirizzi il traffico in modo appropriato quando viene implementata. Inoltre, se in futuro dovessero essere necessarie modifiche alle regole, potrai testarle prima di implementare la nuova configurazione.
Utilizza il comando gcloud compute url-maps
validate
per convalidare la configurazione della mappa di URL. Questo comando testa solo la configurazione fornita.
Indipendentemente dal fatto che i test siano stati superati o meno, non vengono salvate modifiche nella mappa degli URL di cui è stato eseguito il deployment. Questo comportamento è diverso da quello di altri comandi della mappa di URL
(edit
, import
), che eseguono anche gli stessi test, ma salvano effettivamente la nuova
configurazione se i test vengono superati. Quando vuoi testare una nuova configurazione di routing senza apportare modifiche alla mappa URL di cui è stato eseguito il deployment, utilizza il comando validate
.
Il comando validate
consente di testare configurazioni avanzate dei percorsi, come il routing in base a intestazioni e parametri di ricerca, i reindirizzamenti da HTTP a HTTPS e le riscritture degli URL.
Non puoi utilizzare la console Google Cloud per convalidare la configurazione della mappa di URL.
Utilizza gcloud
o l'API REST.
Per convalidare la configurazione della mappa di URL, utilizza il comando
gcloud compute url-maps validate
.
Per il bilanciatore del carico delle applicazioni esterno globale:
gcloud compute url-maps validate --sourcePATH_TO_URL_MAP_CONFIG_FILE \ --load-balancing-scheme=EXTERNAL_MANAGED \ --global
Per il bilanciatore del carico delle applicazioni classico:
gcloud compute url-maps validate --sourcePATH_TO_URL_MAP_CONFIG_FILE \ --load-balancing-scheme=EXTERNAL \ --global
- PATH_TO_URL_MAP_CONFIG_FILE: sostituisci con il percorso del file che contiene la configurazione della mappa di URL per la convalida.
Convalidare le modifiche alla mappa URL di un bilanciatore del carico esistente
Se hai già un bilanciatore del carico che richiede modifiche alla mappa degli URL, puoi testare queste modifiche di configurazione prima di renderle attive.
Esporta la mappa URL esistente del bilanciatore del carico in un file YAML.
gcloud compute url-maps export
URL_MAP_NAME \ --destinationPATH_TO_URL_MAP_CONFIG_FILE \ --globalModifica il file YAML con la nuova configurazione. Ad esempio, se vuoi modificare un bilanciatore del carico delle applicazioni esterno e inviare tutte le richieste con il percorso
/video
a un nuovo servizio di backend chiamatovideo-backend-service
, puoi aggiungere test alla configurazione della mappa URL come segue:Configurazione esistente della mappa URL con un singolo
web-backend-service
predefinito:kind: compute#urlMap name:
URL_MAP_NAME defaultService: https://www.googleapis.com/compute/v1/projects/PROJECT_ID /global/backendService/web-backend-serviceConfigurazione della mappa URL modificata con l'aggiunta di un corrispettivo per i percorsi e test sia per il servizio di backend predefinito
web-backend-service
sia per il nuovo servizio di backendvideo-backend-service
:kind: compute#urlMap name:
URL_MAP_NAME defaultService: https://www.googleapis.com/compute/v1/projects/PROJECT_ID /global/backendService/web-backend-service hostRules: - hosts: - '*' pathMatcher: pathmap pathMatchers: - defaultService: https://www.googleapis.com/compute/v1/projects/PROJECT_ID /global/backendService/web-backend-service name: pathmap pathRules: - paths: - /video - /video/* service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID /global/backendService/video-backend-service tests: - description: Test routing to existing web service host: foobar path: / service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID /global/backendService/web-backend-service - description: Test routing to new video service host: foobar path: /video service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID /global/backendService/video-backend-serviceConvalida la nuova configurazione.
gcloud compute url-maps validate --source
PATH_TO_URL_MAP_CONFIG_FILE Se tutti i test vengono superati, dovresti visualizzare un messaggio di operazione riuscita, ad esempio:
Successfully validated [https://www.googleapis.com/compute/v1/projects/
PROJECT_ID /global/urlMaps/URL_MAP_CONFIG_FILE_NAME ]Se i test non vanno a buon fine, viene visualizzato un messaggio di errore. Apporta le correzioni necessarie al file di configurazione della mappa di URL e riprova a eseguire la convalida.
Error: Invalid value for field 'urlMap.tests': ''. Test failure: Expect URL '
HOST /PATH ' to map to service 'EXPECTED_BACKEND_SERVICE ', but actually mapped to 'ACTUAL_BACKEND_SERVICE '.Una volta che sai che la nuova configurazione funziona e non influisce sulla configurazione esistente, puoi importarla nella mappa degli URL. Tieni presente che questo passaggio consente anche di eseguire il deployment della mappa URL con la nuova configurazione.
gcloud compute url-maps import
URL_MAP_NAME \ --sourcePATH_TO_URL_MAP_CONFIG_FILE \ --global
Aggiungere test a una mappa URL
Puoi aggiungere test di configurazione a una mappa URL per assicurarti che indirizzi le richieste ai servizi o ai bucket di backend come previsto.
Questa sezione descrive come aggiungere test a una mappa di URL già dipiattaformata. Se vuoi testare le nuove modifiche a una mappa di URL senza eseguire effettivamente il deployment della mappa, consulta Verificare la configurazione della mappa di URL.
Quando modifichi la mappa degli URL, i test vengono eseguiti e viene visualizzato un messaggio di errore se un test non va a buon fine:
Error: Invalid value for field 'urlMap.tests': ''. Test failure: Expect URL 'HOST /PATH ' to map to service 'EXPECTED_BACKEND_SERVICE ', but actually mapped to 'ACTUAL_BACKEND_SERVICE '.
L'aggiunta di test alle mappe di URL è facoltativa.
Per eseguire i test dalla console Google Cloud:
- Vai alla pagina Bilanciamento del carico.
- Fai clic sul nome di un bilanciatore del carico.
- Nella pagina Dettagli del bilanciatore del carico, fai clic su Modifica per il bilanciatore del carico selezionato.
- Fai clic su Regole di routing. Per un bilanciatore del carico delle applicazioni classico, si tratta di Regole host e percorso.
- Fai clic su Mostra test di configurazione.
- Fai clic su Aggiungi test di configurazione. Aggiungi i seguenti URL e backend di test:
- Host e percorso di test 1
example.com
e Backendwww-service.
- Host e percorso di test 2
example.net
e Backendwww-service.
- Host e percorso di test 3
example.net/web
e Backendwww-service.
- Host e percorso di test 4
example.com/videos
e Backendvideo-service.
- Host e percorso di test 5
example.com/videos/browse
e Backendvideo-service.
- Host e percorso di test 6
example.net/static
e Backendstatic-service.
- Host e percorso di test 7
example.net/static/images
e Backendstatic-service.
- Host e percorso di test 1
- Cerca il segno di spunta blu a sinistra di Regole di routing e fai clic sul pulsante Aggiorna. Per un bilanciatore del carico delle applicazioni classico, cerca la spunta blu accanto a Regole host e percorso.
Per aggiungere test alla mappa URL utilizzando Google Cloud CLI, utilizza il comando
gcloud compute url-maps edit
:
gcloud compute url-maps editURL_MAP_NAME
Viene avviato un editor di testo. Per i bilanciatori del carico delle applicazioni esterni, i test devono utilizzare il seguente formato:
tests: - host: example.com service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID /global/backendServices/www-service - host: example.net service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID /global/backendServices/www-service - host: example.com path: /videos service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID /global/backendServices/video-service - host: example.com path: /videos/browse service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID /global/backendServices/video-service - host: example.net path: /web service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID /global/backendServices/www-service - host: example.net path: /static service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID /global/backendServices/static-service - host: example.net path: /static/images service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID /global/backendServices/static-service
Tieni presente che se non specifichi un host in una regola host, gli URL di tutti gli host (sia example.com che example.net) possono corrispondere. Se hai regole host, devi creare regole che corrispondano sia a example.com sia a example.net.
Elenca mappe URL
Non puoi elencare tutte le mappe di URL nella console Google Cloud.
Per visualizzare un elenco di mappe URL utilizzando Google Cloud CLI,
utilizza il comando url-maps list
.
gcloud compute url-maps list
Ottenere informazioni su una mappa URL
Per ottenere informazioni su una mappa di URL:
- Vai alla pagina Bilanciamento del carico.
- Fai clic sul nome di un bilanciatore del carico.
- Nella pagina Dettagli del bilanciatore del carico, fai clic su Modifica per il bilanciatore del carico selezionato.
- Visualizza le Regole host e percorso.
Per ottenere informazioni su una singola mappa di URL utilizzando Google Cloud CLI,
utilizza il comando url-maps describe
.
gcloud compute url-maps describeURL_MAP_NAME
Elimina una mappa URL
Puoi eliminare una mappa di URL solo dopo aver eliminato tutti i proxy di destinazione che fanno riferimento a essa. Per ulteriori informazioni, consulta la sezione sull'eliminazione di un proxy di destinazione.
Per eliminare una mappa URL:
- Vai alla pagina Bilanciamento del carico.
- Fai clic sul nome di un bilanciatore del carico.
- Nella pagina Dettagli del bilanciatore del carico, fai clic su Modifica per il bilanciatore del carico selezionato.
- Nella pagina Dettagli del bilanciatore del carico, visualizza le Regole host e percorso.
- Fai clic sulla "X" a destra di una mappa di URL per eliminarla. La mappa URL scompare.
- Cerca il segno di spunta blu a sinistra di Regole host e percorso e fai clic sul pulsante Aggiorna.
Per eliminare una mappa di URL utilizzando Google Cloud CLI, utilizza il comando
url-maps delete
.
Prima di poter eliminare una mappa URL, è necessario eliminare tutti i proxy HTTP di destinazione che fanno riferimento alla mappa URL.
gcloud compute url-maps deleteURL_MAP_NAME [--quiet]
Eliminare un corrispettivo percorso
Per eliminare un corrispettivo percorso:
- Vai alla pagina Bilanciamento del carico.
- Fai clic sul nome di un bilanciatore del carico.
- Nella pagina Dettagli del bilanciatore del carico, fai clic su Modifica per il bilanciatore del carico selezionato.
- Seleziona Regole host e percorso.
- Nel campo Percorsi di una mappa URL esistente, fai clic sulla "x" sul nome della corrispondenza del percorso.
- Cerca il segno di spunta blu a sinistra di Regole host e percorso e fai clic sul pulsante Aggiorna.
Per eliminare un'associazione di percorsi, utilizza il comando
gcloud compute url-maps remove-path-matcher
:
gcloud compute url-maps remove-path-matcherURL_MAP_NAME \ [--path-matcher-name PATH_MATCHER]
Eliminare una regola host
Per eliminare una regola host:
- Se non ti trovi già nella pagina Regole host e percorso, vai alla pagina Bilanciamento del carico.
- Fai clic sul nome di un bilanciatore del carico.
- Nella pagina Dettagli del bilanciatore del carico, fai clic su Modifica per il bilanciatore del carico selezionato.
- Seleziona Regole host e percorso.
- Nel campo Host di una mappa di URL esistente, fai clic sulla "x" sul nome dell'host.
- Cerca il segno di spunta blu a sinistra di Regole host e percorso e fai clic sul pulsante Aggiorna.
Per eliminare una regola host dalla mappa URL, utilizza il comando
gcloud compute url-maps remove-host-rule
:
gcloud compute url-maps remove-host-ruleURL_MAP_NAME --host=HOST
Ad esempio, per rimuovere una regola host che contiene l'host altostrat.com
da
una mappa di URL denominata my-map
, esegui il seguente comando:
gcloud compute url-maps remove-host-rule my-map --host altostrat.com
Guide alla gestione del traffico
Non tutte le funzionalità della mappa degli URL sono disponibili per tutti i prodotti. Le mappe URL vengono utilizzate con i bilanciatori del carico per supportare diverse funzionalità avanzate di gestione del traffico, non tutte supportate dall'Application Load Balancer classico.
Utilizza la seguente tabella per informazioni sulle funzionalità della mappa degli URL per le operazioni di gestione.
API e riferimento all'interfaccia alla gcloud CLI
Oltre alla console Google Cloud, puoi utilizzare l'API e gcloud CLI per creare mappe di URL.
API
Per descrizioni delle proprietà e dei metodi a tua disposizione quando lavori con le mappe di URL tramite l'API REST, consulta quanto segue:
Prodotto | Documentazione dell'API |
---|---|
Application Load Balancer esterno | urlMaps |
Bilanciatore del carico delle applicazioni interno | regionUrlMaps |
Cloud Service Mesh | urlMaps |
Interfaccia a riga di comando gcloud
Per Google Cloud CLI in Google Cloud CLI, consulta quanto segue:
- Globale:
--global
- Regionale:
--region=[REGION]
Per la gestione avanzata del traffico, utilizza i file YAML e importali con il comando
gcloud compute url-maps import
.
Passaggi successivi
- Per informazioni sul funzionamento delle mappe URL, consulta la panoramica delle mappe URL.
- Per informazioni su come funzionano le mappe URL nei bilanciatori del carico delle applicazioni esterni, consulta la Panoramica del bilanciatore del carico delle applicazioni esterno.
- Consulta la Panoramica del bilanciatore del carico delle applicazioni interno per informazioni su come funzionano le mappe URL nei bilanciatori del carico delle applicazioni interni.