Créer des VM de manière groupée

gcloud

Pour créer des VM de manière groupée dans une région, exécutez la commande gcloud compute instances bulk create suivante :

gcloud compute instances bulk create \
    ( --name-pattern="NAME_PATTERN" | --predefined-names=[PREDEFINED_NAMES] ) \
    --region=REGION \
    --count=COUNT \
    [ --min-count=MIN_COUNT \ ]
    [--location-policy=LOCATION_POLICY \ ]
    [--target-distribution-shape=TARGET_DISTRIBUTION_SHAPE ]

Remplacez les éléments suivants :

• NAME_PATTERN : modèle de nom des VM. Utilisez une séquence de caractères de hachage (#) que Compute Engine remplacera par une séquence de nombres. Par exemple, le modèle de nom vm-# génère des VM portant les noms vm-1 et vm-2, etc., jusqu'à ce qu'il atteigne le nombre de VM spécifié par --count, qui doit être inférieur ou égal au nombre de VM autorisé par le modèle de nom.

  Lors de l'utilisation d'un modèle de nom, Compute Engine tente d'éviter les conflits de noms en vérifiant les noms des VM existantes créées à partir des requêtes précédentes.

• PREDEFINED_NAMES : liste des noms prédéfinis des VM à créer. Si vous utilisez cette option et spécifiez COUNT, COUNT doit être égal au nombre de noms fournis.

• REGION : région dans laquelle créer les VM.

• COUNT : nombre de VM à créer. Cette valeur doit être inférieure ou égale au nombre de VM autorisées par NAME_PATTERN. Si vous utilisez --predefined-names, vous n'avez pas besoin de spécifier COUNT, mais dans ce cas, la valeur doit être égale au nombre de noms fournis.

• MIN_COUNT : nombre minimal de VM à créer. Le tableau suivant décrit le comportement de la requête en fonction de la manière dont vous définissez cette option :

  Valeur	Description
  Non défini	La valeur par défaut est COUNT. Si Compute Engine ne peut pas créer le nombre de VM spécifié par COUNT, la requête échoue et aucune VM n'est créée.
  1	Compute Engine crée autant de VM que possible, jusqu'à COUNT.
  Supérieur à 1 et inférieur à COUNT	Compute Engine crée au moins MIN_COUNT VM et jusqu'à COUNT VM au maximum. Si les MIN_COUNT VM ne peuvent pas être créées, la requête échoue et aucune VM n'est créée.

• LOCATION_POLICY : zones à inclure ou exclure dans une région. Utilisez une liste de paires clé/valeur, avec la zone comme clé et la règle comme valeur. Les valeurs valides pour la règle sont allow (la valeur par défaut) et deny. Voici un exemple de valeur pour cette option :

  --location-policy=us-east1-b=allow,us-east1-c=deny
  

• TARGET_DISTRIBUTION_SHAPE : répartition des VM dans les zones spécifiées. Utilisez l'option --location-policy pour spécifier les zones. Le tableau suivant indique les valeurs valides pour cette option :

  Valeur	Description
  ANY_SINGLE_ZONE	Applique le placement de la VM dans une seule zone et donne la priorité à l'utilisation des réservations inutilisées. Utilisez cette option pour éviter toute sortie réseau interzone ou pour réduire la latence du réseau. Il s'agit de la valeur par défaut.
  BALANCED	Tente de répartir uniformément les VM dans toutes les zones de la région.
  ANY	Permet de répartir les VM dans plusieurs zones d'une région. Choisit les zones qui disposent de ressources disponibles et qui optimisent les réservations zonales non utilisées.

REST

Pour créer des VM de manière groupée dans une région, utilisez la méthode instances.bulkInsert suivante :

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

{
  ...
  "namePattern": "NAME_PATTERN",
  "perInstanceProperties": {
    "PREDEFINED_NAME_1": {},
    "PREDEFINED_NAME_2": {},
    ...
  },
  "count": COUNT,
  "minCount": MIN_COUNT,
  "locationPolicy": {
    "LOCATION_POLICY"
    },
    "targetShape": "TARGET_DISTRIBUTION_SHAPE"
  ...
}

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet.

• REGION : région dans laquelle créer les VM.

• NAME_PATTERN : modèle de nom des VM. Indiquez cette valeur ou perInstanceProperties. Utilisez une séquence de caractères de hachage (#) que Compute Engine remplacera par une séquence de nombres. Par exemple, le modèle de nom vm-# génère des VM portant les noms vm-1 et vm-2, etc., jusqu'à ce qu'il atteigne le nombre de VM spécifié par --count, qui doit être inférieur ou égal au nombre de VM autorisé par le modèle de nom.

  Lors de l'utilisation d'un modèle de nom, Compute Engine tente d'éviter les conflits de noms en vérifiant les noms des VM existantes créées à partir des requêtes précédentes.

• PREDEFINED_NAME_1, PREDEFINED_NAME_2, ... : liste des noms prédéfinis des VM à créer. Spécifiez cet élément ou namePattern. Si vous utilisez cette option et spécifiez COUNT, COUNT doit être égal au nombre de noms fournis.

• COUNT : nombre de VM à créer. Cette valeur doit être inférieure ou égale au nombre de VM autorisées par NAME_PATTERN. Si vous utilisez perInstanceProperties, vous n'avez pas besoin de spécifier COUNT, mais dans ce cas, la valeur doit être égale au nombre de noms fournis.

• MIN_COUNT : nombre minimal de VM à créer. Le tableau suivant décrit le comportement de la requête en fonction de la manière dont vous définissez cette option :

  Valeur	Description
  Non défini	La valeur par défaut est COUNT. Si Compute Engine ne peut pas créer le nombre de VM spécifié par COUNT, la requête échoue et aucune VM n'est créée.
  1	Compute Engine crée autant de VM que possible, jusqu'à COUNT.
  Supérieur à 1 et inférieur à COUNT	Compute Engine crée au moins MIN_COUNT VM et jusqu'à COUNT VM au maximum. Si les MIN_COUNT VM ne peuvent pas être créées, la requête échoue et aucune VM n'est créée.

• LOCATION_POLICY : zones à inclure ou exclure dans une région. Utilisez une liste de paires clé/valeur, avec la zone comme clé et la règle comme valeur. Les valeurs valides pour la règle sont ALLOW (la valeur par défaut) et DENY. Voici un exemple de valeur pour ce champ :

  "locations": {
    "zones/us-central1-a": { "preference": "ALLOW" },
    "zones/us-central1-c": { "preference": "DENY"  },
    ...
  },
  

• TARGET_DISTRIBUTION_SHAPE : répartition des VM dans les zones spécifiées. Utilisez le champ locationPolicy pour spécifier les zones. Le tableau suivant indique les valeurs valides pour ce champ :

  Valeur	Description
  ANY_SINGLE_ZONE	Applique le placement de la VM dans une seule zone et donne la priorité à l'utilisation des réservations inutilisées. Utilisez cette option pour éviter toute sortie réseau interzone ou pour réduire la latence du réseau. Il s'agit de la valeur par défaut.
  BALANCED	Tente de répartir uniformément les VM dans toutes les zones de la région.
  ANY	Permet de répartir les VM dans plusieurs zones d'une région. Choisit les zones qui disposent de ressources disponibles et qui optimisent les réservations zonales non utilisées.

gcloud

Pour créer des VM de manière groupée dans une zone spécifique, exécutez la commande gcloud compute instances bulk create suivante.

gcloud compute instances bulk create \
    ( --name-pattern="NAME_PATTERN" | --predefined-names=[PREDEFINED_NAMES] ) \
    --zone=ZONE \
    --count=COUNT \
    [ --min-count=MIN_COUNT ]

Remplacez les éléments suivants :

• NAME_PATTERN : modèle de nom des VM. Utilisez une séquence de caractères de hachage (#) que Compute Engine remplacera par une séquence de nombres. Par exemple, le modèle de nom vm-# génère des VM portant les noms vm-1 et vm-2, etc., jusqu'à ce qu'il atteigne le nombre de VM spécifié par --count, qui doit être inférieur ou égal au nombre de VM autorisé par le modèle de nom.

  Lors de l'utilisation d'un modèle de nom, Compute Engine tente d'éviter les conflits de noms en vérifiant les noms des VM existantes créées à partir des requêtes précédentes.

• PREDEFINED_NAMES : liste des noms prédéfinis des VM à créer. Si vous utilisez cette option et spécifiez COUNT, COUNT doit être égal au nombre de noms fournis.

• ZONE : zone dans laquelle créer les VM.

• COUNT : nombre de VM à créer. Cette valeur doit être inférieure ou égale au nombre de VM autorisées par NAME_PATTERN. Si vous utilisez --predefined-names, vous n'avez pas besoin de spécifier COUNT, mais dans ce cas, la valeur doit être égale au nombre de noms fournis.

• MIN_COUNT : nombre minimal de VM à créer. Le tableau suivant décrit le comportement de la requête en fonction de la manière dont vous définissez cette option :

  Valeur	Description
  Non défini	La valeur par défaut est COUNT. Si Compute Engine ne peut pas créer le nombre de VM spécifié par COUNT, la requête échoue et aucune VM n'est créée.
  1	Compute Engine crée autant de VM que possible, jusqu'à COUNT.
  Supérieur à 1 et inférieur à COUNT	Compute Engine crée au moins MIN_COUNT VM et jusqu'à COUNT VM au maximum. Si les MIN_COUNT VM ne peuvent pas être créées, la requête échoue et aucune VM n'est créée.

REST

Pour créer des VM de manière groupée dans une zone, utilisez la méthode instances.bulkInsert suivante.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  ...
  "namePattern": "NAME_PATTERN",
  "perInstanceProperties": {
    "PREDEFINED_NAME_1": {},
    "PREDEFINED_NAME_2": {},
    ...
  },
  "count": COUNT,
  "minCount": MIN_COUNT,
  ...
}

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet.

• ZONE : zone dans laquelle créer les VM.

• NAME_PATTERN : modèle de nom des VM. Indiquez cette valeur ou perInstanceProperties. Utilisez une séquence de caractères de hachage (#) que Compute Engine remplacera par une séquence de nombres. Par exemple, le modèle de nom vm-# génère des VM portant les noms vm-1 et vm-2, etc., jusqu'à ce qu'il atteigne le nombre de VM spécifié par --count, qui doit être inférieur ou égal au nombre de VM autorisé par le modèle de nom.

  Lors de l'utilisation d'un modèle de nom, Compute Engine tente d'éviter les conflits de noms en vérifiant les noms des VM existantes créées à partir des requêtes précédentes.

• PREDEFINED_NAME_1, PREDEFINED_NAME_2, ... : liste des noms prédéfinis des VM à créer. Spécifiez cet élément ou namePattern. Si vous utilisez cette option et spécifiez COUNT, COUNT doit être égal au nombre de noms fournis.

• COUNT : nombre de VM à créer. Cette valeur doit être inférieure ou égale au nombre de VM autorisées par NAME_PATTERN. Si vous utilisez perInstanceProperties, vous n'avez pas besoin de spécifier COUNT, mais dans ce cas, la valeur doit être égale au nombre de noms fournis.

• MIN_COUNT : nombre minimal de VM à créer. Le tableau suivant décrit le comportement de la requête en fonction de la manière dont vous définissez cette option :

  Valeur	Description
  Non défini	La valeur par défaut est COUNT. Si Compute Engine ne peut pas créer le nombre de VM spécifié par COUNT, la requête échoue et aucune VM n'est créée.
  1	Compute Engine crée autant de VM que possible, jusqu'à COUNT.
  Supérieur à 1 et inférieur à COUNT	Compute Engine crée au moins MIN_COUNT VM et jusqu'à COUNT VM au maximum. Si les MIN_COUNT VM ne peuvent pas être créées, la requête échoue et aucune VM n'est créée.

gcloud

Pour créer des VM avec des noms d'hôte personnalisés dans une région spécifique de façon groupée, utilisez la commande gcloud beta compute instances bulk create suivante.

gcloud beta compute instances bulk create \
    ( --name-pattern="NAME_PATTERN" | --predefined-names=[PREDEFINED_NAMES] ) \
    --per-instance-hostnames=[VM_NAME=HOSTNAME,...] \
    --zone=REGION \
    --count=COUNT \
    [ --min-count=MIN_COUNT ]
    [--location-policy=LOCATION_POLICY \ ]
    [--target-distribution-shape=TARGET_DISTRIBUTION_SHAPE ]

Remplacez les éléments suivants :

• NAME_PATTERN : modèle de nom des VM. Utilisez une séquence de caractères de hachage (#) que Compute Engine remplacera par une séquence de nombres. Par exemple, le modèle de nom vm-# génère des VM portant les noms vm-1 et vm-2, etc., jusqu'à ce qu'il atteigne le nombre de VM spécifié par --count, qui doit être inférieur ou égal au nombre de VM autorisé par le modèle de nom.

  Lors de l'utilisation d'un modèle de nom, Compute Engine tente d'éviter les conflits de noms en vérifiant les noms des VM existantes créées à partir des requêtes précédentes.

• PREDEFINED_NAMES : liste des noms prédéfinis des VM à créer. Si vous utilisez cette option et spécifiez COUNT, COUNT doit être égal au nombre de noms fournis.

• [VM_NAME=HOSTNAME, …] : liste de paires clé/valeur de noms prédéfinis pour les VM et les noms d'hôte de domaine complets que vous souhaitez attribuer aux VM. Les noms d'hôte personnalisés doivent être conformes aux exigences de la norme RFC 1035 relative aux noms d'hôte valides.

• REGION : zone dans laquelle créer les VM.

• COUNT : nombre de VM à créer. Cette valeur doit être inférieure ou égale au nombre de VM autorisées par NAME_PATTERN. Si vous utilisez --predefined-names, vous n'avez pas besoin de spécifier COUNT, mais dans ce cas, la valeur doit être égale au nombre de noms fournis.

• MIN_COUNT : nombre minimal de VM à créer. Le tableau suivant décrit le comportement de la requête en fonction de la manière dont vous définissez cette option :

  Valeur	Description
  Non défini	La valeur par défaut est COUNT. Si Compute Engine ne peut pas créer le nombre de VM spécifié par COUNT, la requête échoue et aucune VM n'est créée.
  1	Compute Engine crée autant de VM que possible, jusqu'à COUNT.
  Supérieur à 1 et inférieur à COUNT	Compute Engine crée au moins MIN_COUNT VM et jusqu'à COUNT VM au maximum. Si les MIN_COUNT VM ne peuvent pas être créées, la requête échoue et aucune VM n'est créée.

• LOCATION_POLICY : zones à inclure ou exclure dans une région. Utilisez une liste de paires clé/valeur, avec la zone comme clé et la règle comme valeur. Les valeurs valides pour la règle sont ALLOW (la valeur par défaut) et DENY. Voici un exemple de valeur pour ce champ :

  "locations": {
    "zones/us-central1-a": { "preference": "ALLOW" },
    "zones/us-central1-c": { "preference": "DENY"  },
    ...
  },
  

• TARGET_DISTRIBUTION_SHAPE : répartition des VM dans les zones spécifiées. Utilisez le champ locationPolicy pour spécifier les zones. Le tableau suivant indique les valeurs valides pour ce champ :

  Valeur	Description
  ANY_SINGLE_ZONE	Applique le placement de la VM dans une seule zone et donne la priorité à l'utilisation des réservations inutilisées. Utilisez cette option pour éviter toute sortie réseau interzone ou pour réduire la latence du réseau. Il s'agit de la valeur par défaut.
  BALANCED	Tente de répartir uniformément les VM dans toutes les zones de la région.
  ANY	Permet de répartir les VM dans plusieurs zones d'une région. Choisit les zones qui disposent de ressources disponibles et qui optimisent les réservations zonales non utilisées.

REST

Pour créer des VM avec des noms d'hôte personnalisés dans une région spécifique de façon groupée, utilisez la méthode instances.bulkInsert suivante :

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

{
  ...
  "namePattern": "NAME_PATTERN",
  "perInstanceProperties": {
    "PREDEFINED_NAME_1": {"hostname": HOSTNAME_1},
    "PREDEFINED_NAME_2": {"hostname": HOSTNAME_2},
    ...
  },
  "count": COUNT,
  "minCount": MIN_COUNT,
  "locationPolicy": {
    "LOCATION_POLICY"
    },
    "targetShape": "TARGET_DISTRIBUTION_SHAPE"
  ...
}

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet.

• REGION : région dans laquelle créer les VM.

• NAME_PATTERN : modèle de nom des VM. Indiquez cette valeur ou perInstanceProperties. Utilisez une séquence de caractères de hachage (#) que Compute Engine remplacera par une séquence de nombres. Par exemple, le modèle de nom vm-# génère des VM portant les noms vm-1 et vm-2, etc., jusqu'à ce qu'il atteigne le nombre de VM spécifié par --count, qui doit être inférieur ou égal au nombre de VM autorisé par le modèle de nom.

  Lors de l'utilisation d'un modèle de nom, Compute Engine tente d'éviter les conflits de noms en vérifiant les noms des VM existantes créées à partir des requêtes précédentes.

• PREDEFINED_NAME_1, PREDEFINED_NAME_2, ... : liste des noms prédéfinis des VM à créer. Spécifiez cet élément ou namePattern. Si vous utilisez cette option et spécifiez COUNT, COUNT doit être égal au nombre de noms fournis.

• HOSTNAME_1, HOSTNAME_2, … : noms d'hôte de domaine complets que vous souhaitez attribuer aux VM. Les noms d'hôte personnalisés doivent être conformes aux exigences de la norme RFC 1035 relative aux noms d'hôte valides.

  Par exemple, pour créer deux VM vm-1 et vm-2 avec les noms d'hôte personnalisés my-host1234.example.com et test.example.com, spécifiez respectivement la propriété hostname dans perInstanceProperties, comme suit :

  {
  ...
  "perInstanceProperties": {
  "vm-1": { "hostname": "my-host1234.example.com" },
  "vm-2": { "hostname": "test.example.com" },
  ...}
  },
  

• COUNT : nombre de VM à créer. Cette valeur doit être inférieure ou égale au nombre de VM autorisées par NAME_PATTERN. Si vous utilisez perInstanceProperties, vous n'avez pas besoin de spécifier COUNT, mais dans ce cas, la valeur doit être égale au nombre de noms fournis.

• MIN_COUNT : nombre minimal de VM à créer. Le tableau suivant décrit le comportement de la requête en fonction de la manière dont vous définissez cette option :

  Valeur	Description
  Non défini	La valeur par défaut est COUNT. Si Compute Engine ne peut pas créer le nombre de VM spécifié par COUNT, la requête échoue et aucune VM n'est créée.
  1	Compute Engine crée autant de VM que possible, jusqu'à COUNT.
  Supérieur à 1 et inférieur à COUNT	Compute Engine crée au moins MIN_COUNT VM et jusqu'à COUNT VM au maximum. Si les MIN_COUNT VM ne peuvent pas être créées, la requête échoue et aucune VM n'est créée.

• LOCATION_POLICY : zones à inclure ou exclure dans une région. Utilisez une liste de paires clé/valeur, avec la zone comme clé et la règle comme valeur. Les valeurs valides pour la règle sont ALLOW (la valeur par défaut) et DENY. Voici un exemple de valeur pour ce champ :

  "locations": {
    "zones/us-central1-a": { "preference": "ALLOW" },
    "zones/us-central1-c": { "preference": "DENY"  },
    ...
  },
  

• TARGET_DISTRIBUTION_SHAPE : répartition des VM dans les zones spécifiées. Utilisez le champ locationPolicy pour spécifier les zones. Le tableau suivant indique les valeurs valides pour ce champ :

  Valeur	Description
  ANY_SINGLE_ZONE	Applique le placement de la VM dans une seule zone et donne la priorité à l'utilisation des réservations inutilisées. Utilisez cette option pour éviter toute sortie réseau interzone ou pour réduire la latence du réseau. Il s'agit de la valeur par défaut.
  BALANCED	Tente de répartir uniformément les VM dans toutes les zones de la région.
  ANY	Permet de répartir les VM dans plusieurs zones d'une région. Choisit les zones qui disposent de ressources disponibles et qui optimisent les réservations zonales non utilisées.

gcloud

1. Obtenez la valeur de la propriété operationGroupId à partir de la ressource Operation renvoyée par la requête.

2. Utilisez la propriété operationGroupId comme un filtre avec la commande gcloud compute operations list pour rechercher les VM associées à la requête régionale ou zonale dans l'ensemble des opérations et des zones du projet :

   gcloud compute operations list \
      --filter=(operationGroupId=OPERATION_GROUP_ID)
   

3. Obtenez les autres propriétés de la VM en effectuant l'une des opérations suivantes :

   • Dans la liste des opérations, targetLink représente le chemin d'accès de la VM. Exécutez la commande gcloud compute instances describe en indiquant ce chemin d'accès comme nom de la VM pour obtenir les propriétés de la VM :

     gcloud compute instances describe VM_NAME
     

   • Exécutez la commande gcloud compute instances list avec un filtre incluant les noms des VM de la liste des opérations :

     gcloud compute instances list VM_NAME \
        --filter=(name=VM_NAME_1) OR (name=VM_NAME_2)
     

   • Exécutez la commande gcloud compute instances list pour obtenir les propriétés des VM situées dans l'ensemble des zones et des régions, et filtrez les résultats en fonction d'un libellé propre aux instances ou de leur nom :

     gcloud compute instances list \
        --filter=(name=VM_NAME_1) OR (name=VM_NAME_2)
     

REST

1. Obtenez la valeur de la propriété operationGroupId à partir de la ressource Operation renvoyée par la requête.

2. Utilisez la propriété operationGroupId pour obtenir la liste des opérations de VM associées à la requête régionale ou zonale :

   • Si vous avez envoyé une requête régionale, pour effectuer une recherche sur l'ensemble des opérations et des zones du projet, utilisez la méthode globalOperations.aggregatedList et incluez la propriété operationGroupId en tant que filtre :

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/aggregated/operations?filter=(operationGroupId=OPERATION_GROUP_ID)
     

   • Si vous avez envoyé une requête zonale, pour répertorier les opérations dans cette zone, utilisez la méthode zoneOperations.get et incluez la propriété operationGroupId dans la corps de la requête :

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/bulkInsert
     
     {
     ...
     "operationGroupId":"OPERATION_GROUP_ID"
     ...
     }
     

3. Obtenez les autres propriétés de la VM en effectuant l'une des opérations suivantes :

   • Dans la liste des opérations, targetLink représente le chemin d'accès de la VM. Utilisez la méthode instances.get en indiquant ce chemin d'accès comme nom de la VM pour obtenir toutes les propriétés de la VM :

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/VM_NAME
     

   • Utilisez la méthode instances.get avec un filtre incluant les noms des VM de la liste des opérations :

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances?filter=(name=VM_NAME_1) OR (name=VM_NAME_2)
     

   • Utilisez la méthode instances.aggregatedList pour obtenir les propriétés des VM situées dans l'ensemble des zones et des régions, et filtrez les résultats en fonction d'un libellé propre aux instances ou de leur nom :

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/aggregated/instances?filter=(name=VM_NAME_1) OR (name=VM_NAME_2)