Cluster GKE con Cloud TPU mediante un VPC condiviso

Avviso: i contenuti di questo documento si applicano solo alle TPU che utilizzano l'architettura dei nodi TPU. L'architettura dei nodi TPU è supportata solo in GKE su TPU v2 e v3. Se utilizzi l'architettura VM TPU, vedi Eseguire applicazioni TPU su Google Kubernetes Engine (GKE).

Questa guida descrive come:

• Configura un cluster GKE Cloud TPU utilizzando una rete VPC condiviso.
• Configura le API e gli intervalli IP richiesti per garantire la comunicazione tra il cluster, il VPC condiviso e i servizi gestiti da Google.
• Crea intervalli CIDR secondari per pod e servizi del cluster.

Concetti

Questi concetti verranno utilizzati di frequente in questa guida:

• Progetto host: un progetto che contiene una o più reti VPC condiviso. In questa guida, questo progetto conterrà il tuo VPC condiviso.

• Progetto di servizio: un progetto collegato a un progetto host da un amministratore di VPC condiviso. Questo collegamento gli consente di partecipare al VPC condiviso. In questa guida, questo progetto conterrà il tuo cluster Cloud TPU.

Requisiti

Nota: il cluster deve utilizzare GKE versione 1.11.3-gke.18 o successiva.

Abilita API

1. Abilita le seguenti API nella console Google Cloud per il tuo progetto host:

   • API Service Networking

2. Abilita le seguenti API nella console Google Cloud per il tuo progetto di servizio:

   • API Service Networking
   • API Cloud TPU

Configura l'intervallo IP per il peering VPC ai servizi gestiti da Google

Nota: questi passaggi devono essere eseguiti da un amministratore di rete (ruolo compute.networkAdmin) del progetto host.

Segui questi passaggi per prenotare un intervallo IP nella rete VPC condiviso nel progetto host. L'intervallo verrà utilizzato da tutti i servizi gestiti da Google in questa rete VPC. Cloud TPU è uno dei servizi gestiti da Google.

1. Elenca gli intervalli IP esistenti nella rete VPC condiviso.

   $ gcloud beta compute networks list-ip-addresses network \
   --project=host-project-id
   

2. Scegli un intervallo disponibile e prenotalo nella rete VPC condiviso.

   $ gcloud beta compute addresses create peering-name \
     --global \
     --prefix-length=16 \
     --network=network \
     --purpose=VPC_PEERING \
     --project=host-project-id
   

   peering-name specifica il nome della connessione di peering VPC. Il nome verrà utilizzato nel passaggio successivo.

3. Crea una connessione peering di rete VPC tra il progetto host e i servizi gestiti di Google.

   $ gcloud beta services vpc-peerings connect \
     --service=servicenetworking.googleapis.com \
     --network=network \
     --ranges=peering-name \
     --project=host-project-id
   

Crea intervalli IP secondari per il cluster

Nota: questi passaggi devono essere eseguiti da un amministratore di rete (ruolo compute.networkAdmin) del progetto host.

Nella tua rete VPC condiviso, seleziona o crea una subnet e aggiungi due intervalli CIDR secondari per i pod e i servizi del cluster.

• Crea una subnet VPC con intervalli CIDR secondari

• Aggiungi intervalli CIDR secondari a una subnet VPC esistente

Questi intervalli riguardano rispettivamente i pod e i servizi del cluster. I nomi degli intervalli verranno utilizzati nei passaggi seguenti.

• subnet sarà la subnet nella network del progetto host.

• tier-1-name sarà il nome dell'intervallo secondario utilizzato dai pod GKE in subnet.

• tier-2-name sarà il nome dell'intervallo secondario utilizzato dai servizi GKE in subnet.

Crea un cluster GKE con Cloud TPU

Il comando seguente mostra come creare un GKE utilizzando gli intervalli CIDR esistenti nella rete VPC condiviso, abilitando Cloud TPU:

$ gcloud beta container clusters create cluster-name \
  --enable-ip-alias \
  --network projects/host-project-id/global/networks/network \
  --subnetwork projects/host-project-id/regions/region/subnetworks/subnet \
  --cluster-secondary-range-name tier-1-name \
  --services-secondary-range-name tier-2-name \
  --scopes=cloud-platform \
  --enable-tpu \
  --enable-tpu-service-networking \
  --project=service-project-id

• Per ulteriori dettagli su questi flag, consulta la guida di riferimento dei comandi gcloud beta container clusters create.

Segui i passaggi relativi alle specifiche dei pod nella guida Eseguire applicazioni Cloud TPU su GKE per creare un job che utilizza le risorse Cloud TPU.

Esegui la pulizia

Quando hai finito di utilizzare Cloud TPU su GKE, elimina le risorse per evitare addebiti aggiuntivi sul tuo account di fatturazione Cloud.

1. Elimina l'intervallo IP di peering riservato.

   $ gcloud beta compute addresses delete peering-name \
     --global \
     --project=host-project-id
   

2. Segui le istruzioni in Pulizia in Configurazione di cluster con VPC condiviso per eliminare il cluster e le risorse di rete.