Creare e gestire router

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

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

Per saperne di più sui router Distributed Cloud, consulta Come funziona Distributed Cloud connesso.

Tieni presente che:

  • Puoi creare un router per ogni rete Distributed Cloud.

  • Ti consigliamo di creare un router e il relativo collegamento di interconnessione contemporaneamente. Per saperne di più sulla creazione di un collegamento di interconnessione, consulta Creare un collegamento di interconnessione.

Crea un router

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

Per completare questa attività, devi avere il ruolo Amministratore della rete Edge (roles/edgenetwork.admin) in your Google Cloud project.

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 questo router fornisce servizi.
  • REGION: la Google Cloud regione 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 due o quattro 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 delprogetto di destinazione Google Cloud .
  • REGION: la Google Cloud regione a cui appartiene la zona Distributed Cloud connessa 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 del 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 due o quattro 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.

Stabilisci una sessione di peering in direzione nord

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

Per completare questa attività, devi avere il ruolo Amministratore della rete Edge (roles/edgenetwork.admin) in your Google Cloud project.

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 del collegamento di interconnessione di destinazione all'interno del router di destinazione.
  • INTERCONNECT_ADDRESS: l'indirizzo IP dell'interconnessione su cui è configurato il collegamento di interconnessione di destinazione.
  • IP_MASK_LENGTH: la lunghezza della maschera per l'indirizzo IP di interconnessione specificato.
  • REGION: la Google Cloud regione 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 direzione sud

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 avere il ruolo Amministratore della rete Edge (roles/edgenetwork.admin) in your Google Cloud project.

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 Google Cloud regione 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 di loopback

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

Per completare questa attività, devi avere il ruolo Amministratore della rete Edge (roles/edgenetwork.admin) in your Google Cloud project.

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 Google Cloud regione a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.

Termina 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 quel componente di rete dal router di destinazione. Per eliminare l'interfaccia, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi avere il ruolo Amministratore della rete Edge (roles/edgenetwork.admin) in your Google Cloud project.

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 Google Cloud regione 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 i 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 BFD (Bidirectional Forwarding Detection) viene abilitato 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 carico di lavoro. Per trovare l'indirizzo IP del peer, completa i passaggi descritti in Ottieni informazioni su un router.

Aggiungi 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 avere il ruolo Amministratore della rete Edge (roles/edgenetwork.admin) in your Google Cloud project.

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 due o quattro 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 il collegamento 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 il collegamento di interconnessione, la subnet o la rete associati.
  • INTERFACE_NAME: il nome dell'interfaccia che corrisponde alla sessione BGP di destinazione.
  • REGION: la Google Cloud regione a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.

Rimuovi 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 avere il ruolo Amministratore della rete Edge (roles/edgenetwork.admin) in your Google Cloud project.

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 Google Cloud regione 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 Distributed Cloud connessa, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi avere il ruolo Visualizzatore della rete Edge (roles/edgenetwork.viewer) in your Google Cloud project.

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 Google Cloud regione 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 delprogetto di destinazione Google Cloud .
  • REGION: la Google Cloud regione 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 di nomi di campi separati da virgole in base ai quali vengono ordinati i risultati restituiti. L'ordinamento predefinito è crescente; per l'ordinamento decrescente, anteponi il campo desiderato con ~.
  • 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.

Ottieni 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 della rete Edge (roles/edgenetwork.viewer) in your Google Cloud project.

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 Google Cloud regione 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 delprogetto di destinazione Google Cloud .
  • REGION: la Google Cloud regione 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: è in corso il provisioning della risorsa; devi attendere che sia stata propagata in tutta la zona.
  • RUNNING: è stato eseguito il provisioning della risorsa e la risorsa è stata propagata in tutta la zona; è pronta per l'uso.
  • FAILED: il provisioning della risorsa non è andato a buon fine; la risorsa non è stata propagata in tutta la zona.

Controlla 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 della rete Edge (roles/edgenetwork.viewer) in your Google Cloud project.

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 Google Cloud regione 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 delprogetto di destinazione Google Cloud .
  • REGION: la Google Cloud regione 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 descritti in questa sezione.

Per completare questa attività, devi avere il ruolo Amministratore della rete Edge (roles/edgenetwork.admin) in your Google Cloud project.

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 Google Cloud regione 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 delprogetto di destinazione Google Cloud .
  • REGION: la Google Cloud regione 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