Utilizzo delle mappe URL

Questa guida mostra come configurare le mappe degli URL. Trusted CloudUna mappa URL è un insieme di regole per instradare le richieste HTTP(S) in entrata a servizi di backend specifici. Una mappa URL minima corrisponde a tutti i percorsi delle richieste in entrata (/*).

Prima di seguire questa guida, acquisisci familiarità con i concetti relativi alla mappa degli URL.

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

Le mappe URL utilizzate con i bilanciatori del carico delle applicazioni esterni regionali e i bilanciatori del carico delle applicazioni interni regionali supportano anche diverse funzionalità di gestione avanzata del traffico. Per saperne di più, consulta Concetti relativi alla mappa degli 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

--default-service

 Il servizio di backend predefinito specificato viene utilizzato se nessuno dei matcher di percorso o delle regole host corrisponde all'URL in entrata.
Matcher percorso predefinito gcloud compute url-maps add-path-matcher

--default-service

 Il servizio di backend predefinito specificato viene utilizzato se il percorso dell'URL corrisponde a un matcher di percorso, ma nessuna delle --path-rules specificate corrisponde.

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). 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 backend.

Console

Per aggiungere una mappa URL utilizzando la console Trusted Cloud , segui questi 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 il campo Host, il campo Percorsi o entrambi e seleziona un servizio di backend.

    1. Inserisci un Nome host completo, ad esempio web.example.com.
    2. Inserisci il percorso, ad esempio /video.
    3. Nella pagina Regole di host e percorso, nel menu Backend, seleziona un servizio di backenddisponibile.

  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 il comando url-maps create:

gcloud compute url-maps create URL_MAP_NAME \
   (--default-service=DEFAULT_SERVICE) \
   [--description DESCRIPTION] \
   [--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 comando gcloud compute url-maps add-path-matcher:

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

Questo comando richiede un servizio di backend predefinito a cui può inviare le richieste senza corrispondenza. Il flag --path-rules definisce i mapping tra i percorsi delle richieste e i servizi di backend. L'esempio seguente instrada i percorsi delle richieste /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-rule URL_MAP_NAME \
    --hosts=[HOSTS] --path-matcher-name=PATH_MATCHER

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

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

Per modificare il servizio predefinito di una mappa URL, utilizza il comando url-maps set-default-service:

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

Terraform

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

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

Elenca mappe URL

Console

Non puoi elencare tutte le tue mappature degli URL nella Trusted Cloud console.

gcloud

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

Console

Per ottenere informazioni su una mappa degli 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. Visualizza le regole host e percorso.

gcloud

Per ottenere informazioni su una singola mappa URL utilizzando Google Cloud CLI, utilizza il comando 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 la fanno riferimento. Per saperne di più, consulta la sezione Eliminazione di un proxy di destinazione.

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 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 delete URL_MAP_NAME [--quiet]

Elimina un matcher di percorso

Console

Per eliminare un matcher di 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 mappatura degli URL esistente, fai clic sulla "x" sul 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 di percorso, utilizza il comando 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 ti trovi 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 mappatura URL esistente, fai clic sulla "x" accanto al 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 il comando 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, 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.

Utilizza la seguente tabella per scoprire le funzionalità della mappa degli URL per la gestione delle opere.

Prodotto Funzionalità della mappa degli URL e guide alla gestione del traffico
Bilanciatore del carico delle applicazioni esterno regionale Funzionalità del bilanciatore del carico: routing e gestione del traffico

Panoramica della gestione del traffico

Configurazione della gestione del traffico

Configurazione di un reindirizzamento URL

Configurazione del reindirizzamento da HTTP a HTTPS

Nome host e percorso

Richieste di routing

Cookie
Bilanciatore del carico delle applicazioni interno Funzionalità del bilanciatore del carico: routing e gestione del traffico

Panoramica della gestione del traffico

Configurazione della gestione del traffico

Configurazione dei reindirizzamenti URL

Configurazione dei reindirizzamenti da HTTP a HTTPS

Cookie

Nome host e percorso

API e riferimento per gcloud CLI

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

API

Per le descrizioni delle proprietà e dei metodi disponibili 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

Interfaccia a riga di comando gcloud

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

  • 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