Utiliser une réservation

Si vous disposez d'une réservation TPU, vous pouvez utiliser vos ressources réservées pour créer des TPU correspondant aux propriétés de la réservation. Cette action est appelée utilisation d'une réservation. Pour savoir comment utiliser une réservation TPU lorsque vous utilisez Google Kubernetes Engine (GKE), consultez TPU reservation dans la documentation GKE.

La façon dont vous utilisez une réservation dépend de la façon dont vous créez vos VM TPU. Vous pouvez créer des instances de VM TPU ou un MIG avec des TPU.

Utiliser une réservation lors de la création d'une VM TPU

Lorsque vous créez une instance de VM TPU, spécifiez la réservation à utiliser à l'aide des --reservation-affinity et --reservation paramètres :

  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

Remplacez les espaces réservés suivants :

  • TPU_NAME : nom de votre VM TPU.
  • MACHINE_TYPE : type de machine pour la VM TPU (par exemple, ct6e-standard-8t).
  • IMAGE_FAMILY : famille d'images d'OS pour la VM TPU. Si vous souhaitez installer une version d'OS spécifique, utilisez l'indicateur --image. Pour en savoir plus sur les images d'OS, consultez Images d'OS.
  • IMAGE_PROJECT : projet contenant l'image d'OS. Pour les images TPU, il s'agit de ubuntu-os-accelerator-images.
  • ZONE : zone de la VM TPU (par exemple, us-central1-b).
  • PROJECT_ID : ID du projet pour lequel la réservation a été effectuée.
  • RESERVATION_NAME : nom de la réservation au format projects/OWNER_PROJECT_ID/reservations/RESERVATION_NAME.

Utiliser une réservation lors de la création d'un MIG

Vous pouvez créer deux types de MIG avec des VM TPU :

  • MIG avec des tranches à hôte unique.
  • MIG avec une tranche multi-hôte.

Utiliser une réservation lorsque vous créez un MIG avec des tranches à hôte unique

Pour utiliser une réservation lorsque vous créez un MIG avec des tranches à hôte unique, vous spécifiez la réservation dans le modèle d'instance.

Pour créer un MIG avec des tranches à hôte unique :

  1. Créer un modèle d'instance
  2. Facultatif : Créer une règle de charge de travail
  3. Créer des MIG

Créer un modèle d'instance qui utilise une réservation

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

Remplacez les espaces réservés suivants :

  • INSTANCE_TEMPLATE_NAME : nom de votre modèle d'instance.
  • MACHINE_TYPE : type de machine pour la VM TPU (par exemple, ct6e-standard-8t).
  • RESERVATION_NAME : nom de la réservation au format projects/OWNER_PROJECT_ID/reservations/RESERVATION_NAME.
  • IMAGE_FAMILY : famille d'images d'OS pour la VM TPU. Si vous souhaitez installer une version d'OS spécifique, utilisez l'indicateur --image. Pour en savoir plus sur les images d'OS, consultez Images d'OS.
  • IMAGE_PROJECT : projet contenant l'image d'OS. Pour les images TPU, il s'agit de ubuntu-os-accelerator-images.

Créer le MIG

Vous pouvez créer un MIG zonal ou un MIG régional.

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

Remplacez les espaces réservés suivants :

  • MIG_NAME : nom de votre MIG.
  • SIZE : nombre de VM TPU dans le MIG.
  • INSTANCE_TEMPLATE_NAME : nom de votre modèle d'instance.
  • ZONE : zone dans laquelle vous souhaitez provisionner votre MIG.
Créer un MIG régional
gcloud compute instance-groups managed create MIG_NAME \
    --size=SIZE \
    --template=INSTANCE_TEMPLATE_NAME\
    --region=REGION \
    --target-distribution-shape=any

Remplacez les espaces réservés suivants :

  • MIG_NAME : nom de votre MIG.
  • SIZE : nombre de VM TPU dans le MIG.
  • INSTANCE_TEMPLATE_NAME : nom de votre modèle d'instance.
  • REGION : zone dans laquelle vous souhaitez provisionner votre MIG.

Pour en savoir plus sur l'indicateur --target-distribution-shape, consultez Définir une forme de distribution cible pour les VM d'un MIG régional.

Utiliser une réservation lorsque vous créez un MIG avec une tranche multi-hôte

Pour utiliser une réservation lorsque vous créez un MIG avec une tranche multi-hôte, vous spécifiez la réservation dans le modèle d'instance.

Créer un modèle d'instance qui utilise une réservation

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

Remplacez les espaces réservés suivants :

  • INSTANCE_TEMPLATE_NAME : nom de votre modèle d'instance.
  • MACHINE_TYPE : type de machine pour la VM TPU (par exemple, ct6e-standard-8t).
  • RESERVATION_NAME : nom de la réservation au format projects/OWNER_PROJECT_ID/reservations/RESERVATION_NAME.
  • IMAGE_FAMILY : famille d'images d'OS pour la VM TPU. Si vous souhaitez installer une version d'OS spécifique, utilisez l'indicateur --image. Pour en savoir plus sur les images d'OS, consultez Images d'OS.
  • IMAGE_PROJECT : projet contenant l'image d'OS. Pour les images TPU, il s'agit de ubuntu-os-accelerator-images.

Créer une règle de charge de travail

Vous pouvez spécifier une règle de charge de travail pour vos MIG. Pour en savoir plus, consultez Règle de charge de travail pour les MIG.

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

Remplacez les espaces réservés suivants :

  • WORKLOAD_POLICY_NAME : nom de votre règle de charge de travail.
  • TOPOLOGY : topologie des VM TPU, par exemple 4x4x8. Pour en savoir plus sur la topologie de chaque version de TPU, consultez Versions de TPU.

Créer le MIG

Vous pouvez créer un MIG zonal ou régional.

Créer 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

Remplacez les espaces réservés suivants :

  • MIG_NAME : nom de votre MIG.
  • SIZE : nombre de VM TPU dans le MIG.
  • INSTANCE_TEMPLATE_URL: URL du modèle d'instance que vous souhaitez utiliser pour créer des instances dans le MIG. L'URL peut contenir l' ID ou le nom du modèle d'instance. Spécifiez une des valeurs suivantes :
    • Pour un modèle d'instance régional : projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • Pour un modèle d'instance global : INSTANCE_TEMPLATE_ID
  • ZONE : zone dans laquelle vous souhaitez provisionner votre MIG.
  • WORKLOAD_POLICY_URL : URL de la règle de charge de travail que vous souhaitez utiliser pour créer des instances dans le MIG. Exemple : projects/PROJECT_ID/regions/WORKLOAD_POLICY_REGION/resourcePolicies/WORKLOAD_POLICY_NAME
Créer un MIG régional
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

Remplacez les espaces réservés suivants :

  • MIG_NAME : nom de votre MIG.
  • SIZE : nombre de VM TPU dans le MIG.
  • INSTANCE_TEMPLATE_URL: URL du modèle d'instance que vous souhaitez utiliser pour créer des instances dans le MIG. L'URL peut contenir l' ID ou le nom du modèle d'instance. Spécifiez une des valeurs suivantes :
    • Pour un modèle d'instance régional : projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • Pour un modèle d'instance global : INSTANCE_TEMPLATE_ID
  • ZONE : zone dans laquelle vous souhaitez provisionner votre MIG.
  • WORKLOAD_POLICY_URL : URL de la règle de charge de travail que vous souhaitez utiliser pour créer des instances dans le MIG. Exemple : projects/PROJECT_ID/regions/WORKLOAD_POLICY_REGION/resourcePolicies/WORKLOAD_POLICY_NAME

Vérifier l'utilisation des réservations

Vous ne pouvez vérifier l'utilisation des réservations partagées que depuis le projet propriétaire. Si vous vous trouvez dans un projet consommateur, vous devez passer au projet propriétaire pour vérifier l'utilisation de la réservation.

Pour savoir dans quelle mesure la réservation est utilisée, exécutez la gcloud compute reservations describe commande :

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

Remplacez les variables d'espace réservé suivantes :

  • RESERVATION_NAME : nom de la réservation.
  • PROJECT_ID : ID du projet contenant la réservation.
  • ZONE : zone où se trouve la réservation.

Pour afficher la liste de toutes les réservations dans un projet, exécutez la commande gcloud compute reservations list :

gcloud compute reservations list --project=PROJECT_ID

Remplacez la variable d'espace réservé suivante :

  • PROJECT_ID : ID du projet.

Étapes suivantes