Ce document explique comment créer des instances de machines virtuelles (VM) de manière groupée qui utilisent la série A2, y compris les types de machines A2-ultra ou A2-standard. Pour en savoir plus sur ces types de machines optimisés pour les accélérateurs, consultez la section Série A2.
Pour en savoir plus sur la création de VM de manière groupée, consultez À propos de la création groupée de VM dans la documentation Compute Engine.
Pour découvrir d'autres méthodes de création de VM ou de clusters, consultez Présentation des options de déploiement.
Limites
Lorsque vous créez des VM A2 Ultra ou A2 Standard de manière groupée, les limites suivantes s'appliquent :
A2 Ultra
- Vous ne bénéficiez ni de remises automatiques proportionnelles à une utilisation soutenue ni de remises sur engagement d'utilisation flexible pour les instances qui utilisent un type de machine A2 Ultra.
- Vous ne pouvez utiliser un type de machine A2 Ultra que dans certaines régions et zones.
- Les types de machines A2 Ultra ne sont disponibles que sur la plate-forme Cascade Lake.
- Si votre instance utilise un type de machine A2 Ultra, vous ne pouvez pas modifier le type de machine. Si vous devez utiliser un type de machine A2 Ultra différent ou tout autre type de machine, vous devez créer une nouvelle instance.
- Vous ne pouvez pas remplacer un autre type de machine par un type de machine A2 Ultra. Si vous avez besoin d'une instance utilisant un type de machine A2 Ultra, vous devez en créer une.
- Vous ne pouvez pas effectuer un formatage rapide des disques SSD locaux associés à des instances Windows qui utilisent des types de machines A2 Ultra. Pour formater ces disques SSD locaux, vous devez effectuer un formatage complet en utilisant l'utilitaire diskpart et en spécifiant
format fs=ntfs label=tmpfs.
A2 Standard
- Vous ne bénéficiez ni de remises automatiques proportionnelles à une utilisation soutenue ni de remises sur engagement d'utilisation flexible pour les instances qui utilisent un type de machine A2 Standard.
- Vous ne pouvez utiliser un type de machine A2 Standard que dans certaines régions et zones.
- Les types de machines A2 Standard ne sont disponibles que sur la plate-forme Cascade Lake.
- Si votre instance utilise un type de machine A2 Standard, vous ne pouvez passer d'un type de machine A2 Standard qu'à un autre type de machine A2 Standard. Vous ne pouvez pas passer à un autre type de machine. Pour en savoir plus, consultez Modifier des instances optimisées pour les accélérateurs.
- Vous ne pouvez pas utiliser le système d'exploitation Windows avec le type de machine
a2-megagpu-16g. Lorsque vous utilisez un système d'exploitation Windows, choisissez un autre type de machine A2 Standard. - Vous ne pouvez pas effectuer un formatage rapide des disques SSD locaux associés à des instances Windows qui utilisent des types de machines A2 Standard.
Pour formater ces disques SSD locaux, vous devez effectuer un formatage complet en utilisant l'utilitaire diskpart et en spécifiant
format fs=ntfs label=tmpfs.
Avant de commencer
Avant de créer des VM de manière groupée, si vous ne l'avez pas déjà fait, procédez comme suit :
- Choisissez une option de consommation : l'option de consommation que vous choisissez détermine comment vous obtenez et utilisez les ressources GPU. Pour en savoir plus, consultez Choisir une option de consommation.
- Obtenir de la capacité : le processus d'obtention de la capacité diffère pour chaque option de consommation. Pour en savoir plus sur la procédure à suivre pour obtenir de la capacité pour l'option de consommation choisie, consultez Présentation de la capacité.
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 Google Cloud et aux API, vous n'avez pas besoin de configurer l'authentification.
gcloud
Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez la Google Cloud CLI en exécutant la commande suivante :
gcloud initREST
Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.
Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée.
Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud .
Rôles requis
Pour obtenir les autorisations nécessaires à la création de VM de manière groupée, demandez à votre administrateur de vous attribuer le rôle IAM Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1) sur le projet.
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Ce rôle prédéfini contient les autorisations requises pour créer des VM de manière groupée. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Les autorisations suivantes sont requises pour créer des VM de manière groupée :
compute.instances.createsur le projet-
Pour créer la VM à l'aide d'une image personnalisée :
compute.images.useReadOnlysur l'image -
Pour créer la VM à l'aide d'un instantané :
compute.snapshots.useReadOnlysur l'instantané -
Pour créer la VM à l'aide d'un modèle d'instance :
compute.instanceTemplates.useReadOnlysur le modèle d'instance -
Pour spécifier un sous-réseau pour la VM :
compute.subnetworks.usesur le projet ou sur le sous-réseau choisi -
Pour spécifier une adresse IP statique pour la VM :
compute.addresses.usesur le projet -
Pour attribuer une adresse IP externe à la VM en cas d'utilisation d'un réseau VPC :
compute.subnetworks.useExternalIpsur le projet ou sur le sous-réseau choisi -
Pour attribuer un ancien réseau à la VM :
compute.networks.usesur le projet -
Pour attribuer une adresse IP externe à la VM en cas d'utilisation d'un ancien réseau :
compute.networks.useExternalIpsur le projet -
Pour définir les métadonnées d'instance de VM pour la VM :
compute.instances.setMetadatasur le projet -
Pour définir des tags pour la VM :
compute.instances.setTagssur la VM -
Pour définir des étiquettes pour la VM :
compute.instances.setLabelssur la VM -
Pour définir un compte de service que doit utiliser la VM :
compute.instances.setServiceAccountsur la VM -
Pour créer un disque pour la VM :
compute.disks.createsur le projet -
Pour associer un disque existant en mode lecture seule ou en mode lecture-écriture :
compute.disks.usesur le disque -
Pour associer un disque existant en mode lecture seule :
compute.disks.useReadOnlysur le disque
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Présentation
La création d'instances par lot avec le type de machine A2 comprend les étapes suivantes :
- Facultatif : créer une stratégie d'emplacement compact
- Créer des instances de manière groupée
- Installer des pilotes de GPU.
- Facultatif : activer le mode GPU multi-instances NVIDIA
Facultatif : Créer une stratégie d'emplacement compact
Vous pouvez spécifier l'emplacement des VM en créant une stratégie d'emplacement compact. Lorsque vous appliquez une stratégie d'emplacement compact à vos VM, Compute Engine s'efforce de créer des VM aussi proches les unes des autres que possible. Si votre application est sensible à la latence et nécessite une compacité maximale, spécifiez le champ maxDistance (aperçu) lorsque vous créez une stratégie d'emplacement compact. Une valeur maxDistance inférieure garantit un placement plus proche des VM, mais augmente également le risque que certaines VM ne soient pas créées.
gcloud
Pour créer une stratégie d'emplacement compact, utilisez la
commande gcloud beta compute resource-policies create group-placement :
gcloud beta compute resource-policies create group-placement POLICY_NAME \
--collocation=collocated \
--max-distance=MAX_DISTANCE \
--region=REGION
Remplacez les éléments suivants :
POLICY_NAME: nom de la stratégie d'emplacement compact.MAX_DISTANCE: configuration de distance maximale pour vos VM, qui peut être spécifiée (aperçu, recommandé) ou non spécifiée (supprimez l'indicateur--max-distance). Assurez-vous que la configuration de la distance maximale est compatible avec la série de machines et le nombre de VM que vous prévoyez de créer. Pour en savoir plus, consultez À propos des stratégies d'emplacement compact dans la documentation Compute Engine. Par exemple, une distance maximale de3place les VM dans des blocs adjacents, tandis que2place les VM dans le même bloc.REGION: région dans laquelle vous souhaitez créer la stratégie d'emplacement compact. Spécifiez la région contenant la zone dans laquelle vous prévoyez de créer des instances, et vérifiez que le type de machine que vous souhaitez utiliser est disponible dans cette région. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.
REST
Pour créer une stratégie d'emplacement compact, envoyez une requête POST à la méthode resourcePolicies.insert en version bêta.
Dans le corps de la requête, incluez le champ collocation défini sur COLLOCATED, ainsi que le champ maxDistance.
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/resourcePolicies
{
"name": "POLICY_NAME",
"groupPlacementPolicy": {
"collocation": "COLLOCATED",
"maxDistance": MAX_DISTANCE
}
}
Remplacez les éléments suivants :
PROJECT_ID: ID de votre projet.POLICY_NAME: nom de la stratégie d'emplacement compact.MAX_DISTANCE: configuration de distance maximale pour vos VM, qui peut être spécifiée (aperçu, recommandé) ou non spécifiée (supprimez le champmaxDistance). Assurez-vous que la configuration de la distance maximale est compatible avec la série de machines et le nombre de VM que vous prévoyez de créer. Pour en savoir plus, consultez À propos des stratégies d'emplacement compact dans la documentation Compute Engine. Par exemple, une distance maximale de3place les VM dans des blocs adjacents, tandis que2place les VM dans le même bloc.REGION: région dans laquelle vous souhaitez créer la stratégie d'emplacement compact. Spécifiez la région contenant la zone dans laquelle vous prévoyez de créer des instances, et vérifiez que le type de machine que vous souhaitez utiliser est disponible dans cette région. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.
Créer des VM A2 de manière groupée
Pour créer une VM A2, utilisez l'une des méthodes suivantes.
Les commandes suivantes définissent également le niveau d'accès pour vos instances. Pour simplifier la gestion des autorisations, Google vous recommande de définir le niveau d'accès d'une instance surcloud-platform, puis d'utiliser des rôles IAM pour définir les services auxquels l'instance peut accéder. Pour en savoir plus, consultez les bonnes pratiques concernant les niveaux d'accès.
gcloud
Pour créer des instances de manière groupée, utilisez la
commande gcloud compute instances bulk create.
Les paramètres que vous devez spécifier dépendent de l'option de consommation que vous utilisez pour ce déploiement. Sélectionnez l'onglet correspondant à votre option de consommation.
Réservation
Les instances A2 sont compatibles avec les types de réservations suivants :
- Réservations à la demande
- Réservations futures standards
Pour utiliser ces types de réservations, une instance doit utiliser le modèle de provisionnement standard. Par exemple, utilisez les paramètres de création suivants.
Avant d'exécuter la commande, passez en revue toutes les étapes suivantes pour déterminer si vous devez inclure des indicateurs supplémentaires.
gcloud compute instances bulk create \
--name-pattern=NAME_PATTERN \
--count=COUNT \
--machine-type=MACHINE_TYPE \
--image-family=IMAGE_FAMILY \
--image-project=IMAGE_PROJECT \
--region=REGION \
--boot-disk-type=DISK_TYPE \
--boot-disk-size=DISK_SIZE \
--scopes=cloud-platform \
--provisioning-model=STANDARD \
--maintenance-policy=TERMINATE \
--reservation-affinity=RESERVATION_AFFINITY \
--reservation=RESERVATION
Procédez comme suit :
-
Remplacez les éléments suivants :
NAME_PATTERN: format de nom à utiliser pour les instances A2. Par exemple, le modèle de nominstance-#génère des instances A2 portant les nomsinstance-1etinstance-2, jusqu'à ce qu'il atteigne le nombre d'instances A2 spécifié par--count.COUNT: nombre d'instances A2 à créer.MACHINE_TYPE: type de machine à utiliser pour l'instance A2. Pour en savoir plus, consultez Types de machines GPU dans la documentation Compute Engine.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour obtenir la liste de tous les systèmes d'exploitation compatibles, consultez Systèmes d'exploitation compatibles.IMAGE_PROJECT: ID du projet de l'image de l'OS.REGION: spécifiez une région dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.DISK_TYPE: type de disque de démarrage. Pour en savoir plus sur les types de disques compatibles avec votre type de machine, consultez Machines GPU de la famille de machines optimisées pour les accélérateurs dans la documentation Compute Engine.DISK_SIZE: taille du disque de démarrage en Go. Pour en savoir plus, consultez Limites de taille des volumes Google Cloud Hyperdisk ou Limites de taille des volumes Persistent Disk, selon le type de disque.RESERVATION_AFFINITY: les réservations que l'instance est autorisée à utiliser, si possible. Spécifiez l'une des options suivantes :any(la capacité de réservation est facultative) : il s'agit de l'option par défaut. L'instance tente d'utiliser la capacité d'une réservation à consommation automatique, ce qui ne se produit que si la capacité de réservation correspondante est disponible. Sinon, l'instance utilise la capacité à la demande.specific(Capacité de réservation requise) : exige que l'instance utilise la capacité d'une réservation spécifiquement ciblée. L'instance n'est pas autorisée à utiliser la capacité à la demande. Si la capacité de réservation n'est pas disponible, la création de l'instance échoue.
RESERVATION: réservation à utiliser. Spécifiez l'une des valeurs suivantes en fonction de la valeur que vous avez spécifiée pourRESERVATION_AFFINITY:- Si vous avez spécifié
any, remplacezRESERVATIONpar une chaîne vide (""). Vous pouvez également supprimer complètement l'option--reservation. Si vous avez spécifié
specific, remplacezRESERVATIONpar ce qui suit :projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME
Remplacez les éléments suivants :
RESERVATION_OWNER_PROJECT_ID: ID du projet dans lequel la réservation a été créée.RESERVATION_NAME: nom de la réservation.
- Si vous avez spécifié
Par défaut, l'instance redémarre automatiquement en cas de plantage ou si Compute Engine l'arrête pour un arrêt programmé, comme un événement de maintenance. Si vous souhaitez désactiver le redémarrage automatique, ajoutez le flag suivant :
--no-restart-on-failure
-
Facultatif : Si vous avez choisi d'utiliser une stratégie d'emplacement compact, ajoutez l'indicateur suivant à la commande :
--resource-policies=POLICY_NAME
Remplacez les éléments suivants :
POLICY_NAME: nom de la stratégie d'emplacement compact.
-
Facultatif : Si vous avez spécifié un type de machine A2 Standard et que vous souhaitez associer des disques SSD locaux, ajoutez l'option
--local-ssdpour chaque disque SSD local.Assurez-vous que le nombre de disques SSD locaux que vous associez est autorisé pour votre type de machine. Pour en savoir plus, consultez À propos des disques SSD locaux dans la documentation Compute Engine.
--local-ssd interface=INTERFACE_TYPE
Remplacez les éléments suivants :
INTERFACE_TYPE: type d'interface de disque que vous souhaitez utiliser pour le disque SSD local. Si votre image de disque de démarrage inclut des pilotes NVMe optimisés, spécifiezNVME. SpécifiezSCSIpour les autres images.
Après avoir créé une VM avec des disques SSD locaux, vous devez formater et installer chaque périphérique pour pouvoir l'utiliser.
- Exécutez la commande.
À la demande
Avant d'exécuter la commande, passez en revue toutes les étapes suivantes pour déterminer si vous devez inclure des indicateurs supplémentaires.
gcloud compute instances bulk create \
--name-pattern=NAME_PATTERN \
--count=COUNT \
--machine-type=MACHINE_TYPE \
--image-family=IMAGE_FAMILY \
--image-project=IMAGE_PROJECT \
--region=REGION \
--boot-disk-type=DISK_TYPE \
--boot-disk-size=DISK_SIZE \
--scopes=cloud-platform \
--provisioning-model=STANDARD \
--maintenance-policy=TERMINATE \
--reservation-affinity=RESERVATION_AFFINITY
Procédez comme suit :
-
Remplacez les éléments suivants :
NAME_PATTERN: format de nom à utiliser pour les instances A2. Par exemple, le modèle de nominstance-#génère des instances A2 portant les nomsinstance-1etinstance-2, jusqu'à ce qu'il atteigne le nombre d'instances A2 spécifié par--count.COUNT: nombre d'instances A2 à créer.MACHINE_TYPE: type de machine à utiliser pour l'instance A2. Pour en savoir plus, consultez Types de machines GPU dans la documentation Compute Engine.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour obtenir la liste de tous les systèmes d'exploitation compatibles, consultez Systèmes d'exploitation compatibles.IMAGE_PROJECT: ID du projet de l'image de l'OS.REGION: spécifiez une région dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.DISK_TYPE: type de disque de démarrage. Pour en savoir plus sur les types de disques compatibles avec votre type de machine, consultez Machines GPU de la famille de machines optimisées pour les accélérateurs dans la documentation Compute Engine.DISK_SIZE: taille du disque de démarrage en Go. Pour en savoir plus, consultez Limites de taille des volumes Google Cloud Hyperdisk ou Limites de taille des volumes Persistent Disk, selon le type de disque.RESERVATION_AFFINITY: les réservations que l'instance est autorisée à utiliser, si possible. Spécifiez l'une des options suivantes :any(la capacité de réservation est facultative) : il s'agit de l'option par défaut. L'instance tente d'utiliser la capacité d'une réservation à consommation automatique, ce qui ne se produit que si la capacité de réservation correspondante est disponible. Sinon, l'instance utilise la capacité à la demande.none(capacité à la demande requise) : empêche l'instance d'utiliser la capacité de réservation.
Par défaut, l'instance redémarre automatiquement en cas de plantage ou si Compute Engine l'arrête pour un arrêt programmé, comme un événement de maintenance. Si vous souhaitez désactiver le redémarrage automatique, ajoutez le flag suivant :
--no-restart-on-failure
-
Facultatif : Si vous avez choisi d'utiliser une stratégie d'emplacement compact, ajoutez l'indicateur suivant à la commande :
--resource-policies=POLICY_NAME
Remplacez les éléments suivants :
POLICY_NAME: nom de la stratégie d'emplacement compact.
-
Facultatif : Si vous avez spécifié un type de machine A2 Standard et que vous souhaitez associer des disques SSD locaux, ajoutez l'option
--local-ssdpour chaque disque SSD local.Assurez-vous que le nombre de disques SSD locaux que vous associez est autorisé pour votre type de machine. Pour en savoir plus, consultez À propos des disques SSD locaux dans la documentation Compute Engine.
--local-ssd interface=INTERFACE_TYPE
Remplacez les éléments suivants :
INTERFACE_TYPE: type d'interface de disque que vous souhaitez utiliser pour le disque SSD local. Si votre image de disque de démarrage inclut des pilotes NVMe optimisés, spécifiezNVME. SpécifiezSCSIpour les autres images.
Après avoir créé une VM avec des disques SSD locaux, vous devez formater et installer chaque périphérique pour pouvoir l'utiliser.
- Exécutez la commande.
Spot
Avant d'exécuter la commande, passez en revue toutes les étapes suivantes pour déterminer si vous devez inclure des indicateurs supplémentaires.
gcloud compute instances bulk create \
--name-pattern=NAME_PATTERN \
--count=COUNT \
--machine-type=MACHINE_TYPE \
--image-family=IMAGE_FAMILY \
--image-project=IMAGE_PROJECT \
--region=REGION \
--boot-disk-type=DISK_TYPE \
--boot-disk-size=DISK_SIZE \
--scopes=cloud-platform \
--provisioning-model=SPOT \
--instance-termination-action=TERMINATION_ACTION \
--maintenance-policy=TERMINATE \
--no-restart-on-failure
Procédez comme suit :
-
Remplacez les éléments suivants :
NAME_PATTERN: format de nom à utiliser pour les instances A2. Par exemple, le modèle de nominstance-#génère des instances A2 portant les nomsinstance-1etinstance-2, jusqu'à ce qu'il atteigne le nombre d'instances A2 spécifié par--count.COUNT: nombre d'instances A2 à créer.MACHINE_TYPE: type de machine à utiliser pour l'instance A2. Pour en savoir plus, consultez Types de machines GPU dans la documentation Compute Engine.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour obtenir la liste de tous les systèmes d'exploitation compatibles, consultez Systèmes d'exploitation compatibles.IMAGE_PROJECT: ID du projet de l'image de l'OS.REGION: spécifiez une région dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.DISK_TYPE: type de disque de démarrage. Pour en savoir plus sur les types de disques compatibles avec votre type de machine, consultez Machines GPU de la famille de machines optimisées pour les accélérateurs dans la documentation Compute Engine.DISK_SIZE: taille du disque de démarrage en Go. Pour en savoir plus, consultez Limites de taille des volumes Google Cloud Hyperdisk ou Limites de taille des volumes Persistent Disk, selon le type de disque.TERMINATION_ACTION: action à effectuer lorsque Compute Engine préempte l'instance, soitSTOP(par défaut), soitDELETE.
-
Facultatif : Si vous avez choisi d'utiliser une stratégie d'emplacement compact, ajoutez l'indicateur suivant à la commande :
--resource-policies=POLICY_NAME
Remplacez les éléments suivants :
POLICY_NAME: nom de la stratégie d'emplacement compact.
-
Facultatif : Si vous avez spécifié un type de machine A2 Standard et que vous souhaitez associer des disques SSD locaux, ajoutez l'option
--local-ssdpour chaque disque SSD local.Assurez-vous que le nombre de disques SSD locaux que vous associez est autorisé pour votre type de machine. Pour en savoir plus, consultez À propos des disques SSD locaux dans la documentation Compute Engine.
--local-ssd interface=INTERFACE_TYPE
Remplacez les éléments suivants :
INTERFACE_TYPE: type d'interface de disque que vous souhaitez utiliser pour le disque SSD local. Si votre image de disque de démarrage inclut des pilotes NVMe optimisés, spécifiezNVME. SpécifiezSCSIpour les autres images.
Après avoir créé une VM avec des disques SSD locaux, vous devez formater et installer chaque périphérique pour pouvoir l'utiliser.
- Exécutez la commande.
REST
Pour créer des instances de manière groupée, envoyez une requête POST à la
méthode instances.bulkInsert.
Les paramètres que vous devez spécifier dépendent de l'option de consommation que vous utilisez pour ce déploiement. Sélectionnez l'onglet correspondant à votre option de consommation.
Réservation
Les instances A2 sont compatibles avec les types de réservations suivants :
- Réservations à la demande
- Réservations futures standards
Pour utiliser ces types de réservations, une instance doit utiliser le modèle de provisionnement standard. Par exemple, utilisez les paramètres de création suivants.
Avant d'envoyer la demande, passez en revue toutes les étapes suivantes pour déterminer si vous devez inclure des champs supplémentaires.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert
{
"namePattern": "NAME_PATTERN",
"count": "COUNT",
"instanceProperties": {
"machineType": "MACHINE_TYPE",
"disks": [
{
"boot": true,
"initializeParams": {
"diskSizeGb": "DISK_SIZE",
"diskType": "DISK_TYPE",
"sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
},
"mode": "READ_WRITE",
"type": "PERSISTENT"
}
],
"serviceAccounts": [
{
"email": "default",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
],
"scheduling": {
"provisioningModel": "STANDARD",
"onHostMaintenance": "TERMINATE",
"automaticRestart": AUTOMATIC_RESTART
},
"reservationAffinity": {
"consumeReservationType": "RESERVATION_AFFINITY",
"key": "compute.googleapis.com/reservation-name",
"values": [
"RESERVATION"
]
}
}
}
Procédez comme suit :
-
Remplacez les éléments suivants :
PROJECT_ID: ID du projet dans lequel vous souhaitez créer l'instance A2.ZONE: spécifiez une zone dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser une zone située dans la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.NAME_PATTERN: format de nom à utiliser pour les instances A2. Par exemple, le modèle de nominstance-#génère des instances A2 portant les nomsinstance-1etinstance-2, jusqu'à ce qu'il atteigne le nombre d'instances A2 spécifié par--count.COUNT: nombre d'instances A2 à créer.MACHINE_TYPE: type de machine à utiliser pour l'instance A2. Pour en savoir plus, consultez Types de machines GPU dans la documentation Compute Engine.DISK_SIZE: taille du disque de démarrage en Go. Pour en savoir plus, consultez Limites de taille des volumes Google Cloud Hyperdisk ou Limites de taille des volumes Persistent Disk, selon le type de disque.DISK_TYPE: type de disque de démarrage. Pour en savoir plus sur les types de disques compatibles avec votre type de machine, consultez Machines GPU de la famille de machines optimisées pour les accélérateurs dans la documentation Compute Engine.IMAGE_PROJECT: ID du projet de l'image de l'OS.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour obtenir la liste de tous les systèmes d'exploitation compatibles, consultez Systèmes d'exploitation compatibles.AUTOMATIC_RESTART: indique si votre instance redémarre automatiquement en cas de plantage ou d'arrêt programmé par Compute Engine, par exemple lors d'un événement de maintenance. Spécifieztruepour activer le redémarrage automatique (par défaut) oufalsepour le désactiver.RESERVATION_AFFINITY: les réservations que l'instance est autorisée à utiliser, si possible. Spécifiez l'une des options suivantes :ANY_RESERVATION(la capacité de réservation est facultative) : il s'agit de l'option par défaut. L'instance tente d'utiliser la capacité d'une réservation consommée automatiquement, ce qui ne se produit que si la capacité de réservation correspondante est disponible. Sinon, l'instance utilise une capacité à la demande.SPECIFIC_RESERVATION(Capacité de réservation requise) : exige que l'instance utilise la capacité d'une réservation spécifiquement ciblée. L'instance n'est pas autorisée à utiliser la capacité à la demande. Si la capacité de réservation n'est pas disponible, la création de l'instance échoue.
RESERVATION: réservation à utiliser. Spécifiez l'une des valeurs suivantes en fonction de la valeur que vous avez spécifiée pourRESERVATION_AFFINITY:- Si vous avez spécifié
ANY_RESERVATION, supprimezRESERVATIONafin que la valeur soit une chaîne vide (""). Vous pouvez également supprimer entièrement les champskeyetvalues. Si vous avez spécifié
SPECIFIC_RESERVATION, remplacezRESERVATIONpar ce qui suit :projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME
Remplacez les éléments suivants :
RESERVATION_OWNER_PROJECT_ID: ID du projet dans lequel la réservation a été créée.RESERVATION_NAME: nom de la réservation.
- Si vous avez spécifié
-
Facultatif : Si vous avez choisi d'utiliser une stratégie d'emplacement compact, ajoutez le sous-champ
instancePropertiessuivant au corps de la requête :"resourcePolicies": [ "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ]Remplacez les éléments suivants :
PROJECT_ID: ID du projet de la stratégie d'emplacement compact.REGION: région de la stratégie d'emplacement compact.POLICY_NAME: nom de la stratégie d'emplacement compact.
-
Facultatif : Si vous avez spécifié un type de machine standard A2 et que vous souhaitez associer des disques SSD locaux, ajoutez le champ suivant au champ
disks[]pour chaque disque SSD local. Séparez chaque sous-champdisks[](y compris le disque de démarrage) par une virgule.Assurez-vous que le nombre de disques SSD locaux que vous associez est autorisé pour votre type de machine. Pour en savoir plus, consultez À propos des disques SSD locaux dans la documentation Compute Engine.
{ "type": "SCRATCH", "initializeParams": { "diskType": "zones/ZONE/diskTypes/local-ssd" }, "autoDelete": true, "interface": "INTERFACE_TYPE" }Remplacez les éléments suivants :
ZONE: zone spécifiée.INTERFACE_TYPE: type d'interface de disque que vous souhaitez utiliser pour le disque SSD local. Si votre image de disque de démarrage inclut des pilotes NVMe optimisés, spécifiezNVME. SpécifiezSCSIpour les autres images.
Après avoir créé une VM avec des disques SSD locaux, vous devez formater et installer chaque périphérique pour pouvoir l'utiliser.
- Envoyez la demande.
À la demande
Avant d'envoyer la demande, passez en revue toutes les étapes suivantes pour déterminer si vous devez inclure des champs supplémentaires.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert
{
"namePattern": "NAME_PATTERN",
"count": "COUNT",
"instanceProperties": {
"machineType": "MACHINE_TYPE",
"disks": [
{
"boot": true,
"initializeParams": {
"diskSizeGb": "DISK_SIZE",
"diskType": "DISK_TYPE",
"sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
},
"mode": "READ_WRITE",
"type": "PERSISTENT"
}
],
"serviceAccounts": [
{
"email": "default",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
],
"scheduling": {
"provisioningModel": "STANDARD",
"onHostMaintenance": "TERMINATE",
"automaticRestart": AUTOMATIC_RESTART
},
"reservationAffinity": {
"consumeReservationType": "RESERVATION_AFFINITY"
}
}
}
Procédez comme suit :
-
Remplacez les éléments suivants :
PROJECT_ID: ID du projet dans lequel vous souhaitez créer l'instance A2.ZONE: spécifiez une zone dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser une zone située dans la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.NAME_PATTERN: format de nom à utiliser pour les instances A2. Par exemple, le modèle de nominstance-#génère des instances A2 portant les nomsinstance-1etinstance-2, jusqu'à ce qu'il atteigne le nombre d'instances A2 spécifié par--count.COUNT: nombre d'instances A2 à créer.MACHINE_TYPE: type de machine à utiliser pour l'instance A2. Pour en savoir plus, consultez Types de machines GPU dans la documentation Compute Engine.DISK_SIZE: taille du disque de démarrage en Go. Pour en savoir plus, consultez Limites de taille des volumes Google Cloud Hyperdisk ou Limites de taille des volumes Persistent Disk, selon le type de disque.DISK_TYPE: type de disque de démarrage. Pour en savoir plus sur les types de disques compatibles avec votre type de machine, consultez Machines GPU de la famille de machines optimisées pour les accélérateurs dans la documentation Compute Engine.IMAGE_PROJECT: ID du projet de l'image de l'OS.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour obtenir la liste de tous les systèmes d'exploitation compatibles, consultez Systèmes d'exploitation compatibles.AUTOMATIC_RESTART: indique si votre instance redémarre automatiquement en cas de plantage ou d'arrêt programmé par Compute Engine, par exemple lors d'un événement de maintenance. Spécifieztruepour activer le redémarrage automatique (par défaut) oufalsepour le désactiver.RESERVATION_AFFINITY: les réservations que l'instance est autorisée à utiliser, si possible. Spécifiez l'une des options suivantes :ANY_RESERVATION(la capacité de réservation est facultative) : il s'agit de l'option par défaut. L'instance tente d'utiliser la capacité d'une réservation consommée automatiquement, ce qui ne se produit que si la capacité de réservation correspondante est disponible. Sinon, l'instance utilise une capacité à la demande.NO_RESERVATION(capacité à la demande requise) : empêche l'instance d'utiliser la capacité de réservation.
-
Facultatif : Si vous avez choisi d'utiliser une stratégie d'emplacement compact, ajoutez le sous-champ
instancePropertiessuivant au corps de la requête :"resourcePolicies": [ "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ]Remplacez les éléments suivants :
PROJECT_ID: ID du projet de la stratégie d'emplacement compact.REGION: région de la stratégie d'emplacement compact.POLICY_NAME: nom de la stratégie d'emplacement compact.
-
Facultatif : Si vous avez spécifié un type de machine standard A2 et que vous souhaitez associer des disques SSD locaux, ajoutez le champ suivant au champ
disks[]pour chaque disque SSD local. Séparez chaque sous-champdisks[](y compris le disque de démarrage) par une virgule.Assurez-vous que le nombre de disques SSD locaux que vous associez est autorisé pour votre type de machine. Pour en savoir plus, consultez À propos des disques SSD locaux dans la documentation Compute Engine.
{ "type": "SCRATCH", "initializeParams": { "diskType": "zones/ZONE/diskTypes/local-ssd" }, "autoDelete": true, "interface": "INTERFACE_TYPE" }Remplacez les éléments suivants :
ZONE: zone spécifiée.INTERFACE_TYPE: type d'interface de disque que vous souhaitez utiliser pour le disque SSD local. Si votre image de disque de démarrage inclut des pilotes NVMe optimisés, spécifiezNVME. SpécifiezSCSIpour les autres images.
Après avoir créé une VM avec des disques SSD locaux, vous devez formater et installer chaque périphérique pour pouvoir l'utiliser.
- Envoyez la demande.
Spot
Avant d'envoyer la demande, passez en revue toutes les étapes suivantes pour déterminer si vous devez inclure des champs supplémentaires.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert
{
"namePattern": "NAME_PATTERN",
"count": "COUNT",
"instanceProperties": {
"machineType": "MACHINE_TYPE",
"disks": [
{
"boot": true,
"initializeParams": {
"diskSizeGb": "DISK_SIZE",
"diskType": "DISK_TYPE",
"sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
},
"mode": "READ_WRITE",
"type": "PERSISTENT"
}
],
"serviceAccounts": [
{
"email": "default",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
],
"scheduling":
{
"provisioningModel": "SPOT",
"instanceTerminationAction": "TERMINATION_ACTION",
"onHostMaintenance": "TERMINATE",
"automaticRestart": false
}
}
}
Procédez comme suit :
-
Remplacez les éléments suivants :
PROJECT_ID: ID du projet dans lequel vous souhaitez créer l'instance A2.ZONE: spécifiez une zone dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser une zone située dans la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.NAME_PATTERN: format de nom à utiliser pour les instances A2. Par exemple, le modèle de nominstance-#génère des instances A2 portant les nomsinstance-1etinstance-2, jusqu'à ce qu'il atteigne le nombre d'instances A2 spécifié par--count.COUNT: nombre d'instances A2 à créer.MACHINE_TYPE: type de machine à utiliser pour l'instance A2. Pour en savoir plus, consultez Types de machines GPU dans la documentation Compute Engine.DISK_SIZE: taille du disque de démarrage en Go. Pour en savoir plus, consultez Limites de taille des volumes Google Cloud Hyperdisk ou Limites de taille des volumes Persistent Disk, selon le type de disque.DISK_TYPE: type de disque de démarrage. Pour en savoir plus sur les types de disques compatibles avec votre type de machine, consultez Machines GPU de la famille de machines optimisées pour les accélérateurs dans la documentation Compute Engine.IMAGE_PROJECT: ID du projet de l'image de l'OS.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour obtenir la liste de tous les systèmes d'exploitation compatibles, consultez Systèmes d'exploitation compatibles.TERMINATION_ACTION: action à effectuer lorsque Compute Engine préempte l'instance, soitSTOP(par défaut), soitDELETE.
-
Facultatif : Si vous avez choisi d'utiliser une stratégie d'emplacement compact, ajoutez le sous-champ
instancePropertiessuivant au corps de la requête :"resourcePolicies": [ "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ]Remplacez les éléments suivants :
PROJECT_ID: ID du projet de la stratégie d'emplacement compact.REGION: région de la stratégie d'emplacement compact.POLICY_NAME: nom de la stratégie d'emplacement compact.
-
Facultatif : Si vous avez spécifié un type de machine standard A2 et que vous souhaitez associer des disques SSD locaux, ajoutez le champ suivant au champ
disks[]pour chaque disque SSD local. Séparez chaque sous-champdisks[](y compris le disque de démarrage) par une virgule.Assurez-vous que le nombre de disques SSD locaux que vous associez est autorisé pour votre type de machine. Pour en savoir plus, consultez À propos des disques SSD locaux dans la documentation Compute Engine.
{ "type": "SCRATCH", "initializeParams": { "diskType": "zones/ZONE/diskTypes/local-ssd" }, "autoDelete": true, "interface": "INTERFACE_TYPE" }Remplacez les éléments suivants :
ZONE: zone spécifiée.INTERFACE_TYPE: type d'interface de disque que vous souhaitez utiliser pour le disque SSD local. Si votre image de disque de démarrage inclut des pilotes NVMe optimisés, spécifiezNVME. SpécifiezSCSIpour les autres images.
Après avoir créé une VM avec des disques SSD locaux, vous devez formater et installer chaque périphérique pour pouvoir l'utiliser.
- Envoyez la demande.
Pour en savoir plus sur les options de configuration permettant de créer des VM de manière groupée, consultez Créer des VM de manière groupée dans la documentation Compute Engine.
Installer des pilotes de GPU
Une fois que vous avez créé une instance, celle-ci ne peut pas utiliser ses GPU, sauf si les pilotes de GPU appropriés sont déjà installés. Si vous n'avez pas spécifié d'image d'OS incluant des pilotes de GPU, consultez Installer des pilotes de GPU dans la documentation Compute Engine.