Annuncio di intervalli IP personalizzati

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

Quando un router Cloud è configurato per utilizzare la modalità annuncio predefinita, pubblicizza solo route per le subnet che fanno parte della stessa rete VPC del router Cloud. In questa modalità, il router Cloud esclude eventuali route statiche e route apprese in modo dinamico da altre reti VPC, come le route apprese dal peering di rete VPC o dagli spoke VPC in Network Connectivity Center.

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

Specifica route annunciate personalizzate su un router Cloud

Per specificare route annunciate personalizzate su un router Cloud esistente, segui questi passaggi.

Console

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

    Vai ai 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 Pubblicizza tutte le subnet visibili al router Cloud per continuare a pubblicizzare le subnet disponibili per il router Cloud. L'attivazione di questa opzione imita il comportamento del router Cloud nella modalità pubblicitaria predefinita.

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

  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 sia IPv4 sia IPv6. Tuttavia, gli intervalli personalizzati IPv6 vengono pubblicizzati solo nelle sessioni BGP in cui è abilitato IPv6.
    • Descrizione: aggiungi una descrizione per identificare lo scopo di questa route pubblicizzata personalizzata, quindi fai clic su Fine.
  8. Dopo aver completato l'aggiunta delle 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. Gli eventuali 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 pubblicizza in modo dinamico

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

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

      Puoi specificare intervalli IP personalizzati sia IPv4 sia IPv6. Tuttavia, gli intervalli personalizzati IPv6 vengono pubblicizzati solo nelle sessioni BGP in cui è abilitato IPv6.

    L'esempio seguente aggiorna il router Cloud my-router per pubblicizzare tutte le subnet e gli intervalli IP personalizzati 1.2.3.4 e 6.7.0.0/16:

    gcloud compute routers update my-router \
       --advertisement-mode custom \
       --set-advertisement-groups all_subnets \
       --set-advertisement-ranges 1.2.3.4,6.7.0.0/16
    

    L'esempio seguente aggiorna il router Cloud my-router per pubblicizzare 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 ::/0
    

    Il router Cloud pubblicizza 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 pubblicizza in modo dinamico. Puoi rimuovere il flag --set-advertisement-groups per escludere gli annunci di subnet. Per un elenco di tutti i gruppi pubblicitari, vedi il flag set-advertisement-groups nella documentazione dell'SDK Google.

  2. Utilizza il flag --add-advertisement-ranges, che richiede che la modalità pubblicità 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

    Nell'esempio seguente viene aggiunto l'indirizzo IP personalizzato 1.2.3.5 agli annunci del router Cloud:

    gcloud compute routers update my-router \
       --add-advertisement-ranges 1.2.3.5
    

    Nell'esempio seguente viene aggiunto 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 pubblicizza gli intervalli IPv6 solo nelle sessioni BGP abilitate per IPv6.

API

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

I campi bgp.advertisedGroups[] e bgp.advertisedIpRanges[] archiviano gli array dei gruppi pubblicizzati e degli intervalli di indirizzi IP pubblicizzati. Quando PATCH questi campi, sovrascrivi gli array esistenti con quelli nuovi nella tua richiesta.

  1. Invia una richiesta GET per recuperare gli array attuali dei gruppi pubblicizzati e degli intervalli di indirizzi IP pubblicizzati sul router. Per maggiori dettagli, vedi Visualizzare la configurazione delle sessioni BGP.

  2. Invia una richiesta PATCH con nuovi array di gruppi pubblicizzati e intervalli di indirizzi IP pubblicizzati. Utilizza gli array della richiesta GET nel passaggio precedente e aggiungi eventuali gruppi o 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 pubblicizza in modo dinamico

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

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

      Puoi specificare intervalli IP personalizzati sia IPv4 sia IPv6. Tuttavia, gli intervalli personalizzati IPv6 vengono pubblicizzati solo nelle sessioni BGP in cui è abilitato IPv6.

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

        {
          "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"
        }
    

Specifica route annunciate personalizzate per una sessione BGP

Per specificare route annunciate personalizzate per una sessione BGP esistente, segui questi passaggi.

Console

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

    Vai ai 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. In Route, seleziona Crea route personalizzate.

  6. Seleziona la casella di controllo Pubblicizza tutte le subnet visibili al router Cloud per continuare a pubblicizzare le subnet disponibili per il router Cloud. L'abilitazione di questa opzione riproduce il comportamento predefinito del router Cloud.

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

  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 sia IPv4 sia IPv6. Tuttavia, gli intervalli personalizzati IPv6 vengono pubblicizzati solo nelle sessioni BGP in cui è abilitato IPv6.
    • Descrizione: aggiungi una descrizione per 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. Gli eventuali 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 tuo peer BGP
    • Facoltativamente, aggiungi il flag --enable-ipv6 se aggiungi intervalli IPv6 personalizzati.
    • ADVERTISED_GROUPS: un gruppo definito da Google che il router Cloud pubblicizza in modo dinamico

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

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

      Puoi specificare intervalli IP personalizzati sia IPv4 sia IPv6. Tuttavia, gli intervalli personalizzati IPv6 vengono pubblicizzati solo nelle sessioni BGP in cui è abilitato IPv6.

    L'esempio seguente aggiorna la sessione BGP my-bgp-session sul router Cloud my-router per pubblicizzare tutte le subnet e gli intervalli IP personalizzati 1.2.3.4, 6.7.0.0/16 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 1.2.3.4,6.7.0.0/16,2001:db8:abcd:12::/64
    

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

  2. Utilizza il flag --add-advertisement-ranges, che richiede che la modalità pubblicità 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 tuo peer BGP
    • ADVERTISED_IP_RANGES: i contenuti del nuovo array di intervalli di indirizzi IP

      Puoi specificare intervalli IP personalizzati sia IPv4 sia IPv6. Tuttavia, gli intervalli personalizzati IPv6 vengono pubblicizzati solo nelle sessioni BGP in cui è abilitato IPv6.

    Nell'esempio seguente viene aggiunto l'indirizzo IP personalizzato 1.2.3.5 agli annunci del router Cloud:

    gcloud compute routers update-bgp-peer my-router \
        --peer-name my-bgp-session \
        --add-advertisement-ranges 1.2.3.5
    

    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 metodo routers.patch per aggiornare il campo bgpPeers[].

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

  1. Invia una richiesta GET per ottenere l'array attuale di peer BGP per il router. Per maggiori dettagli, vedi Visualizzare la configurazione delle sessioni BGP.

  2. Invia una richiesta PATCH con un nuovo array di peer BGP. Per ogni peer BGP per cui vuoi aggiungere annunci, segui questi passaggi:

    • Aggiungi eventuali annunci pubblicitari relativi a intervalli di indirizzi IP nel campo bgpPeers[].advertisedIpRanges[].
    • Aggiungi eventuali annunci di gruppo nel campo bgpPeers[].advertisedGroups[].

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

      Per ulteriori informazioni su questi valori, vedi 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