Utilizzo delle mappe URL

Questa guida mostra come configurare Google Cloud Mappe URL. Una mappa URL è un insieme di regole per instradare le richieste HTTP(S) in arrivo 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 la mappa URL concetti fondamentali.

Nota: questa pagina descrive come configurare un componente specifico del bilanciatore del carico o prima o dopo aver già creato un bilanciatore del carico. Utilizzo componenti specifici sono utili per le configurazioni avanzate e sono necessari opzioni di configurazione. Prima di utilizzare le informazioni di questa pagina, devi conoscere il tipo del bilanciatore del carico Google Cloud di cui hai bisogno.

Le mappe URL vengono utilizzate con i seguenti prodotti Google Cloud:

• Bilanciatore del carico delle applicazioni esterno (globale, classico e a livello di regione )
• Bilanciatore del carico delle applicazioni interno

• Cloud Service Mesh

Mappe URL utilizzate con bilanciatori del carico delle applicazioni esterni globali, Application Load Balancer esterni regionali i bilanciatori del carico delle applicazioni interni e Cloud Service Mesh supportano anche diverse funzionalità di gestione del traffico. Per ulteriori informazioni, consulta i concetti della mappa URL: Traffico avanzato dei modelli.

Impostazioni predefinite della mappa URL

Le mappe URL hanno due valori predefiniti, come descritto nella tabella che segue.

Tipo predefinito	Impostazione	Significato
Valore predefinito mappa URL	gcloud compute url-maps create --default-service | --default-backend-bucket	Viene utilizzato il servizio di backend o il bucket di backend predefinito specificato se nessuno dei matcher di percorso o delle regole host corrisponde all'URL in arrivo.
Valore predefinito dello strumento di abbinamento del percorso	gcloud compute url-maps add-path-matcher --default-service | --default-backend-bucket	Viene utilizzato il servizio di backend o il bucket di backend predefinito specificato se l'URL il percorso corrisponde a un matcher di percorso, ma nessuno dei valori specificati --path-rules corrispondenza.

Regole host

Una regola host definisce un insieme di host a cui abbinare le richieste.

In una regola host, il nome host deve essere un nome di dominio completo (FQDN). La il nome host non può essere un indirizzo IPv4 o IPv6. Ad esempio:

• Lavora: example.com
• Lavora: web.example.com
• Lavora: *.example.com
• Non funziona: 35.244.221.250

Configura le mappe URL

Una mappa URL può inviare traffico ai servizi di backend o bucket di backend. I bucket di backend non sono supportati con i bilanciatori del carico delle applicazioni esterni regionali bilanciatori del carico delle applicazioni interni.

Importante: se inizialmente hai configurato il bilanciatore del carico nelle nella console Google Cloud, il nome della mappa URL è uguale a quello del bilanciatore del carico .

Console

Per aggiungere una mappa URL utilizzando la console Google Cloud, esegui queste operazioni: passaggi:

1. Vai alla pagina Bilanciamento del carico.

   Vai a Bilanciamento del carico

2. Fai clic sul nome di un bilanciatore del carico.
3. Nella pagina Dettagli del bilanciatore del carico, fai clic su Modifica per il bilanciatore del carico selezionato.
4. Seleziona Regole host e percorso.
5. Fai clic su Aggiungi regola host e percorso.

6. Compila i campi Host, Percorsi o entrambi i campi e seleziona un servizio di backend o bucket di backend.

   1. Inserisci un Nome host completo, ad esempio web.example.com.
   2. Inserisci il percorso, ad esempio /video.
   3. Nella pagina Regole host e percorso, nel menu Backend, seleziona un servizio di backend o un bucket di backenddisponibile.
   Nota: se un servizio di backend o il bucket di backend non viene aggiunto all'host della mappa URL regole di percorso, il servizio di backend o il bucket di backend rimangono inutilizzati dal bilanciatore del carico, non lo vedrai nelle pagine Dettagli e Modifica del bilanciatore del carico.

7. Cerca il segno di spunta blu a sinistra di Regole host e percorso e fai clic sul pulsante Aggiorna.

gcloud

Per aggiungere una mappa URL utilizzando Google Cloud CLI, utilizza la Comando url-maps create:

gcloud compute url-maps create URL_MAP_NAME \
   (--default-backend-bucket=DEFAULT_BACKEND_BUCKET | --default-service=DEFAULT_SERVICE) \
   [--description DESCRIPTION] \
   [--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 URL.

Per creare un matcher di percorso, utilizza il metodo gcloud compute url-maps add-path-matcher :

gcloud compute url-maps add-path-matcher URL_MAP_NAME \
   (--default-backend-bucket=DEFAULT_BACKEND_BUCKET | --default-service=DEFAULT_SERVICE) \
   --path-matcher-name PATH_MATCHER \
   [--path-rules="PATH=SERVICE or BUCKET"]

Questo comando richiede un servizio di backend o un bucket di backend predefinito in cui può inviare richieste senza corrispondenza. Il flag --path-rules definisce le mappature tra percorsi di richiesta e servizi di backend o bucket. Nell'esempio che segue instrada i percorsi di richiesta /video/ e /video/* verso video-service di servizio di backend:

--path-rules="/video=video-service,/video/*=video-service"

Per creare una regola host, utilizza il gcloud compute url-maps add-host-rule :

gcloud compute url-maps add-host-rule URL_MAP_NAME \
    --hosts=[HOSTS] --path-matcher-name=PATH_MATCHER

Ad esempio, il seguente valore --hosts corrisponde alle richieste www.example.com e qualsiasi sottodominio di altostrat.com:

--hosts=[*.altostrat.com,www.example.com]

Per modificare il servizio o il bucket predefinito di una mappa URL, utilizza la Comando url-maps set-default-service:

gcloud compute url-maps set-default-service URL_MAP_NAME
  (--default-backend-bucket=DEFAULT_BACKEND_BUCKET
  | --default-service=DEFAULT_SERVICE)[GCLOUD_WIDE_FLAG ...]

Terraform

Per creare una mappa URL globale, utilizza la proprietà google_compute_url_map risorsa.

# url map
resource "google_compute_url_map" "default" {
  name            = "http-lb"
  default_service = google_compute_backend_bucket.default.id
}

Per creare una mappa URL a livello di regione, utilizza la proprietà google_compute_region_url_map risorsa.

resource "google_compute_region_url_map" "default" {
  name            = "regional-l7-xlb-map"
  region          = "us-west1"
  default_service = google_compute_region_backend_service.default.id
}

Convalida la configurazione della mappa URL

Nota: il comando gcloud compute url-maps validate non è supportato per il bilanciatore del carico delle applicazioni esterno regionale e il bilanciatore del carico delle applicazioni interno.

Prima di eseguire il deployment di una mappa URL, assicurati di convalidare la configurazione di una mappa URL per assicura che la mappa instrada le richieste ai backend appropriati come previsto. Puoi farlo aggiungendo test alla configurazione della mappa URL. Puoi sperimentare con diverse regole della mappa di URL ed eseguire tutti i test necessari per che la mappa instrada il traffico in modo appropriato dopo il deployment. Inoltre, se in futuro si rendessero necessarie modifiche alle regole, puoi testarle prima che saranno effettivamente pubblicati con la nuova configurazione.

Utilizza il comando gcloud compute url-maps validate per eseguire la convalida Configurazione della mappa URL. Questo comando verifica solo la configurazione fornita. Indipendentemente dal superamento o meno dei test, non vengono salvate le modifiche alla mappa URL di cui è stato eseguito il deployment. Questo comportamento è diverso da altri comandi delle mappe URL (edit, import), che eseguono gli stessi test, ma in realtà salveranno il nuovo 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 validate .

Il comando validate ti consente di testare configurazioni avanzate delle route come routing basato su intestazioni e parametri di ricerca, reindirizzamenti da HTTP a HTTPS e URL riscritture.

Console

Non puoi utilizzare la console Google Cloud per convalidare la configurazione della mappa URL. Usa invece gcloud o l'API REST.

gcloud

Per convalidare la configurazione della mappa URL utilizza il metodo gcloud compute url-maps validate .

Per il bilanciatore del carico delle applicazioni esterno globale:

gcloud compute url-maps validate --source PATH_TO_URL_MAP_CONFIG_FILE \
    --load-balancing-scheme=EXTERNAL_MANAGED \
    --global

Per il bilanciatore del carico delle applicazioni classico:

gcloud compute url-maps validate --source PATH_TO_URL_MAP_CONFIG_FILE \
    --load-balancing-scheme=EXTERNAL \
    --global

• PATH_TO_URL_MAP_CONFIG_FILE: sostituisci con un percorso al file contenente la configurazione della mappa URL per la convalida.

Convalida le modifiche alla mappa URL di un bilanciatore del carico esistente

Se hai già un bilanciatore del carico che richiede modifiche alla mappa URL, puoi testare le modifiche alla configurazione prima di renderle attive.

1. Esporta la mappa URL esistente del bilanciatore del carico in un file YAML.

   gcloud compute url-maps export URL_MAP_NAME \
      --destination PATH_TO_URL_MAP_CONFIG_FILE \
      --global
   

2. Modifica il file YAML con la nuova configurazione. Ad esempio, se vuoi modifica un bilanciatore del carico delle applicazioni esterno e invia tutte le richieste con il percorso /video a un nuovo servizio di backend chiamata video-backend-service, puoi aggiungere test alla mappa URL configurazione 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-service
    

   La configurazione della mappa URL è stata modificata con l'aggiunta di un matcher del percorso e di test per entrambi il valore predefinito web-backend-service e il nuovo video-backend-service di servizio di backend:

    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-service
   

3. Convalida la nuova configurazione.

   gcloud compute url-maps validate --source PATH_TO_URL_MAP_CONFIG_FILE
   

   Se tutti i test hanno esito positivo, dovrebbe essere visualizzato 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 hanno esito positivo, viene visualizzato un messaggio di errore. Apporta le correzioni necessarie a il file di configurazione della mappa URL e prova a eseguire di nuovo 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'.
   

4. Se sai che la nuova configurazione funziona e non influisce sul tuo configurazione esistente, puoi importarla nella mappa URL. Tieni presente che questo passaggio il deployment della mappa URL con la nuova configurazione.

   gcloud compute url-maps import URL_MAP_NAME \
      --source PATH_TO_URL_MAP_CONFIG_FILE \
      --global
   

Aggiungere test a una mappa URL

Nota: l'aggiunta di test alle mappe URL non è supportata per il il bilanciatore del carico delle applicazioni esterno regionale e il bilanciatore del carico delle applicazioni interno.

Puoi aggiungere test di configurazione a una mappa URL per assicurarti che i percorsi della mappa degli URL le richieste ai servizi o ai bucket di backend come previsto.

Questa sezione descrive come aggiungere test a una mappa URL che è già stata di cui è stato eseguito il deployment. Se vuoi testare le nuove modifiche a una mappa URL senza effettivamente per eseguire il deployment della mappa, consulta la sezione Convalidare la configurazione della mappa URL.

Quando modifichi la mappa URL, i test vengono eseguiti e viene visualizzato un messaggio di errore se il test ha esito negativo:

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 URL è facoltativa.

Console

Per eseguire test dalla console Google Cloud:

1. Vai alla pagina Bilanciamento del carico.

   Vai a Bilanciamento del carico

2. Fai clic sul nome di un bilanciatore del carico.
3. Nella pagina Dettagli del bilanciatore del carico, fai clic su Modifica per il bilanciatore del carico selezionato.
4. Fai clic su Regole di routing. Per un bilanciatore del carico delle applicazioni classico, Regole host e percorso.
5. Fai clic su Mostra test di configurazione.
6. Fai clic su Aggiungi test di configurazione. Aggiungi i seguenti URL di test e backend:
   • Host di test e percorso 1 example.com e backend www-service.
   • Host di test e percorso 2 example.net e backend www-service.
   • Host di test e percorso 3 example.net/web e backend www-service.
   • Host di test e percorso 4 example.com/videos e backend video-service.
   • Host di test e percorso 5 example.com/videos/browse e backend video-service.
   • Host di test e percorso 6 example.net/static e backend static-service.
   • Host di test e percorso 7 example.net/static/images e backend static-service.
7. Cerca il segno di spunta blu a sinistra di Regole di routing. fai clic sul pulsante Aggiorna. Per un bilanciatore del carico delle applicazioni classico, cerca il segno di spunta blu accanto a Regole host e percorso.

gcloud

Per aggiungere test alla mappa URL utilizzando Google Cloud CLI, utilizza la gcloud compute url-maps edit :

gcloud compute url-maps edit URL_MAP_NAME

Viene avviato un editor di testo. Per i bilanciatori del carico delle applicazioni esterni, i test devono utilizzare nel 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 corrispondono sia a example.com che a example.net.

Elenca mappe URL

Console

Non puoi elencare tutte le mappe URL nella console Google Cloud.

gcloud

Per visualizzare un elenco di mappe URL utilizzando Google Cloud CLI: utilizza la url-maps list .

gcloud compute url-maps list

Ricevere informazioni su una mappa URL

Console

Per ottenere informazioni su una mappa URL, procedi nel seguente modo:

1. Vai alla pagina Bilanciamento del carico.

   Vai a Bilanciamento del carico

2. Fai clic sul nome di un bilanciatore del carico.
3. Nella pagina Dettagli del bilanciatore del carico, fai clic su Modifica per il bilanciatore del carico selezionato.
4. Visualizza le regole host e percorso.

gcloud

Per ottenere informazioni su una singola mappa URL utilizzando Google Cloud CLI, utilizza la url-maps describe .

gcloud compute url-maps describe URL_MAP_NAME

Elimina una mappa URL

Puoi eliminare una mappa URL solo dopo aver eliminato tutti i proxy di destinazione che vi fanno riferimento. Per ulteriori informazioni, consulta la sezione Eliminazione di una destinazione proxy.

Console

Per eliminare una mappa URL:

1. Vai alla pagina Bilanciamento del carico.

   Vai a Bilanciamento del carico

2. Fai clic sul nome di un bilanciatore del carico.
3. Nella pagina Dettagli del bilanciatore del carico, fai clic su Modifica per il bilanciatore del carico selezionato.
4. Nella pagina Dettagli del bilanciatore del carico, visualizza le regole host e percorso.
5. Fai clic sulla "X" a destra di una mappa URL per eliminarla. La mappa URL scompare.
6. Cerca il segno di spunta blu a sinistra di Regole host e percorso e fai clic sul pulsante Aggiorna.

gcloud

Per eliminare una mappa URL utilizzando Google Cloud CLI, utilizza la Comando url-maps delete. Prima di poter eliminare una mappa di URL, tutti i proxy HTTP di destinazione che fanno riferimento La mappa URL deve prima essere eliminata.

gcloud compute url-maps delete URL_MAP_NAME [--quiet]

Elimina un matcher percorso

Console

Per eliminare un matcher percorso:

1. Vai alla pagina Bilanciamento del carico.

   Vai a Bilanciamento del carico

2. Fai clic sul nome di un bilanciatore del carico.
3. Nella pagina Dettagli del bilanciatore del carico, fai clic su Modifica per il bilanciatore del carico selezionato.
4. Seleziona Regole host e percorso.
5. Nel campo Percorsi di una mappa URL esistente, fai clic sulla "x" attivo il nome del matcher di percorso.
6. Cerca il segno di spunta blu a sinistra di Regole host e percorso e fai clic sul pulsante Aggiorna.

gcloud

Per eliminare un matcher percorso, utilizza gcloud compute url-maps remove-path-matcher :

gcloud compute url-maps remove-path-matcher URL_MAP_NAME \
   [--path-matcher-name PATH_MATCHER]

Elimina una regola host

Console

Per eliminare una regola host:

1. Se non sei già nella pagina Regole host e percorso, vai alla Pagina Bilanciamento del carico.

   Vai a Bilanciamento del carico

2. Fai clic sul nome di un bilanciatore del carico.
3. Nella pagina Dettagli del bilanciatore del carico, fai clic su Modifica per il bilanciatore del carico selezionato.
4. Seleziona Regole host e percorso.
5. Nel campo Host per una mappa URL esistente, fai clic sulla "x" il nome dell'host.
6. Cerca il segno di spunta blu a sinistra di Regole host e percorso e fai clic sul pulsante Aggiorna.

gcloud

Per eliminare una regola host dalla mappa URL, utilizza la gcloud compute url-maps remove-host-rule :

gcloud compute url-maps remove-host-rule URL_MAP_NAME --host=HOST

Ad esempio, per rimuovere una regola host che contiene l'host altostrat.com da una mappa URL denominata my-map, devi eseguire il comando seguente:

gcloud compute url-maps remove-host-rule my-map --host altostrat.com

Guide alla gestione del traffico

Non tutte le funzionalità delle mappe URL sono disponibili per tutti i prodotti. Le mappe URL vengono utilizzate con bilanciatori del carico per supportare diverse funzionalità avanzate di gestione del traffico, non tutte supportati dal bilanciatore del carico delle applicazioni classico.

Utilizza la seguente tabella per scoprire le funzionalità della mappa URL per di Google Cloud.

Prodotto	Funzionalità delle mappe degli URL e guide alla gestione del traffico
Bilanciatore del carico delle applicazioni esterno globale	Caricamento funzionalità del bilanciatore: routing e gestione del traffico Traffico panoramica sulla gestione Impostazione gestione del traffico Configurare un reindirizzamento URL Configurare un reindirizzamento da HTTP a HTTPS Nome host e percorso Richieste di routing Cookie
Bilanciatore del carico delle applicazioni classico	Caricamento funzionalità del bilanciatore: routing e gestione del traffico Gestione del traffico panoramica Configurare un reindirizzamento URL Configurare un reindirizzamento da HTTP a HTTPS Nome host e percorso Routing basato su parametri di query e intestazioni
Bilanciatore del carico delle applicazioni esterno regionale	Caricamento funzionalità del bilanciatore: routing e gestione del traffico Traffico panoramica sulla gestione Impostazione gestione del traffico Configurare un reindirizzamento URL Configurare un reindirizzamento da HTTP a HTTPS Nome host e percorso Richieste di routing Cookie
Bilanciatore del carico delle applicazioni interno	Caricamento funzionalità del bilanciatore: routing e gestione del traffico Traffico panoramica sulla gestione Impostazione gestione del traffico Configurare i reindirizzamenti URL Configurare i reindirizzamenti da HTTP a HTTPS Cookie Nome host e percorso
Cloud Service Mesh	Cloud Service Mesh funzionalità: routing e gestione del traffico Livello avanzato panoramica della gestione del traffico Configurazione gestione avanzata del traffico

Riferimento per API e gcloud CLI

Oltre alla console Google Cloud, puoi utilizzare l'API e gcloud CLI per creare le mappe URL.

API

Per le descrizioni delle proprietà e dei metodi a tua disposizione quando lavori. con le mappe 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

Nota: nell'API Mappa URL, HttpRouteRuleMatch indica un'istanza di pathMatchers[].routeRules[].matchRules[].

Interfaccia a riga di comando gcloud

Per Google Cloud CLI in Google Cloud CLI, consulta quanto segue:

• gcloud compute url-maps

• A livello mondiale: --global

• Regionale: --region=[REGION]

Per la gestione avanzata del traffico, utilizza i file YAML e importali con gcloud compute url-maps import .

Passaggi successivi

• Consulta la Panoramica delle mappe URL per informazioni sul funzionamento delle mappe URL.
• Per informazioni su come, consulta la panoramica del bilanciatore del carico delle applicazioni esterno Le mappe URL funzionano nei bilanciatori del carico delle applicazioni esterni.
• Consulta la panoramica del bilanciatore del carico delle applicazioni interno per informazioni su come Le mappe URL funzionano nei bilanciatori del carico delle applicazioni interni.