Ajouter et supprimer des VM dans un MIG

---

Après avoir créé un groupe d'instances géré (MIG), vous pouvez ajouter des VM dans ce groupe ou en supprimer pour répondre aux besoins de votre charge de travail. Si vous avez atteint la valeur par défautlimite pour le nombre maximal de VM que vous pouvez ajouter à un MIG et que vous avez besoin de plus de VM, vous pouvezaugmenter La taille maximale du groupe d'instances géré.

Pour ajouter ou supprimer des VM dans un MIG, vous pouvez effectuer les opérations suivantes :

• Ajouter ou supprimer automatiquement des VM en définissant la taille cible du MIG :
  • Utiliser l'autoscaling pour les applications sans état
  • Définir manuellement la taille du MIG
• Ajouter, supprimer ou abandonner des instances spécifiques manuellement :
  • Créer des instances avec des noms spécifiques
  • Supprimer des instances spécifiques
  • Abandonner des instances spécifiques

Avant de commencer

• Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine comme suit :
  

  Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

  Console

  Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud, vous n'avez pas besoin de configurer l'authentification.

  gcloud

  1. Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante :

     gcloud init

     Remarque : Si vous avez déjà installé gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant gcloud components update.
  2. Définissez une région et une zone par défaut.

  Terraform

  Pour utiliser les exemples Terraform de cette page dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez le service Identifiants par défaut de l'application à l'aide de vos identifiants utilisateur.

  1. Installez Google Cloud CLI.

  2. Pour initialiser gcloudCLI, exécutez la commande suivante :

     gcloud init

  3. Créez des identifiants d'authentification locaux pour votre compte Google :

     gcloud auth application-default login

  Pour en savoir plus, consultez les sections sur Configurer l'authentification pour un environnement de développement local.

  REST

  Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.

  Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante :

  gcloud init

Définir la taille cible du groupe

Vous pouvez définir automatiquement la taille cible d'un MIG à l'aide d'un autoscaler ou la définir manuellement.

Ajouter et supprimer automatiquement des VM dans un MIG

Vous pouvez configurer des groupes d'instances gérés pour ajouter ou supprimer automatiquement des VM en fonction de leurs charges de travail. Cela permet à vos applications de gérer de façon optimale les hausses de trafic, et vous aide à réduire vos coûts lorsque les besoins en ressources de calcul sont moins importants. Pour découvrir comment effectuer le scaling de vos groupes d'instances gérés, consultez la page Créer un MIG avec autoscaling.

Pour en savoir plus, consultez la page Effectuer l'autoscaling des groupes d'instances.

Définir manuellement la taille d'un MIG

Si un groupe d'instances géré n'est pas déjà configuré pour le scaling automatique, vous pouvez le redimensionner manuellement afin de modifier le nombre d'instances qui le composent. Lorsque vous augmentez sa taille, le groupe d'instances géré exploite le modèle d'instance actuel pour ajouter de nouvelles instances. Si vous diminuez la taille, le groupe d'instances géré supprime les VM du groupe. Le groupe supprime d'abord les instances dont le champ currentAction correspond à DELETING, CREATING ou RECREATING avant de supprimer les instances en cours d'exécution sans action planifiée.

Si le groupe fait partie d'un service de backend sur lequel le drainage de connexion est activé, le retrait ou la suppression de l'instance de VM peut prendre jusqu'à 60 secondes après la fin de la période de drainage.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

• compute.instanceGroupManagers.update sur le groupe d'instances géré

Console

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

   Accéder à la page "Groupes d'instances"

2. Dans la colonne Nom de la liste, cliquez sur le nom du groupe dont vous souhaitez modifier la taille.

3. Cliquez sur Modifier pour modifier le groupe d'instances géré.

4. Dans la section Nombre d'instances, spécifiez le nombre d'instances que vous souhaitez inclure au sein du groupe. Si l'autoscaling est activé, le groupe ajoute ou supprime automatiquement des instances, si nécessaire. Vous pouvez toutefois modifier les champs Nombre minimal d'instances et Nombre maximal d'instances pour ajuster indirectement la taille du groupe par le biais d'un autoscaler.

5. Cliquez sur Enregistrer pour appliquer le nouveau modèle.

gcloud

Exécutez la commande resize.

gcloud compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size NEW_SIZE \
    --zone ZONE

REST

Appelez la méthode resize pour une ressource de MIG zonal ou régional. Spécifiez la nouvelle taille du groupe d'instances en tant que paramètre.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resize?size=NEW_SIZE

Si le groupe d'instances est un groupe d'instances géré régional, remplacez zones/ZONE par regions/REGION :

Après avoir effectué une requête pour redimensionner un groupe d'instances géré, les VM démarrent ou s'arrêtent dès que le système est en mesure de les provisionner ou de les supprimer. Ce processus peut prendre un certain temps selon le nombre d'instances au sein du groupe. Vérifiez l'état des instances de votre groupe d'instances géré.

Remarque : Comme les nouvelles VM sont créées avec le modèle d'instance actuel, votre groupe peut contenir des VM différentes si vous y ajoutez des instances après avoir modifié le modèle d'instance. Les VM existantes utilisent le modèle d'instance précédent jusqu'à ce qu'elles soient recrées, tandis que les nouvelles VM exploite le modèle actuellement spécifié pour le MIG.

Désactiver le mode de répétition des tentatives de création lors du redimensionnement

Bêta

Ce produit est soumis aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les produits pré-DG sont disponibles "en l'état" et peuvent bénéficier d'une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Par défaut, si la création initiale d'une instance de VM échoue, le groupe d'instances géré tente de créer la VM en continu jusqu'à ce que l'opération aboutisse. Toutefois, si vous ne souhaitez pas effectuer automatiquement de nouvelles tentatives de création, vous pouvez désactiver le mode de répétition des tentatives de création lors du redimensionnement du groupe d'instances. Lorsque ce mode est activé, le groupe d'instances géré n'essaie de créer toutes les instances qu'une seule fois. Si une erreur se produit lors de la création de l'instance, le groupe d'instances géré abandonne cette instance, la supprime de la liste des instances gérées du groupe et diminue la taille cible du groupe d'instances géré.

Ce mode ne s'applique que lors de la première tentative de création d'une VM. Si la création réussit lorsque ce mode est activé, la VM se comporte de la même manière que toutes les autres VM créées avec une requête de redimensionnement standard. Plus précisément si une VM en cours d'exécution cesse de fonctionner de manière inattendue et doit être recréée par la suite, ce mode n'affecte pas le comportement de la recréation dans ce scénario.

Il est particulièrement utile de désactiver le mode de répétition des tentatives de création lorsque des systèmes créent automatiquement des groupes de VM qui n'ont pas besoin de disposer d'un nombre exact de VM. Vous préférerez peut-être choisir rapidement une taille fixe pour votre groupe d'instances géré et vous être plus flexible quant au nombre de VM, plutôt que d'attendre indéfiniment la fin de la création de toutes les instances demandées (qui pourrait être retardée de façon temporaire ou permanente en raison d'erreurs de quotas ou d'autres problèmes).

Limites

• Vous ne pouvez pas désactiver les tentatives de création d'un MIG régional avec une forme de distribution cible EVEN.
• Pour les MIG régionaux avec une forme de distribution cible BALANCED ou ANY_SINGLE_ZONE, vous devez désactiver la redistribution proactive des instances pour pouvoir désactiver le mode de tentatives de création.
• Vous ne pouvez pas désactiver les tentatives de création des MIG avec autoscaling.

Pour redimensionner un groupe d'instances géré lorsque le mode de répétition des tentatives de création est désactivé, utilisez Google Cloud CLI ou REST.

Important : Nous vous recommandons de ne pas exécuter simultanément deux opérations de redimensionnement avec différents modes de répétition des tentatives de création, car cela risque d'entraîner une taille cible inattendue. Par exemple, si vous exécutez une commande de redimensionnement sans nouvelles tentatives de création et que, pendant son exécution, vous exécutez une deuxième commande de redimensionnement avec les nouvelles tentatives de création activées, la deuxième commande n'invalide pas la première. Certaines instances sont créées sans nouvelle tentative. Si l'une d'entre elles échoue, la taille cible du groupe diminue en conséquence.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

• compute.instanceGroupManagers.update sur le groupe d'instances géré

gcloud

Exécutez la commande bêta resize avec l'option --no-creation-retries.

gcloud beta compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size NEW_SIZE \
    --no-creation-retries \
    [--region REGION | --zone ZONE]

Remplacez les éléments suivants :

• INSTANCE_GROUP_NAME : nom du MIG que vous souhaitez redimensionner.
• NEW_SIZE : nombre cible d'instances en cours d'exécution dans le groupe d'instances géré.
• ZONE: pour les MIG zonaux, zone où se trouve le MIG.
• REGION : pour les MIG régionaux, région où se trouve le MIG.

REST

Pour un MIG zonal, utilisez la méthode instanceGroupManagers.resizeAdvanced bêta ou, pour un MIG régional, la méthode regionInstanceGroupManagers.resizeAdvanced bêta. Spécifiez la nouvelle taille du groupe et le champ noCreationRetries dans le corps de la requête.

Par exemple, effectuez l'appel suivant pour redimensionner un MIG zonal dont le mode de répétition des tentatives de création est désactivé.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeAdvanced

{
 "targetSize": NEW_SIZE,
 "noCreationRetries": true
}

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet
• ZONE : zone où se trouve le MIG. Pour un MIG régional, remplacez zones/ZONE par regions/REGION et spécifiez une région. Pour en savoir plus, consultez la page À propos des MIG régionaux.
• INSTANCE_GROUP_NAME : nom du MIG que vous souhaitez redimensionner.

• NEW_SIZE : nombre cible d'instances en cours d'exécution dans le groupe d'instances géré.

  Vous pouvez répertorier les instances en cours de création et vérifier leur mode de création à l'aide de la méthode listManagedInstances. Lorsque le mode de répétition des tentatives de création est désactivé, le champ currentAction des instances que vous créez est défini sur CREATING_WITHOUT_RETRIES.

Ajouter, supprimer ou abandonner des instances spécifiques

Créer des instances avec des noms spécifiques dans les MIG

Si votre système dépend de noms spécifiques, vous pouvez ajouter des VM avec ces noms à un MIG existant.

Les noms que vous attribuez à ces instances gérées sont conservés si le MIG recrée la VM. Pour en savoir plus sur la conservation de l'état des instances de MIG, consultez la page Groupes d'instances gérés avec état.

Limites

Respectez les conditions suivantes lorsque vous créez des instances avec des noms spécifiques :

• Vous devez désactiver l'autoscaling pendant le processus de création de l'instance.
• Vous devez définir la règle de mise à jour du MIG sur Quand l'occasion se présente.
• Si vous mettez à jour un groupe d'instances géré régional :
  • Vous devez désactiver la redistribution proactive des instances.
  • Vous ne pouvez pas sélectionner la zone dans laquelle la VM doit être créée.
• Vous ne pouvez pas utiliser de noms d'instance de VM en double dans un projet.

Vous pouvez utiliser gcloud CLI ou REST pour ajouter des VM avec des noms spécifiques à un MIG existant.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

• compute.instanceGroupManagers.update sur le groupe d'instances géré

gcloud

Exécutez la commande instance-groups managed create-instance.

gcloud compute instance-groups managed create-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    [--region REGION | --zone ZONE]

Remplacez l'élément suivant :

• INSTANCE_GROUP_NAME est le nom du groupe d'instances géré régional ou zonal auquel ajouter une instance.
• INSTANCE_NAME est le nom que vous souhaitez attribuer à la nouvelle instance.

REST

Envoyez une requête POST à la méthode regionInstanceGroupManagers.createInstances. Pour un groupe d'instances géré zonal, utilisez la méthode instanceGroupManagers.createInstances. Dans le corps de la requête, incluez le champ instances avec les noms d'une ou de plusieurs instances.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/createInstances
{
  "instances": [
    {
      "name": "INSTANCE_NAME_1"
    },
    {
      "name": "INSTANCE_NAME_2"
    }
  ]
}

Supprimer des instances spécifiques d'un groupe

Vous pouvez supprimer des instances de VM individuelles dans un groupe d'instances géré. Cette opération réduit la valeur targetSize spécifiée pour le groupe d'instances et retire les VM des pools cibles auxquels elles appartiennent.

La suppression d'instances spécifiques appartenant à un groupe géré n'entraîne aucune modification des paramètres définis pour l'autoscaler. Si vous supprimez des instances d'un groupe géré, l'autoscaler est susceptible de détecter une augmentation de la charge de travail sur les autres instances du groupe, et de lui réattribuer sa taille précédente. Pour éviter cela, arrêtez l'autoscaler avant d'essayer de supprimer les instances.

Si le groupe fait partie d'un service de backend sur lequel le drainage de connexion est activé, le retrait ou la suppression de l'instance de VM peut prendre jusqu'à 60 secondes après la fin de la période de drainage.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

• compute.instanceGroupManagers.update sur le groupe d'instances géré

Console

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

   Accéder à la page "Groupes d'instances"

2. Dans la colonne Nom de la liste, cliquez sur le nom du groupe qui contient les instances individuelles que vous souhaitez supprimer. La page qui s'ouvre affiche les propriétés du groupe, ainsi que la liste des instances qui en font partie.

3. Dans la section Membres, dans la liste des instances, sélectionnez une ou plusieurs instances à supprimer.

4. Cliquez sur Supprimer l'instance. Les instances sélectionnées sont supprimées.

gcloud

Pour supprimer une instance avec gcloud CLI, utilisez la commande instance-groups managed delete-instances :

gcloud compute instance-groups managed delete-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAME_1,INSTANCE_NAME_2 \
    [--region REGION | --zone ZONE]

La commande renvoie l'état de l'opération par instance :

• SUCCESS est renvoyé si gcloud CLI a supprimé l'instance.
• FAIL est renvoyé pour toutes les instances si une instance spécifiée dans la requête n'est pas membre du groupe, si un membre est déjà supprimé ou abandonné, ou si la requête échoue pour toute autre raison.
• SKIPPED n'est renvoyé que si vous utilisez l'option --skip-instances-on-validation-error, et que l'instance ne fait pas partie du groupe ou est déjà en cours de suppression ou d'abandon.
• MEMBER_NOT_FOUND n'est renvoyé que pour les groupes régionaux lorsque gcloud CLI n'a pas pu résoudre la zone à partir du nom de l'instance.

Si vous pensez que votre requête de suppression peut entrer en conflit avec des opérations simultanées, utilisez l'option --skip-instances-on-validation-error. Cette option spécifie si la requête doit être traitée même si elle inclut des instances qui ne font pas partie du groupe ou qui sont déjà en cours de suppression ou d'abandon (par exemple, des instances supprimées par un autoscaler). Par défaut, si vous omettez cette option et qu'une instance de ce type est spécifiée dans la requête, l'opération échoue. L'opération échoue toujours si la requête contient un nom d'instance mal formaté ou une référence à une instance qui se trouve dans une zone ou une région autre que celle du groupe.

Par exemple, la commande suivante demande la suppression de quatre instances, mais trois d'entre elles ne font plus partie du groupe :

gcloud compute instance-groups managed delete-instances example-mig \
    --instances=example-instance-1,example-instance-2,example-instance-3,example-instance-4 \
    --region=us-central1 \
    --skip-instances-on-validation-error

Dans cet exemple, trois instances n'ont pas pu être validées. Elles ont donc été ignorées, tandis que example-instance-3 a été supprimé :

Updated [https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceGroupManagers/example-mig].
PROJECT          ZONE           INSTANCE               STATUS   VALIDATION_ERROR
example-project  us-central1-a  example-instance-1     SKIPPED  Cannot delete instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-1 that was already deleted.
example-project  us-central1-a  example-instance-2     SKIPPED  Cannot delete instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-2 that was already abandoned.
example-project  us-central1-a  example-instance-3     SUCCESS
example-project  us-central1-a  example-instance-4     SKIPPED  Cannot find instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-4.

Si vous omettez l'option --skip-instances-on-validation-error et qu'une instance ne réussit pas la validation, aucune instance n'est supprimée :

gcloud compute instance-groups managed delete-instances example-mig \
    --instances=example-instance-1,example-instance-2,example-instance-3,example-instance-4 \
    --region=us-central1

Updated [https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceGroupManagers/example-mig].
PROJECT          ZONE             INSTANCE              STATUS
example-project  us-central1-a    example-instance-1    FAIL
example-project  us-central1-a    example-instance-2    FAIL
example-project  us-central1-a    example-instance-3    FAIL
example-project  us-central1-a    example-instance-4    FAIL

REST

Envoyez une requête POST à la méthode regionInstanceGroupManagers.deleteInstances. Pour un groupe d'instances géré zonal, utilisez la méthode instanceGroupManagers.deleteInstances.

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

{
  "instances": [
    "zones/ZONE/instances/INSTANCE_NAME_1",
    "zones/ZONE/instances/INSTANCE_NAME_2"
   ]
}

Si vous pensez que votre requête de suppression peut entrer en conflit avec des opérations simultanées, utilisez le champ skipInstancesOnValidationError. Ce champ spécifie si la requête doit être traitée même si elle inclut des instances qui ne font pas partie du groupe ou qui sont déjà en cours de suppression ou d'abandon (par exemple, des instances supprimées par un autoscaler). Par défaut, si vous omettez cette option et qu'une instance de ce type est spécifiée dans la requête, l'opération échoue. L'opération échoue toujours si la requête contient un nom d'instance mal formaté ou une référence à une instance qui se trouve dans une zone ou une région autre que celle du groupe.

Par exemple, la requête suivante de suppression de deux instances aboutit même si l'une des instances est déjà supprimée ou en cours de suppression :

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

{
 "instances": [
  "zones/ZONE/instances/INSTANCE_NAME_1",
  "zones/ZONE/instances/INSTANCE_NAME_2"
 ],
 "skipInstancesOnValidationError": true
}

Vous pouvez afficher les instances ignorées lors de l'opération en affichant l'opération. Pour les MIG régionaux, utilisez la méthode regionOperations.get. Pour les MIG zonaux, utilisez la méthode zoneOperations.get. Les avertissements sont répertoriés dans le champ d'avertissement de l'opération.

Une fois votre requête de suppression d'instances envoyée, les instances s'arrêtent dès que le système est en mesure de les supprimer. Ce processus peut prendre un certain temps selon le nombre d'instances que vous supprimez du groupe. Vérifiez l'état du groupe ou vérifiez l'état des instances gérées.

Abandonner des instances d'un groupe d'instances géré

Vous pouvez séparer une instance de VM d'un groupe d'instances géré pour déboguer plus facilement des problèmes liés à des instances individuelles sans affecter le groupe dans son ensemble. Lorsque vous abandonnez une instance, elle est également retirée des équilibreurs de charge attribués au groupe d'instances géré. Les pools cibles qui ont été manuellement assignés à des instances individuelles spécifiques ne sont pas retirés.

Lorsqu'une instance de VM a été abandonnée, vous ne pouvez pas l'ajouter de nouveau au groupe. Le fait d'abandonner des instances réduit la taille cible (targetSize) spécifiée pour le groupe d'instances, mais cela n'entraîne aucune modification des paramètres définis pour l'autoscaler. Les groupes d'instances gérés dotés d'un autoscaler continuent d'ajouter ou de retirer automatiquement des instances, si nécessaire. Pour un MIG régional avec l'autoscaling défini sur le mode ONLY_SCALE_OUT, si vous abandonnez une instance de VM pour réduire la taille de la cible du MIG à la taille recommandée par l'autoscaler, l'autoscaler peut créer une instance de VM dans la même zone de la VM abandonnée. Dans ce cas, pour éviter de créer une instance de VM, essayez d'abandonner l'instance de VM dans une zone différente.

Si le groupe fait partie d'un service de backend sur lequel le drainage de connexion est activé, le retrait ou la suppression de l'instance de VM peut prendre jusqu'à 60 secondes après la fin de la période de drainage.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

• compute.instanceGroupManagers.update sur le groupe d'instances géré

Console

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

   Accéder à la page "Groupes d'instances"

2. Dans la colonne Nom de la liste, cliquez sur le nom du groupe qui contient les instances que vous souhaitez retirer. La page qui s'ouvre affiche les propriétés du groupe ainsi que la liste des instances qui en font partie.

3. Dans la section Membres, sélectionnez une ou plusieurs instances à retirer du groupe dans la liste des instances.

4. Cliquez sur Retirer du groupe. Les instances sélectionnées ne font plus partie du groupe, mais continuent de s'exécuter en dehors de celui-ci.

gcloud

Pour retirer une instance du groupe d'instances sans supprimer la VM, exécutez la commande instance-groups managed abandon-instances.

gcloud compute instance-groups managed abandon-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAME_1,INSTANCE_NAME_2 \
    [--region REGION | --zone ZONE]

REST

Envoyez une requête POST à la méthode regionInstanceGroupManagers.abandonInstances. Pour un groupe d'instances géré zonal, utilisez la méthode instanceGroupManagers.abandonInstances.

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

{
 "instances": [
  "zones/ZONE/instances/INSTANCE_NAME_1",
  "zones/ZONE/instances/INSTANCE_NAME_2"
 ]
}

Une fois votre requête d'abandon d'instances envoyée, le groupe retire les instances dès que possible. Vérifiez l'état du groupe ou vérifiez l'état des instances gérées.

Augmenter la taille maximale du groupe

Par défaut, la taille maximale d'un MIG zonal est de 1 000 VM et la taille maximale d'un MIG régional est de 2 000 VM. Vous pouvez augmenter ces limites à 2 000 VM pour un MIG zonal et à 4 000 VM pour un MIG régional.

Pour augmenter les limites, définissez le champ listManagedInstancesResults du groupe sur PAGINATED. Si vous avez besoin de plus de VM dans le groupe, créez plusieurs MIG ou contactez l'assistance.

Attention : Lorsque vous définissez le champ listManagedInstancesResults du groupe sur PAGINATED, la méthode listManagedInstances modifie son comportement. Avec le paramètre PAGELESS par défaut, la méthode "list" ignore le paramètre de requête maxResults et renvoie toujours toutes les instances. Avec le paramètre PAGINATED, la méthode list renvoie un résultat paginé avec maxResults limité à 500 comme les autres listes dans Compute Engine. Vous devez vous assurer que tous les appels à ces méthodes connaissent la pagination et utilisent le paramètre de requête pageToken pour parcourir une longue liste d'instances.

Il n'y a aucun impact sur la CLI Google Cloud ou la console Google Cloud qui sont déjà entièrement compatibles avec la pagination.

Console

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

   Accéder à la page "Groupes d'instances"

2. Dans la colonne Nom de la liste, cliquez sur le nom du groupe d'instances dont vous souhaitez augmenter la limite de taille.

3. Cliquez sur Modifier pour modifier le groupe d'instances.

4. Développez la section des paramètres avancés en cliquant sur Afficher la configuration avancée.

5. Sous Résultats de l'appel d'API de liste d'instances gérée, sélectionnez l'option Pagination.

6. Cliquez sur Enregistrer pour appliquer les modifications.

gcloud

Pour un MIG existant, utilisez la commande update :

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --list-managed-instances-results=PAGINATED

Pour un nouveau MIG, utilisez la commande create :

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template INSTANCE_TEMPLATE \
    --size SIZE \
    --list-managed-instances-results=PAGINATED

Terraform

Pour augmenter la limite de taille d'un MIG, définissez l'argument list_managed_instances_results sur PAGINATED.

L'exemple suivant augmente la taille maximale d'un MIG zonal. Pour en savoir plus sur la ressource utilisée dans l'exemple, consultez la section consacrée à la ressource google_compute_instance_group_manager. Pour un MIG régional, utilisez la ressource google_compute_region_instance_group_manager.

compute/zonal_mig_paginated_instances_result/main.tf

Afficher sur GitHub Commentaires

resource "google_compute_instance_group_manager" "default" {
  name                           = "my-igm"
  base_instance_name             = "test"
  target_size                    = 7
  zone                           = "us-central1-f"
  list_managed_instances_results = "PAGINATED"
  version {
    instance_template = google_compute_instance_template.default.id
    name              = "primary"
  }
}

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez la page Commandes Terraform de base.

REST

Pour un MIG zonal existant, utilisez la méthode instanceGroupManagers.patch ou, pour un MIG régional, utilisez la méthode regionInstanceGroupManagers.patch – Par exemple :

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/region/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME

{
  "listManagedInstancesResults": "PAGINATED",
}

Pour un nouveau MIG zonal, utilisez la méthode instanceGroupManagers.insert ou, pour un MIG régional, la méthode regionInstanceGroupManagers.insert.

Si vous souhaitez revenir aux résultats de liste sans pagination, vous devez également rétablir la taille minimale par défaut de ce groupe. Pour revenir en arrière, assurez-vous d'abord que le groupe ne dépasse pas sa taille limite par défaut, puis définissez le champ listManagedInstancesResults sur PAGELESS.

Étape suivante

• Découvrez comment utiliser des instances gérées, par exemple comment les supprimer, les abandonner et les recréer.
• Consultez des informations sur les groupes d'instances gérés et les instances gérées.
• Résoudre les problèmes liés aux groupes d'instances gérés