Questa pagina è stata tradotta dall'API Cloud Translation.

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 connesse alla tua 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à pubblicitaria predefinita, pubblicizza solo route per subnet che fanno parte della stessa rete VPC del router Cloud. In questa modalità, il router Cloud esclude tutte le route statiche e quelle 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 un router Cloud o Stabilire sessioni BGP.

Prima di iniziare

gcloud

Se vuoi utilizzare gli esempi di riga di comando di questa guida, procedi nel seguente modo:

Installa o aggiorna alla versione più recente di Google Cloud CLI.
Imposta una regione e una zona predefinite.

API

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

Specifica le route annunciate personalizzate su un router Cloud

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

Console

Nella console Google Cloud, vai alla pagina Router Cloud.

Vai ai router Cloud
Seleziona il router Cloud da aggiornare.
Nella pagina Dettagli router, fai clic su Modifica.
Nella sezione Route annunciate, per Route seleziona Crea route personalizzate.
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.
Seleziona Aggiungi route personalizzata per aggiungere un percorso pubblicizzato.
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.
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.

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

Invia una richiesta GET per recuperare gli array attuali dei gruppi pubblicizzati e degli intervalli di indirizzi IP pubblicizzati sul router. Per maggiori dettagli, consulta Visualizzare la configurazione della sessione BGP.
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 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 (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 le route annunciate personalizzate per una sessione BGP

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

Console

Nella console Google Cloud, vai alla pagina Router Cloud.

Vai ai router Cloud
Seleziona il router Cloud che contiene la sessione BGP da aggiornare.
Nella pagina Dettagli router, seleziona la sessione BGP da aggiornare.
Nella pagina Dettagli sessione BGP, fai clic su Modifica.
Per Route, seleziona Crea route personalizzate.
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 riproduce il comportamento predefinito del router Cloud.
Seleziona Aggiungi route personalizzata per aggiungere un percorso pubblicizzato.
Configurare la 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.
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.

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 stai aggiungendo 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 (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 annuncia 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.
Utilizza il flag --add-advertisement-ranges, che richiede che la modalità pubblicitaria 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
```
Nell'esempio seguente viene aggiunto 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 PATCH questo campo, sovrascrivi l'array esistente di peer BGP con il nuovo array incluso nella richiesta.

Invia una richiesta GET per ottenere l'array attuale dei peer BGP per il router. Per maggiori dettagli, consulta Visualizzare la configurazione della sessione BGP.

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 all'intervallo 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 (simile alla modalità pubblicitaria predefinita).

Per maggiori informazioni 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 pubblicizzate dal router Cloud, consulta Visualizzare i dettagli del router Cloud.
Per risolvere i problemi relativi alle route annunciate personalizzate, consulta la sezione Risoluzione dei problemi.