Annuncio di intervalli di indirizzi personalizzati

Utilizza la modalità annuncio personalizzato in un router Cloud o in una sessione BGP (Border Gateway Protocol) su un router Cloud per annunciare intervalli di indirizzi IP diversi dagli intervalli di indirizzi IP delle subnet della rete VPC (Virtual Private Cloud). Ad esempio, puoi annunciare intervalli di indirizzi IP esterni, intervalli di indirizzi IP interni arbitrari o indirizzi IP interni da intervalli di indirizzi IP di altre reti VPC connesse alla tua rete VPC. La tua rete VPC potrebbe essere connessa tramite il peering di rete VPC o gli spoke VPC in Network Connectivity Center.

Quando un router Cloud è configurato per utilizzare la modalità annuncio predefinita, annuncia solo le route per le subnet che fanno parte della stessa rete VPC del router Cloud. In questa modalità, il router Cloud esclude tutte le route statiche e le route apprese dinamicamente da altre reti VPC, ad esempio le route apprese dal peering di rete VPC o dagli spoke VPC in NCC.

Attenzione: puoi specificare route annunciate personalizzate su un router Cloud e su una sessione BGP. Le route annunciate personalizzate sul router Cloud si applicano a tutte le sessioni BGP. Tuttavia, se specifichi una route annunciata personalizzata su una sessione BGP, tutte le route annunciate del router Cloud vengono ignorate e sostituite dalla route annunciata personalizzata della sessione BGP.

Per specificare route annunciate personalizzate quando crei un router Cloud o configuri una sessione BGP, consulta Creare router Cloud o Stabilire sessioni BGP.

Prima di iniziare

gcloud

Se vuoi utilizzare gli esempi di riga di comando in questa guida:

1. Installa o esegui l'aggiornamento all'ultima versione di Google Cloud CLI.
2. Imposta una regione e una zona predefinite.

API

Se vuoi utilizzare gli esempi di API in questa guida, configura l'accesso alle API.

Specificare route annunciate personalizzate su un router Cloud

Per specificare route annunciate personalizzate su un router Cloud esistente:

Console

1. Nella console Google Cloud , vai alla pagina Router Cloud.

   Vai a Router Cloud

2. Seleziona il router Cloud da aggiornare.

3. Nella pagina Dettagli router, fai clic su Modifica.

4. Nella sezione Route annunciate, per Route, seleziona Crea route personalizzate.

5. Seleziona la casella di controllo Annuncia tutte le subnet visibili al router Cloud per continuare ad annunciare le subnet disponibili per il router Cloud. L'attivazione di questa opzione riproduce il comportamento del router Cloud in modalità annuncio predefinita.

6. Seleziona Aggiungi una route personalizzata per aggiungere una route annunciata.

7. Configura le route annunciate personalizzate:

   • Origine: seleziona Intervallo IP personalizzato.

   • Intervallo di indirizzi IP: utilizza la notazione CIDR per specificare l'intervallo IP personalizzato.

     Puoi specificare intervalli IP personalizzati IPv4 e IPv6. Tuttavia, gli intervalli personalizzati IPv6 vengono annunciati solo nelle sessioni BGP con IPv6 abilitato.

     Se fornisci un prefisso di indirizzo IP senza una subnet mask, viene interpretato come una subnet mask /32 per IPv4 e /128 per IPv6. Per informazioni sul numero massimo di route apprese personalizzate che puoi avere, consulta Limiti.

   • Descrizione: aggiungi una descrizione per aiutarti a identificare lo scopo di questa route annunciata personalizzata, quindi fai clic su Fine.

8. Dopo aver aggiunto le route annunciate personalizzate, fai clic su Salva.

gcloud

Esegui il comando update. Per specificare gli intervalli IP personalizzati, utilizza il flag --set-advertisement-ranges o --add-advertisement-ranges.

1. Utilizza il flag --set-advertisement-ranges; tutti gli annunci personalizzati esistenti vengono sostituiti:

   gcloud compute routers update ROUTER_NAME \
      --project=PROJECT_ID \
      --advertisement-mode custom \
      --set-advertisement-groups=ADVERTISED_GROUPS \
      --set-advertisement-ranges=ADVERTISED_IP_RANGES
   

   Sostituisci quanto segue:

   • ROUTER_NAME: il nome del router Cloud
   • PROJECT_ID: il progetto che contiene il router Cloud

   • ADVERTISED_GROUPS: un gruppo definito da Google che il router Cloud annuncia dinamicamente

     L'unico valore valido è all_subnets, che annuncia le subnet in base alla modalità di routing dinamico della rete VPC (simile alla modalità annuncio predefinita).

   • ADVERTISED_IP_RANGES: i contenuti del nuovo array di intervalli di indirizzi IP

     Puoi specificare intervalli IP personalizzati IPv4 e IPv6. Tuttavia, gli intervalli personalizzati IPv6 vengono annunciati solo nelle sessioni BGP con IPv6 abilitato.

     Se fornisci un prefisso di indirizzo IP senza una subnet mask, viene interpretato come una subnet mask /32 per IPv4 e /128 per IPv6. Per informazioni sul numero massimo di route apprese personalizzate che puoi avere, consulta Limiti.

   L'esempio seguente aggiorna il router Cloud my-router per annunciare tutte le subnet e gli intervalli IP personalizzati 192.0.2.0/24 e 198.51.100.0/24:

   gcloud compute routers update my-router \
      --advertisement-mode custom \
      --set-advertisement-groups=all_subnets \
      --set-advertisement-ranges='192.0.2.0/24,198.51.100.0/24'
   

   L'esempio seguente aggiorna il router Cloud my-router per annunciare tutte le subnet e l'intervallo IPv6 predefinito:

   gcloud compute routers update my-router \
      --advertisement-mode custom \
      --set-advertisement-groups=all_subnets \
      --set-advertisement-ranges='2001:db8:abcd:12::/64'
   

   Il router Cloud annuncia gli intervalli IPv6 solo nelle sessioni BGP abilitate per IPv6.

   Il flag --set-advertisement-groups accetta i gruppi definiti da Google che il router Cloud annuncia dinamicamente. Puoi rimuovere il flag --set-advertisement-groups per escludere gli annunci di subnet. Per un elenco di tutti i gruppi di annunci, consulta il set-advertisement-groups flag nella documentazione dell'SDK Google.

2. Utilizza il flag --add-advertisement-ranges, che richiede che la modalità di annuncio del router Cloud sia già impostata su custom:

   gcloud compute routers update ROUTER_NAME \
      --add-advertisement-ranges=ADVERTISED_IP_RANGES
   

   Sostituisci quanto segue:

   • ROUTER_NAME: il nome del router Cloud
   • ADVERTISED_IP_RANGES: i contenuti del nuovo array di intervalli di indirizzi IP

   L'esempio seguente aggiunge l'indirizzo IP personalizzato 203.0.113.1 agli annunci del router Cloud:

   gcloud compute routers update my-router \
      --add-advertisement-ranges='203.0.113.1'
   

   L'esempio seguente aggiunge l'intervallo IPv6 personalizzato 2001:db8:abcd:12::/64 agli annunci del router Cloud:

   gcloud compute routers update my-router \
      --add-advertisement-ranges='2001:db8:abcd:12::/64'
   

   Il router Cloud annuncia gli intervalli IPv6 solo nelle sessioni BGP abilitate per IPv6.

API

Utilizza il routers.patch metodo per aggiornare i bgp.advertisedGroups[] e bgp.advertisedIpRanges[] campi.

I campi bgp.advertisedGroups[] e bgp.advertisedIpRanges[] memorizzano array di gruppi annunciati e intervalli di indirizzi IP annunciati. Quando esegui PATCH di questi campi, sovrascrivi gli array esistenti con quelli nuovi nella richiesta.

1. Invia una richiesta GET per recuperare gli array correnti di gruppi annunciati e intervalli di indirizzi IP annunciati sul router. Per maggiori dettagli, consulta Visualizzare la configurazione della sessione BGP.

2. Invia una richiesta PATCH con nuovi array di gruppi annunciati e intervalli di indirizzi IP annunciati. Utilizza gli array della richiesta GET nel passaggio precedente e aggiungi i gruppi o gli intervalli di indirizzi IP che vuoi sul router.

   PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
   {
     "bgp": {
       "advertisedGroups": [
       "ADVERTISED_GROUPS"
      ],
       "advertisedIpRanges": [
       ADVERTISED_IP_RANGES
      ]
    }
   }
   

   Sostituisci quanto segue:

   • PROJECT_ID: il progetto che contiene il router Cloud
   • REGION: la regione in cui si trova il router Cloud
   • ROUTER_NAME: il nome del router Cloud
   • ADVERTISED_GROUPS: un gruppo definito da Google che il router Cloud annuncia dinamicamente

   L'unico valore valido è ALL_SUBNETS, che annuncia le subnet in base alla modalità di routing dinamico della rete VPC (simile agli annunci predefiniti).

   • ADVERTISED_IP_RANGES: i contenuti del nuovo array di intervalli di indirizzi IP

   Puoi specificare intervalli IP personalizzati IPv4 e IPv6. Tuttavia, gli intervalli personalizzati IPv6 vengono annunciati solo nelle sessioni BGP con IPv6 abilitato.

   Se fornisci un prefisso di indirizzo IP senza una subnet mask, viene interpretato come una subnet mask /32 per IPv4 e /128 per IPv6. Per informazioni sul numero massimo di route apprese personalizzate che puoi avere, consulta Limiti.

   L'esempio seguente contiene due intervalli di indirizzi IPv4 e un intervallo di indirizzi IPv6:

       {
         "range": "192.0.2.0/24",
         "description": "First example range"
       },
       {
         "range": "198.51.100.0/24",
         "description": "Second example range"
       },
       {
         "range": "2001:db8:abcd:12::/64",
         "description: "Third example range"
       }
   

Specificare route annunciate personalizzate per una sessione BGP

Per specificare route annunciate personalizzate per una sessione BGP esistente:

Console

1. Nella console Google Cloud , vai alla pagina Router Cloud.

   Vai a Router Cloud

2. Seleziona il router Cloud che contiene la sessione BGP da aggiornare.

3. Nella pagina Dettagli router, seleziona la sessione BGP da aggiornare.

4. Nella pagina Dettagli sessione BGP, fai clic su Modifica.

5. Per Route, seleziona Crea route personalizzate.

6. Seleziona la casella di controllo Annuncia tutte le subnet visibili al router Cloud per continuare ad annunciare le subnet disponibili per il router Cloud. L'attivazione di questa opzione riproduce il comportamento predefinito del router Cloud.

7. Seleziona Aggiungi una route personalizzata per aggiungere una route annunciata.

8. Configura l'annuncio di route:

   • Origine: seleziona Intervallo IP personalizzato.

   • Intervallo di indirizzi IP: utilizza la notazione CIDR per specificare l'intervallo IP personalizzato. Puoi specificare intervalli IP personalizzati IPv4 e IPv6. Tuttavia, gli intervalli personalizzati IPv6 vengono annunciati solo nelle sessioni BGP con IPv6 abilitato.

     Se fornisci un prefisso di indirizzo IP senza una subnet mask, viene interpretato come una subnet mask /32 per IPv4 e /128 per IPv6. Per informazioni sul numero massimo di route apprese personalizzate che puoi avere, consulta Limiti.

   • Descrizione: aggiungi una descrizione per aiutarti a identificare lo scopo di questo annuncio di route, quindi fai clic su Fine.

9. Dopo aver aggiunto le route personalizzate, fai clic su Salva.

gcloud

Esegui il comando update-bgp-peer. Per specificare gli intervalli IP personalizzati, utilizza il flag --set-advertisement-ranges o --add-advertisement-ranges.

1. Utilizza il flag --set-advertisement-ranges; tutti gli annunci personalizzati esistenti vengono sostituiti:

   gcloud compute routers update-bgp-peer ROUTER_NAME \
       --peer-name=PEER_NAME \
       --advertisement-mode custom \
       --set-advertisement-groups=ADVERTISED_GROUPS \
       --set-advertisement-ranges=ADVERTISED_IP_RANGES
   

   Sostituisci quanto segue:

   • ROUTER_NAME: il nome del router Cloud
   • PEER_NAME: il nome del peer BGP
   • (Facoltativo) Aggiungi il flag --enable-ipv6 se stai aggiungendo intervalli IPv6 personalizzati.

   • ADVERTISED_GROUPS: un gruppo definito da Google che il router Cloud annuncia dinamicamente

     L'unico valore valido è all_subnets, che annuncia le subnet in base alla modalità di routing dinamico della rete VPC (simile agli annunci predefiniti).

   • ADVERTISED_IP_RANGES: i contenuti del nuovo array di intervalli di indirizzi IP

     Puoi specificare intervalli IP personalizzati IPv4 e IPv6. Tuttavia, gli intervalli personalizzati IPv6 vengono annunciati solo nelle sessioni BGP con IPv6 abilitato.

     Se fornisci un prefisso di indirizzo IP senza una subnet mask, viene interpretato come una subnet mask /32 per IPv4 e /128 per IPv6. Per informazioni sul numero massimo di route apprese personalizzate che puoi avere, consulta Limiti.

   L'esempio seguente aggiorna la sessione BGP my-bgp-session sul router Cloud my-router per annunciare tutte le subnet e gli intervalli IP personalizzati 192.0.2.1, 198.51.100.0/24 e 2001:db8:abcd:12::/64.

   gcloud compute routers update-bgp-peer my-router \
       --peer-name my-bgp-session \
       --enable-ipv6 \
       --advertisement-mode custom \
       --set-advertisement-groups=all_subnets \
       --set-advertisement-ranges='192.0.2.1,198.51.100.0/24,2001:db8:abcd:12::/64'
   

   Il flag --set-advertisement-groups accetta i gruppi definiti da Google che la sessione BGP annuncia dinamicamente. Puoi rimuovere il flag --add-advertisement-groups per escludere gli annunci di subnet. Per un elenco di tutti i gruppi di annunci, consulta il set-advertisement-groups flag nella documentazione dell'SDK Google.

2. Utilizza il flag --add-advertisement-ranges, che richiede che la modalità di annuncio del router Cloud sia già impostata su custom:

   gcloud compute routers update-bgp-peer ROUTER_NAME \
       --peer-name=PEER_NAME \
       --add-advertisement-ranges=ADVERTISED_IP_RANGES
   

   Sostituisci quanto segue:

   • ROUTER_NAME: il nome del router Cloud
   • PEER_NAME: il nome del peer BGP

   • ADVERTISED_IP_RANGES: i contenuti del nuovo array di intervalli di indirizzi IP

     Puoi specificare intervalli IP personalizzati IPv4 e IPv6. Tuttavia, gli intervalli personalizzati IPv6 vengono annunciati solo nelle sessioni BGP con IPv6 abilitato.

     Se fornisci un prefisso di indirizzo IP senza una subnet mask, viene interpretato come una subnet mask /32 per IPv4 e /128 per IPv6. Per informazioni sul numero massimo di route apprese personalizzate che puoi avere, consulta Limiti.

   L'esempio seguente aggiunge l'indirizzo IP personalizzato 198.51.100.1 agli annunci del router Cloud:

   gcloud compute routers update-bgp-peer my-router \
       --peer-name my-bgp-session \
       --add-advertisement-ranges='198.51.100.1'
   

   L'esempio seguente aggiunge l'indirizzo IPv6 personalizzato 2001:db8:abcd:12::/64 agli annunci del router Cloud:

   gcloud compute routers update-bgp-peer my-router \
       --peer-name my-bgp-session \
       --enable-ipv6 \
       --add-advertisement-ranges='2001:db8:abcd:12::/64'
   

API

Utilizza il routers.patch metodo per aggiornare il bgpPeers[] campo.

Il campo bgpPeers[] accetta un array di peer BGP. Quando esegui PATCH di questo campo, sovrascrivi l'array esistente di peer BGP con il nuovo array incluso nella richiesta.

1. Invia una richiesta GET per recuperare l'array corrente di peer BGP per il router. Per maggiori dettagli, consulta Visualizzare la configurazione della sessione BGP.

2. Invia una richiesta PATCH con un nuovo array di peer BGP. Per ogni peer BGP a cui vuoi aggiungere annunci:

   • Aggiungi gli annunci di intervalli di indirizzi IP che vuoi nel campo bgpPeers[].advertisedIpRanges[].

   • Aggiungi gli annunci di gruppo che vuoi nel campo bgpPeers[].advertisedGroups[].

     L'unico valore valido è ALL_SUBNETS, che annuncia le subnet in base alla modalità di routing dinamico della rete VPC (simile alla modalità annuncio predefinita).

     Per saperne di più su questi valori, consulta routers.patch nella documentazione dell'API.

   PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
   {
     "bgpPeers": [
       BGP_PEERS
     ]
   }
   

   Sostituisci quanto segue:

   • PROJECT_ID: il progetto che contiene il router Cloud
   • REGION: la regione in cui si trova il router Cloud
   • ROUTER_NAME: il nome del router Cloud
   • BGP_PEERS: i contenuti del nuovo array di peer BGP

   L'esempio seguente contiene due peer BGP con annunci personalizzati:

       {
         "name": "peer-1",
         "interfaceName": "if-peer-1",
         "ipAddress": "169.254.10.1",
         "peerIpAddress": "169.254.10.2",
         "peerAsn": 64512,
         "enableIpv6": true,
         "advertisedRoutePriority": 100,
         "advertiseMode": "CUSTOM",
         "advertisedGroups": ["ALL_SUBNETS"],
         "advertisedIpRanges": [
           {
             "range": "1.2.3.4",
             "description": "First example range"
           },
           {
             "range": "6.7.0.0/16",
             "description": "Second example range"
           },
           {
             "range": "2001:db8:abcd:12::/64",
             "description: "Third example range"
           }
         ]
       },
       {
         "name": "peer-2",
         "interfaceName": "if-peer-2",
         "ipAddress": "169.254.20.1",
         "peerIpAddress": "169.254.20.2",
         "peerAsn": 64513,
         "advertisedRoutePriority": 100,
         "advertiseMode": "CUSTOM",
         "advertisedIpRanges": [
           {
             "range": "192.168.10.0/24",
             "description": "Fourth example range"
           }
         ]
       }
   

Passaggi successivi

• Per visualizzare la configurazione di un router Cloud, le relative sessioni BGP e le route che il router Cloud sta annunciando, consulta Visualizzare i dettagli del router Cloud.

• Per risolvere i problemi relativi alle route annunciate personalizzate, consulta Risoluzione dei problemi.