Utilizzo delle route

Questa pagina descrive come creare e gestire le route per le reti Virtual Private Cloud (VPC) in Google Cloud. Questa pagina presuppone che tu abbia familiarità con i diversi tipi di route Google Cloud e le loro caratteristiche, come descritto in Route.

Ogni nuova rete include due tipi di route generate dal sistema: una route predefinita, che puoi rimuovere o sostituire, e una route subnet per ciascuna delle subnet. Non puoi rimuovere una route di subnet a meno che non elimini la subnet corrispondente stessa.

Oltre alle route generate dal sistema, puoi creare altre route statiche personalizzate.

Elenca route per una rete VPC

Puoi utilizzare Google Cloud CLI o l'API per elencare e visualizzare i dettagli dei seguenti tipi di route:

Né i comandi dell'interfaccia a riga di comando gcloud CLI né i metodi dell'API mostrano i seguenti tipi di route:

Per vedere la visualizzazione completa del percorso, utilizza la console Google Cloud. Per elencare e descrivere le route basate su criteri, consulta Utilizzare le route basate su criteri.

Console

Nella console Google Cloud, vai alla pagina Route.

Vai a Routes
Nella scheda Route operative, segui questi passaggi:
- Scegli una rete VPC.
- Scegli una regione.
Fai clic su Visualizza.
Puoi filtrare in base al tipo di route, all'intervallo IP di destinazione, al tipo di hop successivo e altro ancora.

gcloud

Utilizza i seguenti comandi gcloud CLI per elencare e visualizzare i dettagli delle route elencate in precedenza:

gcloud compute routes list \
    --filter="network=NETWORK_NAME" \
    --project=PROJECT_ID

gcloud compute routes describe ROUTE_NAME \
    --format="flattened()" \
    --project=PROJECT_ID

Sostituisci quanto segue:

NETWORK_NAME: il nome della rete VPC.
PROJECT_ID: l'ID progetto che contiene la rete VPC.
ROUTE_NAME: il nome del percorso.

API

Utilizza i seguenti metodi API per elencare e visualizzare i dettagli delle route elencate in precedenza:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/routes?filter=network="NETWORK_URL

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/routes/ROUTE_NAME

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto che contiene la rete VPC.
NETWORK_URL: l'URL della rete VPC.
ROUTE_NAME: il nome del percorso.

Per ulteriori informazioni, consulta il metodo routes.list e il metodo routes.get.

Elenca le route applicabili per un'interfaccia di rete VM

Puoi utilizzare la console Google Cloud per visualizzare le route applicabili per l'interfaccia di rete di una VM. Questa visualizzazione restringe l'elenco delle route che puoi utilizzare per il traffico in uscita.

Per visualizzare le route applicabili per un'interfaccia di rete specifica di una VM, segui questi passaggi.

Console

Nella console Google Cloud, vai alla pagina Istanze VM.

Vai a Istanze VM
Individua un'istanza VM nell'elenco. Nel menu Altre azioni alla fine della riga, seleziona Visualizza dettagli rete.
Se un'istanza ha più interfacce di rete, nella sezione Dettagli interfaccia di rete, seleziona l'interfaccia di rete che vuoi visualizzare.
Nella sezione Dettagli firewall e route, fai clic sulla scheda Route per visualizzare tutte le route che si applicano all'interfaccia di rete, ordinate per nome.

Aggiungi e rimuovi route statiche

Puoi aggiungere o rimuovere route statiche e basate su criteri locali per la tua rete VPC. Questa sezione descrive come aggiungere ed eliminare le route statiche locali. Per maggiori informazioni su come aggiungere e rimuovere route basate su criteri, consulta Utilizzare le route basate su criteri.

Le route di subnet vengono aggiunte ed eliminate automaticamente quando aggiungi o elimini una subnet. Per ulteriori informazioni su come aggiungere e rimuovere le subnet, consulta Utilizzare le subnet.

Tutte le route in una rete VPC connesse dal peering di rete VPC devono essere manipolate nella rete VPC che esporta le route. Per maggiori informazioni, consulta Opzioni di scambio di route.

Prima di aggiungere una route statica

Prima di aggiungere una route statica, assicurati di comprendere quanto segue:

Assicurati di comprendere i diversi tipi di hop successivi che possono essere utilizzati dalle route statiche. Per informazioni sui diversi tipi di hop successivi delle route statiche, inclusi quelli che supportano le destinazioni IPv6, consulta Hop e funzionalità successivi.
A meno che non utilizzi subnet ibride, una route statica non può avere un intervallo di destinazione corrispondente o più specifico dell'intervallo di destinazione di una route di subnet o di peering di subnet. Per maggiori dettagli, consulta Interazioni con le route statiche personalizzate nella panoramica delle route e Interazioni con le route statiche e delle subnet nella documentazione relativa al peering di rete VPC.
Per evitare conflitti quando utilizzi una rete in modalità automatica, non creare route statiche le cui destinazioni rientrano in 10.128.0.0/9. Per maggiori dettagli, esamina gli intervalli IP riservati per le reti in modalità automatica.
Le destinazioni per le route statiche personalizzate non possono sovrapporsi a nessun intervallo allocato interno.
Assicurati di conoscere le istanze come hop successivi prima di creare una route statica personalizzata che utilizzi una VM come hop successivo. Google Cloud verifica l'esistenza di una VM solo al momento della creazione della route, se scegli un'istanza dell'hop successivo.
Se crei una route utilizzando un tag di rete, solo le VM con quel tag ricevono quella route. Tuttavia, le VM con tag ricevono comunque tutte le route che non hanno tag di rete.

Aggiungi una route statica

Aggiungi una route statica a una rete. Per saperne di più sui diversi tipi di hop successivi statici, inclusi quelli che supportano le destinazioni IPv6, consulta Hop e funzionalità successivi.

Console

Nella console Google Cloud, vai alla pagina Route.

Vai a Routes
Fai clic sulla scheda Gestione route.
Fai clic su Crea route.
Specifica un nome e una descrizione per il percorso.
Nell'elenco Rete, seleziona una rete esistente per la route.
Nell'elenco Tipo di route, seleziona Route statica.
Nell'elenco Versione IP, seleziona la versione IP richiesta:
- Per creare una route statica IPv4, seleziona IPv4.
- Per creare una route statica IPv6, seleziona IPv6.
Specifica un intervallo IP di destinazione. La destinazione più ampia possibile è 0.0.0.0/0 per IPv4 o ::/0 per IPv6.
Specifica una priorità per il percorso. La priorità può essere compresa tra 0 (la priorità più alta) e 65535 (la priorità più bassa).
Per rendere la route applicabile solo a determinate istanze con tag di rete corrispondenti, specificale nel campo Tag istanza. Lascia vuoto il campo per rendere la route applicabile a tutte le istanze nella rete.
Seleziona un hop successivo per il percorso:
- Gateway internet predefinito: fornisce i pacchetti a internet e alle API e ai servizi Google
- Specifica un'istanza: consegna i pacchetti all'interfaccia di rete di un'istanza VM. Specifica l'istanza VM per nome e zona. Se la destinazione della route è un indirizzo IPv6, l'istanza VM deve essere a doppio stack.
- Specifica l'indirizzo IP di un'istanza: specifica l'indirizzo IPv4 interno principale di un'istanza esistente nella rete VPC.
- Specifica VPN: consegna i pacchetti a un tunnel VPN classica esistente utilizzando il routing statico.
- Specifica il nome di una regola di forwarding o un indirizzo IP di un bilanciatore del carico di rete passthrough interno: consegna i pacchetti a un bilanciatore del carico di rete passthrough interno specificato dal nome della regola di forwarding interno (o indirizzo IPv4) e dalla regione.
Fai clic su Crea.

gcloud

Crea una nuova route statica personalizzata con il seguente comando gcloud CLI:

gcloud compute routes create ROUTE_NAME \
    --network=NETWORK \
    --destination-range=DESTINATION_RANGE \
    --priority=PRIORITY \
    NEXT_HOP_SPECIFICATION

Sostituisci quanto segue:

ROUTE_NAME: il nome del percorso
NETWORK: il nome della rete VPC che contiene la route
DESTINATION_RANGE: gli indirizzi IPv4 o IPv6 di destinazione a cui si applica la route. La destinazione più ampia possibile è 0.0.0.0/0 per IPv4 o ::/0 per IPv6.
PRIORITY: la priorità della route, che può essere compresa tra 0 (la priorità più alta) e 65535 (la priorità più bassa)
NEXT_HOP_SPECIFICATION: l'hop successivo per la route statica. Utilizza uno dei seguenti parametri o una combinazione di parametri:
- --next-hop-gateway=default-internet-gateway: consegna di pacchetti a internet e alle API e ai servizi Google.
- --next-hop-instance=INSTANCE_NAME e --next-hop-instance-zone=ZONE: consegna pacchetti all'interfaccia di rete di un'istanza VM esistente. Specifica l'istanza VM per nome e zona. Se la destinazione della route è un indirizzo IPv6, l'istanza VM deve essere dual-stack.
- --next-hop-address=ADDRESS: specifica l'indirizzo IPv4 principale di un'istanza esistente nella rete VPC.
- --next-hop-vpn-tunnel=VPN_TUNNEL_NAME e --next-hop-vpn-tunnel-region=REGION: consegna pacchetti a un tunnel VPN classica esistente utilizzando il routing statico.
- --next-hop-ilb=FORWARDING_RULE e --next-hop-ilb-region=REGION: consegna i pacchetti a un bilanciatore del carico di rete passthrough interno. Specifica l'istanza VM in base al nome della regola di forwarding interno (o indirizzo IPv4) e alla regione.
Per fare in modo che la route statica personalizzata si applichi solo a determinate VM in base al tag di rete, aggiungi il flag --tags e specifica uno o più tag di rete. Per ulteriori informazioni sull'interazione tra i tag di rete e le route statiche personalizzate, consulta Route applicabili nella panoramica delle route. Puoi utilizzare i tag con qualsiasi route statica personalizzata.

Per ulteriori informazioni sulla sintassi dell'interfaccia alla gcloud CLI, consulta la documentazione dell'SDK.

API

Crea una nuova route statica personalizzata.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/routes
{
  "name": "ROUTE_NAME",
  "network": "NETWORK_NAME",
  "destRange": "DESTINATION_RANGE",
  "priority": PRIORITY,
  "NEXT_HOP_SPECIFICATION"
}

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui viene creata la route
ROUTE_NAME: il nome del percorso
NETWORK: il nome della rete VPC che contiene la route.
DESTINATION_RANGE: l'intervallo di indirizzi IPv4 o IPv6 di destinazione a cui si applica la route. La destinazione più ampia possibile è 0.0.0.0/0 per IPv4 o ::/0 per IPv6.
PRIORITY: la priorità della route, che può essere compresa tra 0 (la priorità più alta) e 65535 (la priorità più bassa)
NEXT_HOP_SPECIFICATION: l'hop successivo per la route statica. Utilizza uno dei seguenti parametri o una combinazione di parametri:
- nextHopGateway: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/gateways/default-internet-gateway: carica i pacchetti su internet e alle API e ai servizi Google
- nextHopInstance: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME: consegna i pacchetti nell'interfaccia di rete di un'istanza VM. Specifica l'istanza VM per nome e zona. Se la destinazione della route è un indirizzo IPv6, l'istanza VM deve essere dual-stack.
- nextHopIp: ADDRESS: specifica l'indirizzo IPv4 principale di un'istanza esistente nella rete VPC.
- nextHopVpnTunnel: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/vpnTunnels/VPN_TUNNEL_NAME: consegna i pacchetti in un tunnel VPN classica esistente utilizzando il routing statico.
- nextHopIlb: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE: consegna i pacchetti a un bilanciatore del carico di rete passthrough interno. Specifica l'istanza VM in base al nome della regola di forwarding interno (o indirizzo IPv4) e alla regione.

Per fare in modo che la route statica personalizzata si applichi solo a determinate VM in base al tag di rete, aggiungi il campo tags e specifica uno o più tag di rete. Per ulteriori informazioni sull'interazione tra i tag di rete e le route statiche personalizzate, consulta Route applicabili nella panoramica delle route. Puoi utilizzare i tag con qualsiasi route statica personalizzata.

Per saperne di più, consulta il metodo routes.insert.

Terraform

Puoi creare una route statica utilizzando un modulo Terraform.

Questa route statica crea una route predefinita verso internet.

module "google_compute_route" {
  source       = "terraform-google-modules/network/google//modules/routes"
  version      = "~> 9.0"
  project_id   = var.project_id # Replace this with your project ID in quotes
  network_name = "default"

  routes = [
    {
      name              = "egress-internet"
      description       = "route through IGW to access internet"
      destination_range = "0.0.0.0/0"
      tags              = "egress-inet"
      next_hop_internet = "true"
    }
  ]
}

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Aggiungi una route predefinita IPv4

La route statica predefinita IPv4 (0.0.0.0/0) con next-hop-gateway impostato su default-internet-gateway viene configurata automaticamente per ogni rete VPC. Segui questi passaggi per ricreare questa route, se necessario.

Console

Nella console Google Cloud, vai alla pagina Route.

Vai a Routes
Fai clic sulla scheda Gestione route.
Fai clic su Crea route.
Specifica un nome e una descrizione per il percorso.
Seleziona una rete esistente per il percorso.
In Intervallo IP di destinazione, inserisci 0.0.0.0/0.
Specifica una priorità per la route. La priorità può essere compresa tra 0 (la priorità più elevata) e 65535 (la priorità più bassa).
Per Hop successivo, seleziona Gateway internet predefinito.
Fai clic su Crea.

gcloud

Ricrea la route predefinita IPv4 per una rete.

gcloud compute routes create ROUTE_NAME \
    --destination-range=0.0.0.0/0 \
    --network=NETWORK \
    --next-hop-gateway=default-internet-gateway

Sostituisci quanto segue:

ROUTE_NAME: un nome per il percorso
NETWORK: il nome della rete VPC che contiene la route

API

Ricrea la route predefinita IPv4 per una rete.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/routes
{
  "destRange": "0.0.0.0/0",
  "name": "ROUTE_NAME",
  "network": "NETWORK_NAME",
  "nextHopGateway": "projects/PROJECT_ID/global/gateways/default-internet-gateway"
}

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui viene creata la route
ROUTE_NAME: un nome per il percorso
NETWORK_NAME: il nome della rete VPC che contiene la route

Aggiungi una route predefinita IPv6

La route statica predefinita IPv6 (::/0) con next-hop-gateway impostato su default-internet-gateway viene configurata automaticamente per la rete VPC quando crei una subnet a doppio stack con il tipo di accesso IP esterno. Puoi eliminare la route per bloccare tutto il traffico IPv6 dalle VM a internet. Se necessario, puoi anche ricreare la route.

Console

Nella console Google Cloud, vai alla pagina Route.

Vai a Routes
Fai clic sulla scheda Gestione route.
Fai clic su Crea route.
Specifica un nome e una descrizione per il percorso.
Seleziona una rete esistente per il percorso.
In Intervallo IP di destinazione, inserisci ::/0.
Specifica una priorità per il percorso. La priorità può essere compresa tra 0 (la priorità più alta) e 65535 (la priorità più bassa).
Per Hop successivo, seleziona Gateway internet predefinito.
Fai clic su Crea.

gcloud

Ricrea la route predefinita IPv6 per una rete.

gcloud compute routes create ROUTE_NAME \
    --destination-range=::/0 \
    --network=NETWORK \
    --next-hop-gateway=default-internet-gateway

Sostituisci quanto segue:

ROUTE_NAME: un nome per il percorso.
NETWORK: il nome della rete VPC che contiene la route.

API

Ricrea la route predefinita IPv6 per una rete.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/routes
{
  "destRange": "::/0",
  "name": "ROUTE_NAME",
  "network": "NETWORK_NAME",
  "nextHopGateway": "projects/PROJECT_ID/global/gateways/default-internet-gateway"
}

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui viene creata la route
ROUTE_NAME: un nome per il percorso
NETWORK_NAME: il nome della rete VPC che contiene la route

Modifica una route statica

Non puoi modificare o aggiornare una route statica dopo averla creata. Per modificare una route statica, devi eliminarla e crearne una sostitutiva.

Elimina una route statica

Per eliminare una route:

Console

Nella console Google Cloud, vai alla pagina Route.

Vai a Routes
Fai clic sulla scheda Gestione route.
Seleziona la casella di controllo accanto alla regola da eliminare.
Fai clic su Elimina.
Fai di nuovo clic su Elimina per confermare.

gcloud

Elimina una route statica personalizzata utilizzando il seguente comando gcloud CLI:

gcloud compute routes delete ROUTE_NAME

Sostituisci ROUTE_NAME con il nome della route che vuoi eliminare.

API

Elimina una route statica personalizzata per rimuoverla dalla rete VPC utilizzando il metodo routes.delete:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/routes/ROUTE_NAME

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui si trova il percorso.
ROUTE_NAME: il nome della route da eliminare.

Propagazione delle modifiche al percorso

Quando aggiungi o elimini una route statica, questa si propaga a tutte le regioni e alle istanze VM nella tua rete VPC. Uno stato dell'operazione di route PENDING o RUNNING indica che la modifica della route è in coda.

Dopo la coda, lo stato dell'operazione di routing diventa DONE. Potrebbero essere necessari altri 30 secondi prima che tutte le istanze VM nella rete VPC e nelle reti di peering di rete VPC utilizzino una nuova route o smettano di utilizzare una route precedente.

Se aggiungi o rimuovi contemporaneamente più route statiche, le modifiche possono essere applicate in qualsiasi ordine. Non vi è alcuna garanzia che l'ordine in cui invii le modifiche al percorso sia l'ordine in cui vengono elaborate. Istanze diverse potrebbero venire a conoscenza delle modifiche in momenti diversi.

Se devi apportare modifiche al percorso che dipendono l'una dall'altra, devi apportare tali modifiche in sequenza eseguendo le modifiche successive solo dopo che lo stato della modifica precedente è DONE e sono trascorsi altri 30 secondi.

Abilita IP forwarding per le istanze

Per impostazione predefinita, l'inoltro IP è disabilitato e Google Cloud esegue un rigoroso controllo degli indirizzi di origine. In base all'effettiva configurazione del firewall in uscita, una VM può emettere pacchetti con le seguenti origini:

L'indirizzo IPv4 interno principale dell'interfaccia di rete (NIC) di un'istanza.
Qualsiasi intervallo IP alias configurato sul NIC di un'istanza.
Se sulla subnet è configurato un intervallo di indirizzi IPv6 e l'istanza è a doppio stack, qualsiasi indirizzo IPv6 assegnato al NIC.
Un indirizzo IP interno o esterno associato a una regola di forwarding, per il bilanciamento del carico passthrough o il forwarding del protocollo, se l'istanza è un backend per un bilanciatore del carico di rete passthrough interno, un bilanciatore del carico di rete passthrough esterno oppure vi fa riferimento da un'istanza di destinazione.

Per utilizzare una VM come hop successivo per una route, la VM deve inoltrare i pacchetti le cui origini non corrispondono a uno degli indirizzi o degli intervalli IP nell'elenco precedente. Per inoltrare i pacchetti con indirizzi di origine arbitrari, devi abilitare l'inoltro IP:

Quando crei o aggiorni una VM, attivi l'inoltro IP seguendo le istruzioni riportate in questa sezione. L'abilitazione dell'inoltro IP si applica a tutte le NIC sulla VM.
Oltre a seguire i passaggi descritti in questa sezione, devi abilitare l'inoltro IP all'interno del sistema operativo guest della VM. Per farlo su Linux, imposta il valore di uno o di entrambi i seguenti parametri del kernel su 1: net.ipv4.ip_forward (per IPv4) o net.ipv6.conf.all.forwarding (per IPv6).

Per abilitare l'inoltro IP quando crei una VM, completa i seguenti passaggi.

Console

Nella console Google Cloud, vai alla pagina Istanze VM.

Vai a Istanze VM
Fai clic su Crea istanza.
Nella sezione Opzioni avanzate, espandi Networking, dischi, sicurezza, gestione, single-tenancy.
Espandi la sezione Networking.
Nella sezione Inoltro IP, seleziona la casella di controllo Abilita.

gcloud

Quando crei un'istanza, aggiungi il flag --can-ip-forward al comando:

gcloud compute instances create ... --can-ip-forward

API

Quando crei un'istanza, utilizza il campo canIpForward per abilitare l'inoltro IP:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "canIpForward": true,
  ...other fields
}

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto che contiene l'istanza
ZONE: la zona Google Cloud contenente l'istanza

Per ulteriori informazioni, consulta il metodo instances.insert.

Terraform

Puoi utilizzare la risorsa Terraform per creare un'istanza VM in cui è abilitato l'IP forwarding.

In questo esempio, agli argomenti Terraform sono stati assegnati valori che puoi modificare.

resource "google_compute_instance" "default" {
  project      = var.project_id # Replace this with your project ID in quotes
  zone         = "southamerica-east1-b"
  name         = "instance-next-hop"
  machine_type = "e2-medium"
  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-9"
    }
  }
  network_interface {
    network = "default"
  }
  can_ip_forward = true
}

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Dopo aver abilitato l'inoltro IP, continua con il processo di creazione della VM.

Per abilitare l'inoltro IP su una VM esistente, aggiorna la proprietà dell'istanza canIpForward.

Passaggi successivi

Per informazioni sulle route, vedi Route.
Per informazioni sulle reti VPC di Google Cloud, consulta la panoramica su Virtual Private Cloud (VPC).
Per istruzioni sulla creazione e sulla modifica delle reti VPC, consulta Creazione e gestione delle reti VPC.