Afficher ou annuler la création groupée d'instances dans un MIG

Ce document explique comment afficher l'état de la création groupée d'instances de machine virtuelle (VM) dans un groupe d'instances géré (MIG). Il explique également comment annuler une création groupée en cours.

Pour savoir comment fonctionne la création groupée d'instances dans un MIG, consultez À propos de la création groupée d'instances dans un MIG.

Afficher l'état de la création groupée d'instances

Vous pouvez afficher l'état d'une opération de création groupée dans un MIG. L'état vous permet de vérifier si la création groupée est toujours en cours et, si les instances ne sont pas encore créées, d'en comprendre les raisons.

Les détails du MIG contiennent les champs suivants pour vous aider à surveiller l'état de la création groupée :

  • status.bulkInstanceOperation.inProgress : ce champ indique si une création groupée d'instances est en cours (true) ou non (false).

  • lastProgressCheck : ce champ fournit des informations sur les raisons pour lesquelles les instances n'ont peut-être pas encore été créées. Voici les raisons possibles :

    • Manque de capacité : lorsque le MIG attend que la capacité demandée devienne disponible, le code d'erreur ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS s'affiche.

    • Quota insuffisant : si le quota est insuffisant pour répondre à votre demande, l'erreur QUOTA_EXCEEDED s'affiche. Pour augmenter le quota de votre projet, consultez Demander un ajustement de quota.

gcloud

Pour afficher l'état de la création groupée d'instances dans un MIG, utilisez la commande gcloud compute instance-groups managed describe.

  • Pour un MIG zonal, exécutez la commande suivante :

    gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
        --zone=ZONE
    
  • Pour un MIG régional, exécutez la commande suivante :

    gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
        --region=REGION
    

    Remplacez les éléments suivants :

  • INSTANCE_GROUP_NAME : nom du MIG.

  • ZONE : zone où se trouve le MIG.

  • REGION : région où se trouve le MIG.

L'exemple suivant montre une réponse pour un MIG dans lequel une création groupée est en cours et le champ lastProgressCheck indique que la création groupée attend des ressources en raison d'une erreur ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS et comporte également une erreur QUOTA_EXCEEDED.

{
  "status": {
    "bulkInstanceOperation": {
      "inProgress": true,
      "lastProgressCheck": {
        "timestamp": "2024-01-01T12:00:00.712-08:00",
        "errors": [
          {
            "code": "ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS",
            "message": "Waiting for resources. Currently there are not enough resources available to fulfill the request."
          },
          {
            "code": "QUOTA_EXCEEDED",
            "message": "Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1."
          }
        ]
      }
    }
  }
}

REST

Pour afficher l'état de la création groupée d'instances dans un MIG, envoyez une requête GET comme suit :

  • Pour un MIG zonal, utilisez la méthode instanceGroupManagers.get.

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME
    
  • Pour un MIG régional, utilisez la méthode regionInstanceGroupManagers.get.

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME
    

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • ZONE : zone où se trouve le MIG.
  • REGION : région où se trouve le MIG.
  • INSTANCE_GROUP_NAME : nom du MIG.

L'exemple suivant montre une réponse pour un MIG dans lequel une création groupée est en cours et le champ lastProgressCheck indique que la création groupée attend des ressources en raison d'une erreur ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS et comporte également une erreur QUOTA_EXCEEDED.

{
  "status": {
    "bulkInstanceOperation": {
      "inProgress": true,
      "lastProgressCheck": {
        "timestamp": "2024-01-01T12:00:00.712-08:00",
        "errors": [
          {
            "code": "ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS",
            "message": "Waiting for resources. Currently there are not enough resources available to fulfill the request."
          },
          {
            "code": "QUOTA_EXCEEDED",
            "message": "Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1."
          }
        ]
      }
    }
  }
}

Afficher l'état des instances gérées

Vous pouvez surveiller l'état des instances gérées individuelles en vérifiant leur action en cours et leur état.

  • Pendant l'opération d'instance groupée, les instances gérées affichent les états suivants :

    • currentAction: CREATING
    • instanceStatus: PENDING
  • Une fois l'opération sur les instances groupées terminée, l'état des instances gérées passe à :

    • currentAction: NONE
    • instanceStatus: RUNNING

Pour afficher ces informations sur les instances gérées, consultez Vérifier l'état des instances gérées.

Annuler l'opération de création groupée

Pour annuler une opération de création groupée, redimensionnez le MIG à zéro ou supprimez-le.

Redimensionner le MIG à zéro

Console

  1. Accédez à la page Groupes d'instances.

    Accéder à la page Groupes d'instances

  2. Cliquez sur le nom du MIG que vous souhaitez redimensionner.

  3. Cliquez sur Modifier.

  4. Cliquez sur Taille du groupe et autoscaling pour développer la section.

  5. Définissez le nombre d'instances sur 0.

  6. Cliquez sur Enregistrer.

gcloud

Pour redimensionner un MIG à zéro, utilisez la commande gcloud compute instance-groups managed resize et définissez l'option --size sur 0.

  • Pour un MIG zonal, exécutez la commande suivante :

    gcloud compute instance-groups managed resize INSTANCE_GROUP_NAME \
        --size=0 \
        --zone=ZONE
    
  • Pour un MIG régional, exécutez la commande suivante :

    gcloud compute instance-groups managed resize INSTANCE_GROUP_NAME \
        --size=0 \
        --region=REGION
    

Remplacez les éléments suivants :

  • INSTANCE_GROUP_NAME : nom du MIG.
  • ZONE : zone où se trouve le MIG.
  • REGION : région où se trouve le MIG.
  • REST

    Pour redimensionner un MIG à zéro, envoyez une requête PATCH à l'aide de l'une des méthodes suivantes. Dans le corps de la requête, définissez targetSize sur 0.

    • Pour un MIG zonal, utilisez la méthode instanceGroupManagers.patch.

      PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME
      
      {
        "targetSize": 0
      }
      
    • Pour un MIG régional, utilisez la méthode regionInstanceGroupManagers.patch.

      PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME
      
      {
        "targetSize": 0
      }
      

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet.
    • ZONE : zone où se trouve le MIG.
    • REGION : région où se trouve le MIG.
    • INSTANCE_GROUP_NAME : nom du MIG.

Supprimer un groupe d'instances géré (MIG)

Console

  1. Dans la console Cloud de Confiance , accédez à la page Groupes d'instances.

    Accéder à la page Groupes d'instances

  2. Cochez la case correspondant au MIG que vous souhaitez supprimer.

  3. Cliquez sur Supprimer pour supprimer le MIG et toutes les instances qu'il contient.

gcloud

Pour supprimer un MIG, utilisez la commande delete.

  • Pour un MIG zonal, exécutez la commande suivante :

    gcloud compute instance-groups managed delete INSTANCE_GROUP_NAME \
        --zone ZONE
    
  • Pour un MIG régional, exécutez la commande suivante :

    gcloud compute instance-groups managed delete INSTANCE_GROUP_NAME \
        --region REGION
    

Remplacez les éléments suivants :

  • INSTANCE_GROUP_NAME : nom du MIG.
  • ZONE : zone où se trouve le MIG.
  • REGION : région où se trouve le MIG.

REST

Pour supprimer un MIG, envoyez une requête PATCH à l'aide de l'une des méthodes suivantes :

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • ZONE : zone où se trouve le MIG.
  • REGION : région où se trouve le MIG.
  • INSTANCE_GROUP_NAME : nom du MIG.

Étapes suivantes