Consumir uma reserva

Se você tiver uma reserva de TPU, use os recursos reservados para criar TPUs que correspondam às propriedades da reserva. Essa ação é conhecida como consumir uma reserva. Para saber como consumir uma reserva de TPU usando o GKE, consulte Reserva de TPU na documentação do GKE.

Consumir uma reserva específica

Ao criar recursos com o comando gcloud alpha compute tpus queued-resources create, use a flag --reservation para especificar o nome da reserva a ser consumida. Para reservas adiantadas criadas no modo de calendário, você também precisa definir a flag --provisioning-model como reservation-bound:

gcloud alpha compute tpus queued-resources create QUEUED_RESOURCE_ID \
    --node-id=TPU_NAME \
    --zone=ZONE \
    --accelerator-type=ACCELERATOR_TYPE \
    --runtime-version=SOFTWARE_VERSION \
    --reservation=RESERVATION_URL \
    --provisioning-model=reservation-bound # Only required for calendar mode

Substitua as seguintes variáveis de marcador de posição:

  • QUEUED_RESOURCE_ID: um ID atribuído pelo usuário para a solicitação de recurso em fila.
  • TPU_NAME: um ID (nome) atribuído pelo usuário para a TPU criada quando a solicitação de recurso em fila é alocada.
  • ZONE: a zona em que a VM de TPU será criada. Para mais informações sobre zonas disponíveis, consulte Regiões e zonas.
  • ACCELERATOR_TYPE: especifica a versão e o tamanho do Cloud TPU a ser criado. Para mais informações sobre os tipos de acelerador disponíveis em cada versão de TPU, consulte Versões de TPU.
  • SOFTWARE_VERSION: a versão do software do Cloud TPU.
  • RESERVATION_URL: o URL da reserva. Especifique um dos seguintes valores:
    • Se a reserva estiver no projeto: RESERVATION_NAME
    • Se a reserva estiver em outro projeto e seu projeto puder consumir essa reserva: projects/OWNER_PROJECT_ID/reservations/RESERVATION_NAME

Consumir qualquer reserva correspondente

Use a flag --reserved para determinar automaticamente a reserva a ser usada com base no tipo de acelerador, no ID do projeto e na zona.

CreateNode

Para consumir qualquer reserva correspondente usando a API CreateNode, utilize o comando gcloud alpha compute tpus tpu-vm create com a flag --reserved:

gcloud alpha compute tpus tpu-vm create TPU_NAME \
    --zone=ZONE \
    --accelerator-type=ACCELERATOR_TYPE \
    --version=SOFTWARE_VERSION \
    --reserved

Substitua as seguintes variáveis de marcador de posição:

  • TPU_NAME: um nome para a TPU.
  • ZONE: a zona em que a VM de TPU será criada, que precisa corresponder à zona da reserva.
  • ACCELERATOR_TYPE: especifica a versão e o tamanho do Cloud TPU a ser criado. Para mais informações sobre os tipos de acelerador disponíveis em cada versão de TPU, consulte Versões de TPU.
  • SOFTWARE_VERSION: a versão do software do Cloud TPU.

Recursos em fila

Para consumir qualquer reserva correspondente usando recursos em fila, utilize o comando gcloud alpha compute tpus queued-resources create com a flag --reserved:

gcloud alpha compute tpus queued-resources create QUEUED_RESOURCE_ID \
    --node-id=TPU_NAME \
    --zone=ZONE \
    --accelerator-type=ACCELERATOR_TYPE \
    --runtime-version=SOFTWARE_VERSION \
    --reserved

Substitua as seguintes variáveis de marcador de posição:

  • QUEUED_RESOURCE_ID: um ID atribuído pelo usuário para a solicitação de recurso em fila.
  • TPU_NAME: um ID (nome) atribuído pelo usuário para a TPU criada quando a solicitação de recurso em fila é alocada.
  • ZONE: a zona em que a VM de TPU será criada e onde a reserva existe.
  • ACCELERATOR_TYPE: especifica a versão e o tamanho do Cloud TPU a ser criado. Para mais informações sobre os tipos de acelerador disponíveis em cada versão de TPU, consulte Versões de TPU.
  • SOFTWARE_VERSION: a versão do software do Cloud TPU.

Verificar o uso da reserva

Só é possível verificar o uso de uma reserva compartilhada no projeto do proprietário. Se você estiver em um projeto de consumidor, mude para o projeto do proprietário para verificar o uso da reserva.

Para saber quanto da reserva está em uso, utilize o comando gcloud compute reservations describe:

gcloud compute reservations describe RESERVATION_NAME \
    --project=PROJECT_ID --zone=ZONE

Substitua as seguintes variáveis de marcador de posição:

  • RESERVATION_NAME: o nome da reserva.
  • PROJECT_ID: o ID do projeto que contém a reserva.
  • ZONE: a zona em que a reserva existe.

Para listar todas as reservas em um projeto, use o comando gcloud compute reservations list:

gcloud compute reservations list --project=PROJECT_ID

Substitua a seguinte variável de marcador de posição:

  • PROJECT_ID: o ID do projeto.

A seguir