Conectar uma TPU a uma rede VPC compartilhada

Importante: neste guia, explicamos como configurar Cloud TPUs que usam uma rede VPC compartilhada gerenciada centralmente. Este documento pressupõe que você já conhece as VPCs e criou uma VPC compartilhada. Para mais informações sobre como criar e gerenciar redes VPC compartilhada, consulte Criar e modificar VPC compartilhada compartilhadas.

Configurar um projeto host da VPC

É necessário conceder à conta de serviço da TPU no projeto de serviço permissões para gerenciar recursos no projeto host. Para fazer isso, use o papel "Agente de VPC compartilhada para TPU" (roles/tpu.xpnAgent). Execute os comandos gcloud a seguir para conceder essa vinculação de função.

gcloud projects add-iam-policy-binding host-project-id \
--member=serviceAccount:[e-mail] \
--role=roles/tpu.xpnAgent

Observação: o número do projeto de serviço pode ser encontrado na seção de informações do projeto do painel do console do Google Cloud.

Criar uma VM TPU conectada a uma rede VPC compartilhada

Primeiro, determine quais tipos e versões de aceleradores estão disponíveis na zona.

gcloud compute tpus accelerator-types list --zone zone

gcloud compute tpus versions list --zone zone

Você conecta uma VM da TPU a uma rede VPC compartilhada ao criar a TPU. Especifique sua VPC compartilhada usando a tag --network:

gcloud compute tpus tpu-vm create tpu-name \
   --zone zone \
   --accelerator-type accelerator-type \
   --network projects/host-project-id/global/networks/host-network \
   --version tpu-image-version \
   --project your-service-project-id

Observação: a tag --network precisa ser definida como o nome de rede totalmente qualificado. Por exemplo, projects/my-host-project-id/global/networks/my-network.

É possível verificar se a VM da TPU está conectada à VPC compartilhada usando o comando gcloud describe:

$ gcloud compute tpus tpu-vm describe tpu-name --zone zone

A resposta inclui a rede à qual a VM de TPU está anexada:

acceleratorType: v3-8
apiVersion: V2
cidrBlock: 10.128.0.0/20
createTime: '2022-06-17T21:32:13.859274143Z'
health: HEALTHY
id: '0000000000000000000'
name: projects/my-project/locations/us-central1-b/nodes/my-tpu
networkConfig:
  enableExternalIps: true
  network: projects/my-project/global/networks/default
  subnetwork: projects/my-project/regions/us-central1/subnetworks/default
networkEndpoints:
- accessConfig:
    externalIp: 000.000.000.000
  ipAddress: 10.128.0.104
  port: 8470
runtimeVersion: tpu-vm-tf-2.8.0
schedulingConfig: {}
serviceAccount:
  email: [e-mail]
  scope:
  - https://www.googleapis.com/auth/devstorage.read_write
  - https://www.googleapis.com/auth/logging.write
  - https://www.googleapis.com/auth/service.management
  - https://www.googleapis.com/auth/servicecontrol
  - https://www.googleapis.com/auth/cloud-platform
  - https://www.googleapis.com/auth/pubsub
shieldedInstanceConfig: {}
state: READY

Excluir a VM da TPU

Quando terminar de usar a VM de TPU, exclua-a.

gcloud compute tpus tpu-vm delete tpu-name --zone zone