Creare e gestire le reti

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

I server Distributed Cloud connessi vengono forniti con una singola rete preconfigurata, la rete Distributed Cloud predefinita. I server Distributed Cloud connessi non supportano la configurazione di reti aggiuntive.

Per saperne di più sulle reti Distributed Cloud, consulta la pagina Come funziona Distributed Cloud connesso.

Tieni presente che:

  • Puoi creare fino a 100 reti per zona Distributed Cloud.
  • Una rete è una rete privata virtuale di cui viene creata un'istanza all'interno della zona di destinazione.
  • Viene creata un'istanza della rete come funzione di routing virtuale (VRF).
  • I pacchetti vengono instradati in modo indipendente all'interno di una rete.
  • Se il progetto della zona Google Cloud e il progetto del cluster Google Cloud sono diversi, devi concedere l'autorizzazione del progetto del cluster Google Cloud nel progetto della zona Google Cloud per consentire l'accesso all'API Edge Network. Per istruzioni, consulta Autorizzare le azioni nei cluster utilizzando il controllo dell'accesso basato sui ruoli.

Crea una rete

Per creare una rete Distributed Cloud, completa i passaggi descritti in questa sezione.

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

gcloud

Utilizza il comando gcloud edge-cloud networking networks create:

gcloud edge-cloud networking networks create NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --mtu=MTU_SIZE

Sostituisci quanto segue:

  • NETWORK_NAME: un nome descrittivo che identifica in modo univoco questa rete.
  • REGION: the Google Cloud region a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.
  • MTU_SIZE: la dimensione dell'unità massima di trasmissione (MTU) per questa rete. I valori validi sono 1500 e 9000. Questo valore deve corrispondere alla dimensione MTU della rete default ed essere uguale per tutte le reti.

API

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

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks?networkId=NETWORK_ID
{
 "labels": { LABELS,
  },
 "mtu": { MTU_SIZE,
  },
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID delprogetto di destinazione Google Cloud .
  • REGION: the Google Cloud region a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud di destinazione.
  • NETWORK_ID: un ID univoco che identifica questa rete.
  • LABELS: un elenco di etichette da applicare a questa risorsa di rete.
  • MTU_SIZE: la dimensione dell'unità massima di trasmissione (MTU) per questa rete. I valori validi sono 1500 e 9000.

Elenca reti

Per elencare le reti Distributed Cloud 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 di Edge Network (roles/edgenetwork.viewer) nel tuo Google Cloud progetto.

gcloud

Utilizza il comando gcloud edge-cloud networking networks list:

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

Sostituisci quanto segue:

  • REGION: the Google Cloud region 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.networks.list:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID delprogetto di destinazione Google Cloud .
  • REGION: the Google Cloud region a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud 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'ordine di ordinamento predefinito è crescente; per l'ordine di 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.

Recupera informazioni su una rete

Per recuperare informazioni su una rete Distributed Cloud, completa i passaggi descritti in questa sezione.

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

gcloud

Utilizza il comando gcloud edge-cloud networking networks describe:

gcloud edge-cloud networking networks describe NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • NETWORK_NAME: il nome della rete di destinazione.
  • REGION: the Google Cloud region 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.networks.get:

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_ID

Sostituisci quanto segue:

  • PROJECT_ID: l'ID delprogetto di destinazione Google Cloud .
  • REGION: the Google Cloud region a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.
  • NETWORK_ID: l'ID della rete di destinazione.

Controlla lo stato operativo di una rete

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

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

gcloud

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

gcloud edge-cloud networking networks get-status NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • NETWORK_NAME: il nome della rete di destinazione.
  • REGION: the Google Cloud region 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.networks.diagnose:

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_ID:diagnose

Sostituisci quanto segue:

  • PROJECT_ID: l'ID delprogetto di destinazione Google Cloud .
  • REGION: the Google Cloud region a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.
  • NETWORK_ID: l'ID della rete di destinazione.

Elimina una rete

Per eliminare una rete Distributed Cloud, completa i passaggi descritti in questa sezione.

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

gcloud

Utilizza il comando gcloud edge-cloud networking networks delete:

gcloud edge-cloud networking networks delete NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • NETWORK_NAME: il nome della rete di destinazione.
  • REGION: the Google Cloud region 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.networks.delete:

 DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_ID

Sostituisci quanto segue:

  • PROJECT_ID: l'ID delprogetto di destinazione Google Cloud .
  • REGION: the Google Cloud region a cui appartiene la zona Distributed Cloud connessa di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa di destinazione.
  • NETWORK_ID: l'ID della rete di destinazione.

Passaggi successivi