Creare e gestire router

Questa pagina descrive come creare e gestire le risorse di router Google Distributed Cloud connected in una zona Distributed Cloud.

Questa funzionalità è disponibile solo sui rack connessi di Distributed Cloud. I server connessi a Distributed Cloud non supportano le risorse router.

Per saperne di più sui router Distributed Cloud, consulta la pagina Come funziona Distributed Cloud connected.

Tieni presente che:

  • Puoi creare un router per ogni rete Distributed Cloud.

  • Ti consigliamo di creare un router e il relativo collegamento interconnessione contemporaneamente. Per ulteriori informazioni sulla creazione di un collegamento di interconnessione, consulta Crea un collegamento di interconnessione.

Crea un router

Per creare un router Distributed Cloud, completa i passaggi in questa sezione.

Per completare questa attività, devi disporre del ruolo Edge Network Admin (roles/edgenetwork.admin) nel tuo progetto Google Cloud .

gcloud

Utilizza il comando gcloud edge-cloud networking routers create:

gcloud edge-cloud networking routers create ROUTER_NAME \
    --network=NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --asn=ASN

Sostituisci quanto segue:

  • ROUTER_NAME: un nome descrittivo che identifica in modo univoco questo router.
  • NETWORK_NAME: il nome della rete a cui serve questo router.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.
  • ASN: il numero di sistema autonomo (ASN) per questo router. Puoi specificare un valore di 2 o 4 byte. Supporta valori ASN pubblici e privati.

API

Invia una richiesta POST al metodo projects.locations.zones.routers.create:

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers?routerId=ROUTER_ID
{
 "labels": { LABELS,
  },
 "network": { NETWORK_NAME,
  },
 "asn": { ASN,
  },      
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud connesso di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.
  • ROUTER_ID: un ID che identifica in modo univoco questo router.
  • LABELS: un elenco di etichette da applicare a questa risorsa router.
  • NETWORK_NAME: il nome della rete a cui questo router fornisce servizi.
  • ASN: il numero di sistema autonomo (ASN) per questo router. Puoi specificare un valore di 2 o 4 byte. Supporta valori ASN pubblici e privati.

Stabilisci una sessione di peering BGP su un router

Un router consente di stabilire i seguenti tipi di sessioni di peering Border Gateway Protocol (BGP):

Una sessione di peering BGP viene stabilita aggiungendo un'interfaccia al router per il componente di rete Distributed Cloud che corrisponde al tipo di sessione di peering.

Stabilire una sessione di peering in direzione nord

Per stabilire una sessione di peering in direzione nord su un router con un collegamento interconnect, completa i passaggi descritti in questa sezione. L'allegato di interconnessione di destinazione deve essere associato al router di destinazione.

Per completare questa attività, devi disporre del ruolo Edge Network Admin (roles/edgenetwork.admin) nel tuo progetto Google Cloud .

gcloud

Utilizza il comando gcloud edge-cloud networking routers add-interface:

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --interconnect-attachment=ATTACHMENT_NAME \
    --ip-address=INTERCONNECT_ADDRESS \
    --ip-mask-length=IP_MASK_LENGTH \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del router di destinazione.
  • INTERFACE_NAME: un nome descrittivo per questa interfaccia.
  • ATTACHMENT_NAME: il nome dell'attachment interconnect di destinazione all'interno del router di destinazione.
  • INTERCONNECT_ADDRESS: l'indirizzo IP dell'interconnessione su cui è configurato l'allegato di interconnessione di destinazione.
  • IP_MASK_LENGTH: la lunghezza della maschera per l'indirizzo IP di interconnessione specificato.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.

Stabilisci una sessione di peering in uscita

Per stabilire una sessione di peering in direzione sud su un router con una subnet, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi disporre del ruolo Edge Network Admin (roles/edgenetwork.admin) nel tuo progetto Google Cloud .

gcloud

Utilizza il comando gcloud edge-cloud networking routers add-interface:

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --subnet=SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del router di destinazione.
  • INTERFACE_NAME: un nome descrittivo per questa interfaccia.
  • SUBNETWORK_NAME: il nome della subnet di destinazione.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.

Stabilire una sessione di peering di loopback

Per stabilire una sessione di peering loopback su un router con una rete, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi disporre del ruolo Edge Network Admin (roles/edgenetwork.admin) nel tuo progetto Google Cloud .

gcloud

Utilizza il comando gcloud edge-cloud networking routers add-interface:

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --loopback-ip-addresses=LOOPBACK_ADDRESSES \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del router di destinazione.
  • INTERFACE_NAME: un nome descrittivo per questa interfaccia.
  • LOOPBACK_ADDRESSES: gli indirizzi IPv4 in entrata e in uscita per l'interfaccia di loopback, separati da virgole.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.

Terminare una sessione di peering BGP

Per terminare una sessione di peering BGP tra un router e un collegamento di interconnessione, una subnet o una rete, devi eliminare l'interfaccia per il componente di rete dal router di destinazione. Per eliminare l'interfaccia, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi disporre del ruolo Edge Network Admin (roles/edgenetwork.admin) nel tuo progetto Google Cloud .

gcloud

Utilizza il comando gcloud edge-cloud networking routers remove-interface:

gcloud edge-cloud networking routers remove-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del router di destinazione.
  • INTERFACE_NAME: un nome descrittivo per questa interfaccia.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.

Configura i peer in una sessione di peering BGP

Puoi aggiungere e rimuovere peer BGP in una sessione di peering BGP stabilita tra un router e un collegamento di interconnessione, una subnet o una rete. Quando aggiungi un peer a una sessione di peering BGP, il protocollo Bidirectional Forwarding Detection (BFD) viene attivato automaticamente sul router di destinazione con un intervallo di 100 ms, una finestra di ricezione minima di 100 ms e un moltiplicatore di 3.

Dopo aver aggiunto un peer alla sessione di peering BGP di destinazione, puoi assegnare l'indirizzo IP del peer al pod che esegue il tuo workload. Per trovare l'indirizzo IP peer, completa i passaggi descritti in Ottenere informazioni su un router.

Aggiungere un peer a una sessione di peering BGP

Per aggiungere un peer a una sessione di peering BGP, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi disporre del ruolo Edge Network Admin (roles/edgenetwork.admin) nel tuo progetto Google Cloud .

gcloud

Utilizza il comando gcloud edge-cloud networking routers add-bgp-peer:

gcloud edge-cloud networking routers add-bgp-peer ROUTER_NAME \
    --peer-name=PEER_NAME> \
    --peer-asn=PEER_ASN \
    --peer-ipv4-range=PEER_IPv4_RANGE \
    --peer-ipv6-range=PEER_IPv6_RANGE \        
    --interface=INTERFACE_NAME \                                                       \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del router di destinazione.
  • PEER_NAME: un nome descrittivo per questo peer.
  • PEER_ASN: il numero di sistema autonomo (ASN) per questo peer. Puoi specificare un valore di 2 o 4 byte. Supporta valori ASN pubblici e privati.
  • PEER_IPv4_RANGE: l'intervallo CIDR IPv4 per questo peer. Questo intervallo di indirizzi deve trovarsi nella stessa subnet dell'indirizzo IP o dell'intervallo di indirizzi per l'allegato di interconnessione, la subnet o la rete associati.
  • PEER_IPv6_RANGE: l'intervallo CIDR IPv6 per questo peer. Questo intervallo di indirizzi deve trovarsi nella stessa subnet dell'indirizzo IP o dell'intervallo di indirizzi per l'allegato di interconnessione, la subnet o la rete associati.
  • INTERFACE_NAME: il nome dell'interfaccia che corrisponde alla sessione BGP di destinazione.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.

Rimuovere un peer da una sessione di peering BGP

Per rimuovere un peer da una sessione di peering BGP, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi disporre del ruolo Edge Network Admin (roles/edgenetwork.admin) nel tuo progetto Google Cloud .

gcloud

Utilizza il comando gcloud edge-cloud networking routers remove-bgp-peer:

gcloud edge-cloud networking routers remove-bgp-peer ROUTER_NAME \
    --peer-name=PEER_NAME> \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del router di destinazione.
  • PEER_NAME: il nome del peer di destinazione.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.

Elenca router

Per elencare i router di cui è stato eseguito il provisioning all'interno di una zona connessa Distributed Cloud, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi avere il ruolo Visualizzatore rete edge (roles/edgenetwork.viewer) nel tuo progetto Google Cloud .

gcloud

Utilizza il comando gcloud edge-cloud networking routers list:

gcloud edge-cloud networking routers list \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.

API

Invia una richiesta GET al metodo projects.locations.zones.routers.list:

 GET /v1/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.
  • FILTER: un'espressione che vincola i risultati restituiti a valori specifici.
  • PAGE_SIZE: il numero di risultati da restituire per pagina.
  • SORT_BY: un elenco delimitato da virgole di nomi di campi in base ai quali vengono ordinati i risultati restituiti. L'ordinamento predefinito è crescente. Per l'ordinamento decrescente, aggiungi il prefisso ~ al campo desiderato.
  • PAGE_TOKEN: un token ricevuto nella risposta all'ultima richiesta di elenco nel campo nextPageToken della risposta. Invia questo token per ricevere una pagina di risultati.

Ottenere informazioni su un router

Per ottenere informazioni su un router Distributed Cloud, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi avere il ruolo Visualizzatore rete edge (roles/edgenetwork.viewer) nel tuo progetto Google Cloud .

gcloud

Utilizza il comando gcloud edge-cloud networking routers describe:

gcloud edge-cloud networking routers describe ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del router di destinazione.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.

API

Invia una richiesta GET al metodo projects.locations.zones.routers.get:

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.
  • ROUTER_ID: l'ID del router di destinazione.

Questa operazione restituisce informazioni dettagliate sulla risorsa, incluso il relativo stato di provisioning:

  • PENDING: il provisioning della risorsa non è ancora iniziato e la risorsa non è ancora stata propagata in tutta la zona.
  • PROVISIONING: la risorsa è in fase di provisioning; devi attendere che sia stata propagata in tutta la zona.
  • RUNNING: la risorsa è stata sottoposta a provisioning e propagata correttamente in tutta la zona ed è pronta per l'uso.
  • FAILED: il provisioning della risorsa non è andato a buon fine; la risorsa non è stata propagata in tutta la zona.

Controllare lo stato operativo di un router

Per controllare lo stato operativo di un router Distributed Cloud, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi avere il ruolo Visualizzatore rete edge (roles/edgenetwork.viewer) nel tuo progetto Google Cloud .

gcloud

Utilizza il comando gcloud edge-cloud networking routers get-status:

gcloud edge-cloud networking routers get-status ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del router di destinazione.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.

API

Invia una richiesta GET al metodo projects.locations.zones.routers.diagnose:

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID:diagnose

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.
  • ROUTER_ID: l'ID del router di destinazione.

Elimina un router

Per eliminare un router Distributed Cloud, completa i passaggi in questa sezione.

Per completare questa attività, devi disporre del ruolo Edge Network Admin (roles/edgenetwork.admin) nel tuo progetto Google Cloud .

gcloud

Utilizza il comando gcloud edge-cloud networking routers delete:

gcloud edge-cloud networking routers delete ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del router di destinazione.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.

API

Invia una richiesta DELETE al metodo projects.locations.zones.routers.delete:

 DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.
  • ROUTER_ID: l'ID del router di destinazione.

Passaggi successivi