Créer un MIG utilisant le mode groupé

Console

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

   Accéder à la page Modèles d'instances

2. Cliquez sur Créer un modèle d'instance. La page Créer un modèle d'instance s'ouvre.

3. Dans le champ Nom, saisissez un nom pour le modèle d'instance.

4. Dans la section Emplacement, sélectionnez l'une des options suivantes :

   • Pour créer un modèle d'instance régional, sélectionnez Régional (recommandé), puis sélectionnez la région dans laquelle créer le modèle.

   • Pour créer un modèle d'instance global, sélectionnez Global.

5. Dans la section Configuration de la machine, spécifiez un type de machine.

6. Dans la section Modèle de provisionnement, procédez comme suit :

   1. Développez Paramètres avancés du modèle de provisionnement de la VM.

   2. Dans la liste À l'arrêt de la VM, sélectionnez Supprimer.

7. Facultatif : pour modifier le type ou l'image de disque de démarrage par défaut, cliquez sur Modifier dans la section Disque de démarrage. Suivez ensuite les instructions pour modifier le disque de démarrage.

8. Développez la section Options avancées et procédez comme suit :

   1. Développez la section Gestion.

   2. Dans la section Réservations, sélectionnez Choisir une réservation, puis cliquez sur Choisir une réservation. Dans le volet qui s'affiche, suivez les instructions pour sélectionner la réservation que vous souhaitez utiliser.

9. Cliquez sur Créer.

gcloud

Pour créer un modèle d'instance, utilisez la commande instance-templates create avec les paramètres d'indicateur suivants :

• L'option --instance-termination-action est définie sur DELETE.

• L'option --maintenance-policy est définie sur TERMINATE.

• L'option --provisioning-model est définie sur RESERVATION_BOUND.

• L'option --reservation-affinity est définie sur specific.

• L'indicateur --reservation

L'exemple de commande suivant crée un modèle d'instance régional. Si vous souhaitez créer un modèle d'instance global, utilisez la même commande sans le flag --instance-template-region.

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

Remplacez les éléments suivants :

• INSTANCE_TEMPLATE_NAME : nom du modèle d'instance à créer.

• IMAGE_PROJECT : projet contenant l'image, par exemple, debian-cloud. Pour en savoir plus sur les projets d'image compatibles, consultez la page Images publiques.

• IMAGE_FAMILY : famille d'images. Spécifiez une famille d'images pour utiliser l'image d'OS non obsolète la plus récente. Par exemple, si vous spécifiez debian-12, la dernière version de la famille d'images Debian 12 est utilisée. Pour en savoir plus sur l'utilisation des familles d'images, consultez la page Bonnes pratiques concernant les familles d'images.

• REGION : région dans laquelle créer le modèle d'instance.

• MACHINE_TYPE : type de machine spécifié dans la réservation que vous souhaitez utiliser.

• RESERVATION_URL : URL de la réservation créée automatiquement pour une réservation future en mode Agenda que vous souhaitez utiliser. Spécifiez une des valeurs suivantes :

  • Si la réservation créée automatiquement existe dans votre projet : RESERVATION_NAME.

  • Si la réservation créée automatiquement existe dans un autre projet : projects/PROJECT_ID/reservations/RESERVATION_NAME.

REST

Pour créer un modèle d'instance, envoyez une requête POST à l'une des méthodes suivantes :

• Pour créer un modèle d'instance régional : méthode regionInstanceTemplates.insert

• Pour créer un modèle d'instance global : méthode instanceTemplates.insert

Dans le corps de la requête, incluez les champs suivants :

• Le champ reservationAffinity.consumeReservationType est défini sur SPECIFIC_RESERVATION.

• Le champ reservationAffinity.key est défini sur compute.googleapis.com/reservation-name.

• Le champ reservationAffinity.values défini sur l'URL de la réservation créée automatiquement.

• Le champ scheduling.instanceTerminationAction défini sur DELETE.

• Le champ scheduling.onHostMaintenance défini sur TERMINATE.

• Le champ scheduling.provisioningModel défini sur RESERVATION_BOUND.

Par exemple, pour créer un modèle d'instance régional, envoyez une requête comme suit :

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "reservationAffinity": {
      "consumeReservationType": "SPECIFIC_RESERVATION",
      "key": "compute.googleapis.com/reservation-name",
      "values": [
        "RESERVATION_URL"
      ]
    },
    "scheduling": {
      "instanceTerminationAction": "DELETE",
      "onHostMaintenance": "TERMINATE",
      "provisioningModel": "RESERVATION_BOUND"
    }
  }
}

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet dans lequel créer le modèle d'instance.

• REGION : région dans laquelle créer le modèle d'instance.

• INSTANCE_TEMPLATE_NAME : nom du modèle d'instance à créer.

• IMAGE_PROJECT : projet contenant l'image, par exemple, debian-cloud. Pour en savoir plus sur les projets d'image compatibles, consultez la page Images publiques.

• IMAGE : spécifiez l'une des options suivantes :

  • Une version spécifique de l'image de l'OS. Exemple : debian-12-bookworm-v20240617.

  • Une famille d'images, qui doit être au format family/IMAGE_FAMILY. Spécifiez une famille d'images pour utiliser l'image d'OS non obsolète la plus récente. Par exemple, si vous spécifiez family/debian-12, la dernière version de la famille d'images Debian 12 est utilisée. Pour en savoir plus sur l'utilisation des familles d'images, consultez Bonnes pratiques pour les familles d'images.

• MACHINE_TYPE : type de machine spécifié dans la réservation que vous souhaitez consommer.

• RESERVATION_URL : URL de la réservation créée automatiquement pour une réservation future en mode Agenda que vous souhaitez utiliser. Spécifiez une des valeurs suivantes :

  • Si la réservation créée automatiquement existe dans votre projet : RESERVATION_NAME

  • Si la réservation créée automatiquement existe dans un autre projet : projects/PROJECT_ID/reservations/RESERVATION_NAME

Console

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

   Accéder à la page Modèles d'instances

2. Cliquez sur Créer un modèle d'instance. La page Créer un modèle d'instance s'ouvre.

3. Dans le champ Nom, saisissez un nom pour le modèle d'instance.

4. Dans la section Emplacement, sélectionnez l'une des options suivantes :

   • Pour créer un modèle d'instance régional, sélectionnez Régional (recommandé), puis sélectionnez la région dans laquelle créer le modèle.

   • Pour créer un modèle d'instance global, sélectionnez Global.

5. Dans la section Configuration de la machine, spécifiez un type de machine.

6. Dans la section Modèle de provisionnement, procédez comme suit :

   1. Dans le champ Modèle de provisionnement de VM, sélectionnez Démarrage flexible.

   2. Développez Paramètres avancés du modèle de provisionnement de la VM.

   3. Cochez la case Définir une limite de temps pour la VM.

   4. Pour définir une durée d'exécution pour les VM créées à l'aide du modèle d'instance, saisissez le nombre d'heures dans le champ Saisissez le nombre d'heures. La valeur doit être comprise entre 36 secondes (0.01) et sept jours (168).

7. Facultatif : pour modifier le type ou l'image de disque de démarrage par défaut, cliquez sur Modifier dans la section Disque de démarrage. Suivez ensuite les instructions pour modifier le disque de démarrage.

8. Cliquez sur Créer.

gcloud

Pour créer un modèle d'instance, utilisez la commande instance-templates create avec les paramètres d'indicateur suivants :

• L'option --instance-termination-action est définie sur DELETE.

• L'option --maintenance-policy est définie sur TERMINATE.

• L'indicateur --max-run-duration

• L'option --provisioning-model est définie sur FLEX_START.

• L'option --reservation-affinity est définie sur none.

L'exemple de commande suivant crée un modèle d'instance régional. Si vous souhaitez créer un modèle d'instance global, utilisez la même commande sans le flag --instance-template-region.

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --image-project=IMAGE_PROJECT \
    --image-family=IMAGE_FAMILY \
    --instance-template-region=REGION \
    --instance-termination-action=DELETE \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=TERMINATE \
    --max-run-duration=RUN_DURATION \
    --provisioning-model=FLEX_START \
    --reservation-affinity=none

Remplacez les éléments suivants :

• INSTANCE_TEMPLATE_NAME : nom du modèle d'instance à créer.

• IMAGE_PROJECT : projet contenant l'image, par exemple, debian-cloud. Pour en savoir plus sur les projets d'image compatibles, consultez la page Images publiques.

• IMAGE_FAMILY : famille d'images. Spécifiez une famille d'images pour utiliser l'image d'OS non obsolète la plus récente. Par exemple, si vous spécifiez debian-12, la dernière version de la famille d'images Debian 12 est utilisée. Pour en savoir plus sur l'utilisation des familles d'images, consultez la page Bonnes pratiques concernant les familles d'images.

• REGION : région dans laquelle créer le modèle d'instance.

• MACHINE_TYPE : type de machine à utiliser pour les VM à démarrage flexible. Si vous spécifiez un type de machine N1, vous devez inclure l'option --accelerator pour définir le nombre et le type de GPU à associer à vos VM.

• RUN_DURATION : durée d'exécution des VM demandées. Vous devez formater la valeur en nombre de jours, d'heures, de minutes ou de secondes, suivis respectivement de d, h, m et s. Par exemple, spécifiez 30m pour 30 minutes ou 1d2h3m4s pour un jour, deux heures, trois minutes et quatre secondes. Cette valeur doit être comprise entre 10 minutes et 7 jours.

REST

Pour créer un modèle d'instance, envoyez une requête POST à l'une des méthodes suivantes :

• Pour créer un modèle d'instance régional : méthode regionInstanceTemplates.insert

• Pour créer un modèle d'instance global : méthode instanceTemplates.insert

Dans le corps de la requête, incluez les champs suivants :

• Le champ reservationAffinity.consumeReservationType est défini sur NO_RESERVATION.

• Le champ scheduling.instanceTerminationAction défini sur DELETE.

• Le champ scheduling.maxRunDuration.

• Le champ scheduling.onHostMaintenance défini sur TERMINATE.

• Le champ scheduling.provisioningModel défini sur FLEX_START.

L'exemple de requête suivant crée un modèle d'instance régional :

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "reservationAffinity": {
      "consumeReservationType": "NO_RESERVATION"
    },
    "scheduling": {
      "instanceTerminationAction": "DELETE",
      "maxRunDuration": {
        "seconds": RUN_DURATION
      },
      "onHostMaintenance": "TERMINATE",
      "provisioningModel": "FLEX_START"
    }
  }
}

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet dans lequel créer le modèle d'instance.

• REGION : région dans laquelle créer le modèle d'instance.

• INSTANCE_TEMPLATE_NAME : nom du modèle d'instance à créer.

• IMAGE_PROJECT : projet contenant l'image, par exemple, debian-cloud. Pour en savoir plus sur les projets d'image compatibles, consultez la page Images publiques.

• IMAGE : spécifiez l'une des options suivantes :

  • Une version spécifique de l'image de l'OS. Exemple : debian-12-bookworm-v20240617.

  • Une famille d'images, qui doit être au format family/IMAGE_FAMILY. Spécifiez une famille d'images pour utiliser l'image d'OS non obsolète la plus récente. Par exemple, si vous spécifiez family/debian-12, la dernière version de la famille d'images Debian 12 est utilisée. Pour en savoir plus sur l'utilisation des familles d'images, consultez Bonnes pratiques pour les familles d'images.

• MACHINE_TYPE : type de machine à utiliser pour les VM. Si vous spécifiez un type de machine N1, vous devez inclure le champ guestAccelerators pour définir le nombre et le type de GPU à associer à vos VM.

• RUN_DURATION : durée, en secondes, pendant laquelle vous souhaitez que les VM demandées s'exécutent. La valeur doit être comprise entre 600, soit 600 secondes (10 minutes), et 604800, soit 604 800 secondes (7 jours).

Console

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

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

2. Cliquez sur Créer un groupe d'instances. La page Créer un groupe d'instances s'ouvre.

3. Dans le champ Nom, saisissez un nom pour le MIG.

4. Avant de sélectionner un modèle d'instance, vous devez effectuer les opérations suivantes :

   1. Si vous utilisez le modèle de provisionnement Démarrage flexible, vous devez désactiver les réparations comme suit :
      1. Dans la section Cycle de vie des instances de VM, décochez la case Autoriser la réparation des VM dans une autre zone.
      2. Dans la liste Action par défaut en cas d'échec, sélectionnez Aucune action.
   2. Dans la section Emplacement, procédez comme suit :
      • Pour créer un MIG zonal, sélectionnez Zone unique.
      • Pour créer un MIG régional, sélectionnez Plusieurs zones. Dans Forme de distribution cible, sélectionnez Une des zones. Dans la boîte de dialogue qui s'affiche, sélectionnez Désactiver la redistribution des instances.

5. Revenez au champ Modèle d'instance. Dans la liste Modèle d'instance, sélectionnez le modèle d'instance que vous avez créé dans la section précédente.

6. Dans le champ Nombre d'instances, spécifiez le nombre d'instances que vous souhaitez créer simultanément.

7. Cochez la case Obtenir toutes les VM à la fois à l'aide d'une règle de taille cible groupée.

8. Cliquez sur Créer.

gcloud

Pour créer un MIG pour lequel la création groupée est activée, utilisez la commande gcloud compute instance-groups managed create avec l'option --target-size-policy-mode définie sur bulk.

Si vous utilisez le modèle de provisionnement à démarrage flexible, vous devez désactiver les réparations dans le MIG en incluant l'option --default-action-on-vm-failure=do-nothing dans les commandes suivantes.

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

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --size=SIZE \
    --target-size-policy-mode=bulk \
    --template=INSTANCE_TEMPLATE_URL \
    --zone=ZONE \

• Pour créer un MIG régional, exécutez la commande suivante :

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --size=SIZE \
    --target-size-policy-mode=bulk \
    --template=INSTANCE_TEMPLATE_URL \
    --zones=LIST_OF_ZONES \

Remplacez les éléments suivants :

• INSTANCE_GROUP_NAME : nom du MIG.
• SIZE : nombre d'instances 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 le MIG crée des instances.
• LIST_OF_ZONES : liste des zones, séparées par une virgule, dans lesquelles le MIG régional crée des instances. Exemple : us-central1-a, us-central1-b, us-central1-c.

REST

Pour créer un MIG pour lequel la création groupée est activée, envoyez une requête POST comme suit. Dans le corps de la requête, définissez le champ targetSizePolicy.mode sur bulk.

Si vous utilisez le modèle de provisionnement à démarrage flexible, vous devez désactiver les réparations dans le MIG en incluant le champ "instanceLifecyclePolicy": {"defaultActionOnFailure": "DO_NOTHING"} dans les requêtes suivantes.

• Pour créer un MIG zonal, envoyez une requête POST à la méthode instanceGroupManagers.insert.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers
  
  {
    "name": "INSTANCE_GROUP_NAME",
    "targetSize": SIZE,
    "targetSizePolicy": {
      "mode": "bulk"
    },
    "versions": [
      {
        "instanceTemplate": "INSTANCE_TEMPLATE_URL"
      }
    ]
  }
  

• Pour créer un MIG régional, envoyez une requête POST à la méthode regionInstanceGroupManagers.insert.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers
  
  {
    "name": "INSTANCE_GROUP_NAME",
    "targetSize": SIZE,
    "targetSizePolicy": {
      "mode": "bulk"
    },
    "versions": [
      {
        "instanceTemplate": "INSTANCE_TEMPLATE_URL"
      }
    ]
  }
  

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet.
• ZONE : zone dans laquelle le MIG crée des instances.
• REGION : région dans laquelle le MIG crée des instances.
• INSTANCE_GROUP_NAME : nom du MIG.
• SIZE : nombre d'instances 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