Consume una reserva

Si tienes una reserva de TPU, puedes usar los recursos reservados para crear TPU que coincidan con las propiedades de la reserva. Esta acción se conoce como consumir una reserva. Para obtener información sobre cómo consumir una reserva de TPU cuando se usa Google Kubernetes Engine (GKE), consulta Reserva de TPU en la documentación de GKE.

La forma en que consumes una reserva depende de cómo crees tus VMs de TPU. Puedes crear instancias de VM de TPU o un MIG con TPU.

Consume una reserva cuando crees una VM de TPU

Cuando crees una instancia de VM de TPU, especifica la reserva que se consumirá con los parámetros --reservation-affinity y --reservation:

  gcloud compute instances create TPU_NAME \
    --machine-type=MACHINE_TYPE \
    --image-family=IMAGE_FAMILY \
    --image-project=IMAGE_PROJECT \
    --zone=ZONE \
    --reservation-affinity=specific \
    --reservation=projects/PROJECT_ID/reservations/RESERVATION_NAME \
    --provisioning-model=reservation-bound \
    --maintenance-policy=TERMINATE

Reemplaza los marcadores de posición que se indican más abajo:

  • TPU_NAME: Es el nombre de tu VM de TPU.
  • MACHINE_TYPE: Es el tipo de máquina de la VM de TPU (por ejemplo, ct6e-standard-8t).
  • IMAGE_FAMILY: Es la familia de imágenes del SO para la VM de TPU. Si deseas instalar una versión específica del SO, usa la marca --image. Para obtener más información sobre las imágenes de SO, consulta Imágenes de SO.
  • IMAGE_PROJECT: Es el proyecto que contiene la imagen de SO. Para las imágenes de TPU, es ubuntu-os-accelerator-images.
  • ZONE: Es la zona de la VM de TPU (por ejemplo, us-central1-b).
  • PROJECT_ID: Es el ID del proyecto para el que se hizo la reserva.
  • RESERVATION_NAME: Es el nombre de la reserva con el formato projects/OWNER_PROJECT_ID/reservations/RESERVATION_NAME.

Consume una reserva cuando crees un MIG

Existen dos tipos de MIG que puedes crear con VMs de TPU:

  • Son MIGs con porciones de host único.
  • Son los MIGs con una porción de varios hosts.

Consume una reserva cuando creas un MIG con segmentos de un solo host

Para consumir una reserva cuando creas un MIG con segmentos de un solo host, debes especificar la reserva como parte de la plantilla de instancias.

Para crear un MIG con segmentos de host único, haz lo siguiente:

  1. Crear plantilla de instancias
  2. Opcional: Crea una política de cargas de trabajo
  3. Crea MIG

Crea una plantilla de instancias que consuma una reserva

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
     --machine-type=MACHINE_TYPE \
     --maintenance-policy=TERMINATE \
     --instance-termination-action=DELETE \
     --reservation-affinity=specific \
     --provisioning-model=reservation-bound \
     --reservation=RESERVATION_NAME \
     --image-family=IMAGE_FAMILY \
     --image-project=IMAGE_PROJECT

Reemplaza los marcadores de posición que se indican más abajo:

  • INSTANCE_TEMPLATE_NAME: El nombre de la plantilla de instancias.
  • MACHINE_TYPE: Es el tipo de máquina de la VM de TPU (por ejemplo, ct6e-standard-8t).
  • RESERVATION_NAME: Es el nombre de la reserva con el formato projects/OWNER_PROJECT_ID/reservations/RESERVATION_NAME.
  • IMAGE_FAMILY: Es la familia de imágenes del SO para la VM de TPU. Si deseas instalar una versión específica del SO, usa la marca --image. Para obtener más información sobre las imágenes de SO, consulta Imágenes de SO.
  • IMAGE_PROJECT: Es el proyecto que contiene la imagen de SO. Para las imágenes de TPU, es ubuntu-os-accelerator-images.

Crea el MIG

Puedes crear un MIG zonal o un MIG regional.

Crea un MIG zonal
gcloud compute instance-groups managed create MIG_NAME \
    --size=SIZE \
    --template=INSTANCE_TEMPLATE_NAME \
    --zone=ZONE

Reemplaza los marcadores de posición que se indican más abajo:

  • MIG_NAME: Es el nombre de tu MIG.
  • SIZE: Es la cantidad de VMs de TPU en el MIG.
  • INSTANCE_TEMPLATE_NAME: El nombre de la plantilla de instancias.
  • ZONE: Es la zona en la que deseas que se aprovisione tu MIG.
Crea un MIG regional
gcloud compute instance-groups managed create MIG_NAME \
    --size=SIZE \
    --template=INSTANCE_TEMPLATE_NAME\
    --region=REGION \
    --target-distribution-shape=any

Reemplaza los marcadores de posición que se indican más abajo:

  • MIG_NAME: Es el nombre de tu MIG.
  • SIZE: Es la cantidad de VMs de TPU en el MIG.
  • INSTANCE_TEMPLATE_NAME: El nombre de la plantilla de instancias.
  • REGION: Es la zona en la que deseas que se aprovisione tu MIG.

Para obtener más información sobre la marca --target-distribution-shape, consulta Establece una forma de distribución objetivo para VM en un MIG regional.

Consume una reserva cuando creas un MIG con una división de varios hosts

Para consumir una reserva cuando creas un MIG con una segmentación de varios hosts, debes especificar la reserva como parte de la plantilla de instancias.

Crea una plantilla de instancias que consuma una reserva

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
     --machine-type=MACHINE_TYPE \
     --maintenance-policy=TERMINATE \
     --instance-termination-action=DELETE \
     --reservation-affinity=specific \
     --provisioning-model=reservation-bound \
     --reservation=RESERVATION_NAME \
     --image-family=IMAGE_FAMILY \
     --image-project=IMAGE_PROJECT

Reemplaza los marcadores de posición que se indican más abajo:

  • INSTANCE_TEMPLATE_NAME: El nombre de la plantilla de instancias.
  • MACHINE_TYPE: Es el tipo de máquina de la VM de TPU (por ejemplo, ct6e-standard-8t).
  • RESERVATION_NAME: Es el nombre de la reserva con el formato projects/OWNER_PROJECT_ID/reservations/RESERVATION_NAME.
  • IMAGE_FAMILY: Es la familia de imágenes del SO para la VM de TPU. Si deseas instalar una versión específica del SO, usa la marca --image. Para obtener más información sobre las imágenes de SO, consulta Imágenes de SO.
  • IMAGE_PROJECT: Es el proyecto que contiene la imagen de SO. Para las imágenes de TPU, es ubuntu-os-accelerator-images.

Crear una política de cargas de trabajo

Puedes especificar una política de cargas de trabajo para tus MIG. Para obtener más información, consulta la política de cargas de trabajo para MIGs.

gcloud compute resource-policies create workload WORKLOAD_POLICY_NAME \
  --type=high-throughput \
  --accelerator-topology=TOPOLOGY

Reemplaza los marcadores de posición que se indican más abajo:

  • WORKLOAD_POLICY_NAME: Es un nombre para tu política de carga de trabajo.
  • TOPOLOGY: Es la topología de las VMs de TPU, por ejemplo, 4x4x8. Para obtener más información sobre la topología de cada versión de TPU, consulta Versiones de TPU.

Crea el MIG

Puedes crear un MIG zonal o regional.

Crea un MIG zonal
gcloud compute instance-groups managed create MIG_NAME \
    --size=SIZE \
    --target-size-policy-mode=bulk \
    --default-action-on-vm-failure=do-nothing \
    --template=INSTANCE_TEMPLATE_URL \
    --zone=ZONE \
    --workload-policy=WORKLOAD_POLICY_URL

Reemplaza los marcadores de posición que se indican más abajo:

  • MIG_NAME: Es el nombre de tu MIG.
  • SIZE: Es la cantidad de VMs de TPU en el MIG.
  • INSTANCE_TEMPLATE_URL: Es la URL de la plantilla de instancias que deseas usar para crear instancias en el MIG. La URL puede contener el ID o el nombre de la plantilla de instancias. Especifica uno de los siguientes valores:
    • Para una plantilla de instancias regional: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • Para una plantilla de instancias global: INSTANCE_TEMPLATE_ID
  • ZONE: Es la zona en la que deseas que se aprovisione tu MIG.
  • WORKLOAD_POLICY_URL: Es la URL de la política de cargas de trabajo que deseas usar para crear instancias en el MIG. Por ejemplo: projects/PROJECT_ID/regions/WORKLOAD_POLICY_REGION/resourcePolicies/WORKLOAD_POLICY_NAME
Crea un MIG regional
gcloud compute instance-groups managed create MIG_NAME \
    --size=SIZE \
    --target-size-policy-mode=bulk \
    --default-action-on-vm-failure=do-nothing \
    --template=INSTANCE_TEMPLATE_URL \
    --zone=ZONE \
    --target-distribution-shape=any-single-zone \
    --instance-redistribution-type=none \
    --workload-policy=WORKLOAD_POLICY_URL

Reemplaza los marcadores de posición que se indican más abajo:

  • MIG_NAME: Es el nombre de tu MIG.
  • SIZE: Es la cantidad de VMs de TPU en el MIG.
  • INSTANCE_TEMPLATE_URL: Es la URL de la plantilla de instancias que deseas usar para crear instancias en el MIG. La URL puede contener el ID o el nombre de la plantilla de instancias. Especifica uno de los siguientes valores:
    • Para una plantilla de instancias regional: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • Para una plantilla de instancias global: INSTANCE_TEMPLATE_ID
  • ZONE: Es la zona en la que deseas que se aprovisione tu MIG.
  • WORKLOAD_POLICY_URL: Es la URL de la política de cargas de trabajo que deseas usar para crear instancias en el MIG. Por ejemplo: projects/PROJECT_ID/regions/WORKLOAD_POLICY_REGION/resourcePolicies/WORKLOAD_POLICY_NAME.

Verifica el uso de la reserva

Solo puedes verificar el uso de una reserva compartida desde su proyecto propietario. Si estás en un proyecto consumidor, debes cambiar al proyecto propietario para verificar el uso de la reserva.

Visualiza qué parte de la reserva está en uso con el comando gcloud compute reservations describe:

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

Reemplaza las siguientes variables de marcador de posición:

  • RESERVATION_NAME: el nombre de la reserva
  • PROJECT_ID: el ID del proyecto que contiene la reserva
  • ZONE: la zona en la que existe la reserva

Para enumerar todas las reservas en un proyecto, usa el comando gcloud compute reservations list.

gcloud compute reservations list --project=PROJECT_ID

Reemplaza la siguiente variable de marcador de posición:

  • PROJECT_ID: el ID del proyecto

¿Qué sigue?