Créer une instance avec des disques non amorçables supplémentaires

Ce document explique comment créer et associer des disques non amorçables supplémentaires à une instance Compute Engine lorsque vous la créez.

Les informations de ce document s'appliquent à la création d'une instance de calcul avec des disques zonaux qui ne se trouvent pas dans un pool Hyperdisk. La liste suivante décrit les tâches associées et la documentation correspondante.

Avant de commencer

Rôles requis

Pour obtenir les autorisations nécessaires pour créer une instance avec des disques non bootables ajoutés, demandez à votre administrateur de vous accorder 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 une instance avec des disques non bootables ajoutés. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour créer une instance avec des disques non amorçables supplémentaires :

  • compute.instances.create sur le projet
  • Pour créer un disque pour l'instance : compute.disks.create sur le projet
  • Pour créer un disque à partir d'une image : compute.images.useReadOnly sur l'image source.
  • Pour créer un disque à partir d'un instantané standard ou d'archive : compute.snapshots.useReadOnly sur l'instantané source
  • Pour créer un disque à partir d'un instantané immédiat, si le disque source de l'instantané immédiat est le disque de démarrage d'une instance à laquelle est associé un compte de service : iam.serviceAccounts.actAs sur le compte de service de l'instance
  • Pour créer un disque à partir d'un instantané immédiat : compute.instantSnapshots.useReadOnly sur l'instantané immédiat source
  • Pour créer un disque à partir d'un disque existant : compute.disks.useReadOnly sur le disque source

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Limites

Le nombre, la taille totale combinée et le type de disques que vous pouvez associer à une instance dépendent du type de machine de l'instance.

Par exemple, les instances C4 ne sont pas compatibles avec les disques persistants. De plus, la taille combinée de tous les disques associés à une instance c4-standard-2 ne peut pas dépasser 257 Tio, mais pour une instance c4-standard-192, la limite est de 512 Tio.

Les limites détaillées pour chaque série de machines sont indiquées dans la section Types de disques compatibles de la documentation sur les séries de machines. Pour afficher les limites de la série de machines de votre nouvelle instance, consultez le lien correspondant dans le tableau suivant.

Types de machines à usage général
 Types de machines optimisés pour le calcul
 Types de machines à mémoire optimisée
 Types de machines optimisés pour les accélérateurs
 Types de machines
optimisés pour le stockage

Limites de taille de disque et noms de référence

La taille que vous spécifiez pour un disque régional doit être comprise dans les plages indiquées dans le tableau suivant.

Lorsque vous créez un disque avec la Google Cloud CLI, REST ou les bibliothèques clientes Cloud pour Compute Engine, vous spécifiez le type de disque à créer avec la valeur correspondante de la colonne Nom de référence dans le tableau suivant.

Type de disque Nom de la référence Taille minimale Taille maximale Taille par défaut
Hyperdisk Balanced hyperdisk-balanced 4 Gio 64 Tio1 100 Gio
Hyperdisk Balanced High Availability hyperdisk-balanced-high-availability 4 Gio 64 Tio 100 Gio
Hyperdisk Extreme hyperdisk-extreme 64 Gio 64 Tio 1 Tio
Hyperdisk Throughput hyperdisk-throughput 2 Tio 32 Tio 2 Tio
Hyperdisk ML hyperdisk-ml 4 Gio 64 Tio 100 Gio
Disque persistant avec équilibrage pd-balanced Zonal : 10 Gio
Régional : 10 Gio		 64 Tio 100 Gio
Performance (SSD) Persistent Disk pd-ssd Zonal : 10 Gio
Régional : 10 Gio		 64 Tio 100 Gio
Disque persistant standard pd-standard Zonal : 10 Gio
Régional : 200 Gio		 64 Tio 500 Gio
Disque persistant extrême pd-extreme 500 Gio 64 Tio 1 Tio
1 Aperçu : C4 accepte une taille de disque maximale de 128 Tio. Pour accéder à cette fonctionnalité, contactez hyperdisk-questions@google.com.

Créer une instance avec de nouveaux disques non amorçables supplémentaires

Pour créer une instance à laquelle sont associés des disques non amorçables supplémentaires, procédez comme suit :

Console

  1. Accédez à la page Créer une instance dans la console Google Cloud .

    Accéder à la page "Créer une instance"

    Si vous y êtes invité, sélectionnez votre projet et cliquez sur Continuer.

    La page Créer une instance s'affiche et le volet Configuration de la machine s'ouvre.

  2. Dans le volet Configuration de la machine, procédez comme suit :

    1. Dans le champ Nom, spécifiez un nom pour votre instance. Pour en savoir plus, consultez Convention d'attribution de noms aux ressources.
    2. Dans le champ Région, spécifiez la région dans laquelle vous souhaitez créer votre instance.

    3. Facultatif : Dans le champ Zone, sélectionnez une zone pour cette instance.

      La sélection par défaut est Toutes. Si vous ne modifiez pas cette sélection par défaut, Google choisit automatiquement une zone en fonction du type de machine et de la disponibilité.

    4. Sélectionnez la famille de machines pour votre instance. La console Google Cloud affiche ensuite les séries de machines disponibles pour la famille de machines que vous avez sélectionnée. Les options suivantes sont disponibles pour les familles de machines :

      • Usage général
      • Optimisées pour le calcul
      • À mémoire optimisée
      • Optimisées pour le stockage
      • GPU

    5. Dans la colonne Série, sélectionnez la série de machines pour votre instance.

      Si vous avez sélectionné GPU comme famille de machines à l'étape précédente, sélectionnez le type de GPU souhaité. La série de machines est ensuite sélectionnée automatiquement pour le type de GPU sélectionné.

    6. Dans la section Type de machine, sélectionnez le type de machine pour votre instance.

  3. Dans le menu de navigation, cliquez sur OS et stockage. Le volet Système d'exploitation et stockage s'affiche.

  4. Pour configurer votre disque de démarrage, cliquez sur Modifier. Le volet Disque de démarrage s'affiche et l'onglet Images publiques est sélectionné.

  5. Configurez la source de données pour le disque de démarrage de l'une des manières suivantes :

    • Pour choisir une image publique comme source de données pour votre disque de démarrage, dans l'onglet Images publiques, spécifiez les éléments suivants :

      1. Dans la liste Système d'exploitation, sélectionnez le type d'OS.
      2. Dans le champ Version, sélectionnez la version du système d'exploitation.
      3. Dans la liste Type de disque de démarrage, sélectionnez le type de disque de démarrage.
      4. Dans le champ Taille (Go), spécifiez la taille du disque de démarrage.

    • Pour choisir une image personnalisée comme source de données pour votre disque de démarrage, cliquez sur Images personnalisées, puis, dans l'onglet Images personnalisées qui s'affiche, spécifiez les éléments suivants :

      1. Pour sélectionner le projet de l'image, cliquez sur Modifier, puis sélectionnez le projet contenant l'image.
      2. Dans la liste Image, sélectionnez l'image que vous souhaitez importer.
      3. Dans la liste Type de disque de démarrage, sélectionnez le type de disque de démarrage.
      4. Dans le champ Taille (Go), spécifiez la taille du disque de démarrage.

    • Pour choisir un instantané standard comme source de données pour votre disque de démarrage, cliquez sur Instantanés, puis, dans l'onglet Instantanés qui s'affiche, spécifiez les éléments suivants :

      1. Dans la liste Instantané, sélectionnez l'instantané.
      2. Dans la liste Type de disque de démarrage, sélectionnez le type de disque de démarrage.
      3. Dans le champ Taille (Go), spécifiez la taille du disque de démarrage.

    • Pour choisir un instantané d'archive comme source de données pour votre disque de démarrage, cliquez sur Instantanés d'archive, puis, dans l'onglet Instantanés d'archive qui s'affiche, spécifiez les éléments suivants :

      1. Dans la liste Instantané d'archive, sélectionnez l'instantané d'archive.
      2. Dans la liste Type de disque de démarrage, sélectionnez le type de disque de démarrage.
      3. Dans le champ Taille (Go), spécifiez la taille du disque de démarrage.

    • Pour choisir un disque existant comme disque de démarrage, cliquez sur Disques existants. Ensuite, dans l'onglet Disques existants qui s'affiche, sélectionnez un volume Persistent Disk régional ou Hyperdisk Balanced High Availability existant dans la liste Disque.

  6. Facultatif : Si le disque de démarrage est un volume Hyperdisk Balanced, vous pouvez définir des limites de performances pour le nouveau disque. Les valeurs que vous spécifiez doivent être comprises dans la plage des valeurs acceptées.

  7. Facultatif : Pour afficher les options de configuration avancées, développez la section Afficher les configurations avancées.

    • Sélectionnez le mode d'association du disque dans le champ Mode.
    • Choisissez de conserver ou de supprimer le disque lorsque l'instance est supprimée en sélectionnant l'option dans le champ Règle de suppression.
    • Pour faciliter l'identification du disque dans l'OS invité, spécifiez un nom d'appareil personnalisé. Sous l'en-tête Nom de l'appareil, sélectionnez l'option Utiliser un nom d'appareil personnalisé. Dans le champ Nom de l'appareil, saisissez une chaîne à utiliser comme lien symbolique pour le disque.

  8. Pour confirmer vos options de disque de démarrage et revenir au volet OS et stockage, cliquez sur Sélectionner.

  9. Pour créer un disque non amorçable et l'associer à votre instance, suivez les étapes ci-dessous pour chaque disque que vous souhaitez ajouter.

    1. Dans la section Disques supplémentaires, cliquez sur Ajouter un disque. Le volet Ajouter un disque s'affiche.

    2. Dans la section Configuration du disque, dans le champ Nom, spécifiez un nom pour le disque non amorçable.

    3. Facultatif : Dans le champ Description, saisissez une description du disque.

    4. Sélectionnez la source de données pour le nouveau disque :

      • Pour créer un disque vide et non formaté, sélectionnez Disque vide dans la liste Type de source du disque.
      • Pour créer une copie des données existantes, sélectionnez le type de source pour le disque non amorçable.

    5. Dans la liste Type de disque, sélectionnez un type pour le disque autre que le disque de démarrage. Le type de machine doit être compatible avec le type de disque.

    6. Dans le champ Taille, spécifiez la taille du disque non amorçable.

    7. Facultatif : Si le nouveau disque est un volume Hyperdisk, vous pouvez définir des limites de performances pour celui-ci. Les valeurs que vous spécifiez doivent être comprises dans la plage des valeurs acceptées et dépendent du type d'Hyperdisk, comme suit :

      • Hyperdisk Balanced. Vous pouvez modifier la taille, les IOPS provisionnées et le débit provisionné du disque.
      • Hyperdisk Extreme. Vous pouvez modifier la taille et les IOPS provisionnées du disque.
      • Hyperdisk ML. Vous pouvez modifier la taille et le débit provisionné du disque.
      • Hyperdisk Throughput.Vous pouvez modifier la taille et le débit provisionné du disque.

    8. Facultatif : Pour afficher les options de configuration avancées, développez la section Afficher les configurations avancées.

      • Sélectionnez le mode d'association du disque dans le champ Mode.
      • Choisissez de conserver ou de supprimer le disque lorsque l'instance est supprimée en sélectionnant l'option dans le champ Règle de suppression.
      • Pour faciliter l'identification du disque dans l'OS invité, spécifiez un nom d'appareil personnalisé. Sous l'en-tête Nom de l'appareil, sélectionnez l'option Utiliser un nom d'appareil personnalisé. Dans le champ Nom de l'appareil, saisissez une chaîne à utiliser comme lien symbolique pour le disque.

    9. Pour confirmer vos options et revenir au volet OS et stockage, cliquez sur Enregistrer.

    Répétez cette étape pour chaque disque non amorçable que vous souhaitez créer et associer à votre instance.

  10. Facultatif : spécifiez les options de sauvegarde et de réplication pour votre instance de calcul. Dans le menu de navigation, cliquez sur Protection des données. Dans le volet Protection des données qui s'affiche, spécifiez comment vous souhaitez sauvegarder et répliquer les données de votre instance de calcul en procédant comme suit.

    1. Pour spécifier comment sauvegarder les données, sélectionnez une option pour Sauvegarder vos données.

    2. Pour spécifier comment répliquer les données :

      1. Si vous souhaitez que les nouveaux disques de l'instance soient répliqués de manière synchrone dans une deuxième zone à l'aide de types de disques régionaux, cochez la case Disques régionaux.
      1. Si vous souhaitez que les disques de l'instance soient répliqués dans une deuxième région à l'aide de la réplication asynchrone, cochez la case Réplication asynchrone.

    3. Pour n'utiliser les options de protection des données spécifiées que sur les disques autres que les disques de démarrage, cochez la case Exclure les disques de démarrage.

  11. Dans le menu de navigation, cliquez sur Mise en réseau. Dans le volet Mise en réseau qui s'affiche, procédez comme suit :

    1. Accédez à la section Pare-feu.

    2. Pour autoriser le trafic HTTP ou HTTPS vers l'instance, sélectionnez Autoriser le trafic HTTP ou Autoriser le trafic HTTPS.

      Compute Engine ajoute un tag réseau à votre instance et crée la règle de pare-feu d'entrée correspondante, qui autorise l'intégralité du trafic entrant sur le port tcp:80 (HTTP) ou tcp:443 (HTTPS). Le tag réseau associe la règle de pare-feu à l'instance. Pour en savoir plus, consultez Présentation des règles de pare-feu dans la documentation de Cloud Next Generation Firewall.

  12. Facultatif : Spécifiez d'autres options de configuration. Pour en savoir plus, consultez Options de configuration lors de la création d'une instance.

  13. Pour créer et démarrer l'instance, cliquez sur Créer.

gcloud

  1. Dans la console Google Cloud , activez Cloud Shell.

    Activer Cloud Shell

    En bas de la console Google Cloud , une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement shell dans lequel Google Cloud CLI est déjà installé, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.

  2. Exécutez la commande gcloud compute instances create pour créer une instance avec des disques non amorçables supplémentaires.

    Vous pouvez ajouter jusqu'à 127 disques non amorçables lors de la création de votre instance. Spécifiez l'option --create-disk pour chaque disque non amorçable que vous créez.

    Pour créer des disques non amorçables à partir d'une image publique ou issue d'une banque d'images, spécifiez les propriétés image, image-family et image-project avec l'option --create-disk. Pour créer un disque vide, n'incluez pas ces propriétés.

    Vous pouvez éventuellement inclure des valeurs pour les propriétés suivantes :

    • Taille du disque : utilisez la propriété --size.
    • Type de disque : utilisez la propriété --type.
    • Disques régionaux : incluez la propriété replica-zones.
    gcloud compute instances create INSTANCE_NAME \
    --zone=ZONE \
    --machine-type=MACHINE_TYPE \
    --image-project=BOOT_DISK_IMAGE_PROJECT \
    BOOT_DISK_IMAGE_FLAG \
    --create-disk name=DISK_NAME,device-name=DISK_DEVICE_NAME,size=SIZE_GB,type=DISK_TYPE,image=DISK_IMAGE,image-project=DISK_IMAGE_PROJECT,replica-zones=^:^ZONE:REMOTE_ZONE,boot=false

    Remplacez les éléments suivants :

    • INSTANCE_NAME : nom de la nouvelle instance
    • ZONE : zone dans laquelle créer l'instance.
    • MACHINE_TYPE : type de machine de l'instance. Exemple :c3-standard-4
    • BOOT_DISK_IMAGE_PROJECT : projet contenant l'image. Par exemple, pour Debian, debian-cloud. Pour trouver le projet d'image correspondant aux images publiques, accédez à la page Détails des systèmes d'exploitation. Dans la section Versions GA pour votre OS, le projet d'image est listé dans la colonne Projet d'image de l'onglet Informations générales.

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

      • Utilisez le flag --image IMAGE_NAME pour spécifier une version spécifique d'une image publique ou personnalisée. Exemple : --image debian-12-bookworm-v20241112.

      • Utilisez le flag --image-family IMAGE_FAMILY_NAME pour spécifier une famille d'images. Cela crée l'instance qui utilise l'image d'OS non obsolète la plus récente de la famille d'images. Par exemple, si vous spécifiez --image-family debian-12, Compute Engine utilise la dernière version de l'image de l'OS dans la famille d'images Debian 12 lors de la création de l'instance.

    • Pour les disques supplémentaires, remplacez les éléments suivants :

      • DISK_NAME : (facultatif) nom du disque non amorçable.
      • SIZE_GB : taille facultative du disque non amorçable.
      • DISK_TYPE : le type du disque. Par exemple, hyperdisk-balanced. Le type de machine doit être compatible avec le type de disque.
      • DISK_DEVICE_NAME : (facultatif) nom du disque affiché sur l'OS invité après la création de l'instance.
      • DISK_IMAGE : facultatif : pour créer un disque à partir d'une image existante, spécifiez l'une des options suivantes :
        • image=DISK_IMAGE_NAME : nom de l'image que vous souhaitez utiliser pour créer le disque non amorçable, par exemple debian-12-bookworm-v20260210.
        • image-family=DISK_IMAGE_FAMILY : famille d'images à utiliser lors de la création d'un disque non amorçable, par exemple debian-12.
      • DISK_IMAGE_PROJECT : facultatif : pour créer un disque non amorçable à partir d'une image existante, spécifiez le projet d'image contenant l'image.
      • REMOTE_ZONE : facultatif : si vous créez un disque régional, spécifiez la zone dans laquelle le disque doit être répliqué (par exemple, us-central1-b).

      Pour les disques vides, ne spécifiez pas les paramètres image, image-project ou image-family.

      Pour les disques zonaux, ne spécifiez pas la propriété de disque replica-zones.

Terraform

Pour générer le code Terraform, vous pouvez utiliser le composant Code équivalent dans la console Google Cloud .
  1. Dans la console Google Cloud , accédez à la page Instances de VM.

    Accéder à la page "Instances de VM"

  2. Cliquez sur Créer une instance.
  3. Spécifiez les paramètres souhaités.
  4. En haut ou en bas de la page, cliquez sur Code équivalent, puis sur l'onglet Terraform pour afficher le code Terraform.

Go

Avant d'essayer cet exemple, suivez les instructions de configuration pour Go décrites dans le Guide de démarrage rapide de Compute Engine à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Go Compute Engine.

Pour vous authentifier auprès de Compute Engine, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes. 

import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "cloud.google.com/go/compute/apiv1/computepb"
	"google.golang.org/protobuf/proto"
)

// createWithAdditionalDisk create a new VM instance with Debian 10 operating system and a 11 GB additional empty disk.
func createWithAdditionalDisk(w io.Writer, projectID, zone, instanceName string) error {
	// projectID := "your_project_id"
	// zone := "europe-central2-b"
	// instanceName := "your_instance_name"

	ctx := context.Background()
	instancesClient, err := compute.NewInstancesRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewInstancesRESTClient: %w", err)
	}
	defer instancesClient.Close()

	imagesClient, err := compute.NewImagesRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewImagesRESTClient: %w", err)
	}
	defer imagesClient.Close()

	// List of public operating system (OS) images: https://cloud.google.com/compute/docs/images/os-details.
	newestDebianReq := &computepb.GetFromFamilyImageRequest{
		Project: "debian-cloud",
		Family:  "debian-12",
	}
	newestDebian, err := imagesClient.GetFromFamily(ctx, newestDebianReq)
	if err != nil {
		return fmt.Errorf("unable to get image from family: %w", err)
	}

	req := &computepb.InsertInstanceRequest{
		Project: projectID,
		Zone:    zone,
		InstanceResource: &computepb.Instance{
			Name: proto.String(instanceName),
			Disks: []*computepb.AttachedDisk{
				{
					InitializeParams: &computepb.AttachedDiskInitializeParams{
						DiskSizeGb:  proto.Int64(10),
						SourceImage: newestDebian.SelfLink,
						DiskType:    proto.String(fmt.Sprintf("zones/%s/diskTypes/pd-standard", zone)),
					},
					AutoDelete: proto.Bool(true),
					Boot:       proto.Bool(true),
					Type:       proto.String(computepb.AttachedDisk_PERSISTENT.String()),
				},
				{
					InitializeParams: &computepb.AttachedDiskInitializeParams{
						DiskSizeGb: proto.Int64(11),
						DiskType:   proto.String(fmt.Sprintf("zones/%s/diskTypes/pd-standard", zone)),
					},
					AutoDelete: proto.Bool(true),
					Boot:       proto.Bool(false),
					Type:       proto.String(computepb.AttachedDisk_PERSISTENT.String()),
				},
			},
			MachineType: proto.String(fmt.Sprintf("zones/%s/machineTypes/n1-standard-1", zone)),
			NetworkInterfaces: []*computepb.NetworkInterface{
				{
					Name: proto.String("global/networks/default"),
				},
			},
		},
	}

	op, err := instancesClient.Insert(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to create instance: %w", err)
	}

	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %w", err)
	}

	fmt.Fprintf(w, "Instance created\n")

	return nil
}

Java

Avant d'essayer cet exemple, suivez les instructions de configuration pour Java décrites dans le Guide de démarrage rapide de Compute Engine à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Java Compute Engine.

Pour vous authentifier auprès de Compute Engine, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes. 


import com.google.api.gax.longrunning.OperationFuture;
import com.google.cloud.compute.v1.AttachedDisk;
import com.google.cloud.compute.v1.AttachedDisk.Type;
import com.google.cloud.compute.v1.AttachedDiskInitializeParams;
import com.google.cloud.compute.v1.Image;
import com.google.cloud.compute.v1.ImagesClient;
import com.google.cloud.compute.v1.InsertInstanceRequest;
import com.google.cloud.compute.v1.Instance;
import com.google.cloud.compute.v1.InstancesClient;
import com.google.cloud.compute.v1.NetworkInterface;
import com.google.cloud.compute.v1.Operation;
import java.io.IOException;
import java.util.Vector;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class CreateInstancesAdvanced {

  /**
   * Create an AttachedDisk object to be used in VM instance creation. Uses an image as the source
   * for the new disk.
   *
   * @param diskType the type of disk you want to create. This value uses the following format:
   * "zones/{zone}/diskTypes/(pd-standard|pd-ssd|pd-balanced|pd-extreme)". For example:
   * "zones/us-west3-b/diskTypes/pd-ssd"
   * @param diskSizeGb size of the new disk in gigabytes
   * @param boot boolean flag indicating whether this disk should be used as a boot disk of an
   * instance
   * @param sourceImage source image to use when creating this disk. You must have read access to
   * this disk. This can be one of the publicly available images or an image from one of your
   * projects. This value uses the following format:
   * "projects/{project_name}/global/images/{image_name}"
   * @return AttachedDisk object configured to be created using the specified image.
   */
  private static AttachedDisk diskFromImage(String diskType, int diskSizeGb, boolean boot,
      String sourceImage) {
    AttachedDisk disk =
        AttachedDisk.newBuilder()
            .setBoot(boot)
            // Remember to set auto_delete to True if you want the disk to be deleted when
            // you delete your VM instance.
            .setAutoDelete(true)
            .setType(Type.PERSISTENT.toString())
            .setInitializeParams(
                AttachedDiskInitializeParams.newBuilder()
                    .setSourceImage(sourceImage)
                    .setDiskSizeGb(diskSizeGb)
                    .setDiskType(diskType)
                    .build())
            .build();
    return disk;
  }


  /**
   * Create an AttachedDisk object to be used in VM instance creation. The created disk contains no
   * data and requires formatting before it can be used.
   *
   * @param diskType the type of disk you want to create. This value uses the following format:
   * "zones/{zone}/diskTypes/(pd-standard|pd-ssd|pd-balanced|pd-extreme)". For example:
   * "zones/us-west3-b/diskTypes/pd-ssd"
   * @param diskSizeGb size of the new disk in gigabytes
   * @return AttachedDisk object configured to be created as an empty disk.
   */
  private static AttachedDisk emptyDisk(String diskType, int diskSizeGb) {
    AttachedDisk disk =
        AttachedDisk.newBuilder()
            .setBoot(false)
            // Remember to set auto_delete to True if you want the disk to be deleted when
            // you delete your VM instance.
            .setAutoDelete(true)
            .setType(Type.PERSISTENT.toString())
            .setInitializeParams(
                AttachedDiskInitializeParams.newBuilder()
                    .setDiskSizeGb(diskSizeGb)
                    .setDiskType(diskType)
                    .build())
            .build();
    return disk;
  }

  /**
   * Send an instance creation request to the Compute Engine API and wait for it to complete.
   *
   * @param project project ID or project number of the Cloud project you want to use.
   * @param zone name of the zone to create the instance in. For example: "us-west3-b"
   * @param instanceName name of the new virtual machine (VM) instance.
   * @param disks a list of compute_v1.AttachedDisk objects describing the disks you want to attach
   * to your new instance.
   * @param machineType machine type of the VM being created. This value uses the following format:
   * "zones/{zone}/machineTypes/{type_name}".
   * For example: "zones/europe-west3-c/machineTypes/f1-micro"
   * @param network name of the network you want the new instance to use. For example:
   * "global/networks/default" represents the network named "default", which is created
   * automatically for each project.
   * @param subnetwork name of the subnetwork you want the new instance to use. This value uses the
   * following format: "regions/{region}/subnetworks/{subnetwork_name}"
   * @return Instance object.
   */
  private static Instance createWithDisks(String project, String zone, String instanceName,
      Vector<AttachedDisk> disks, String machineType, String network, String subnetwork)
      throws IOException, InterruptedException, ExecutionException, TimeoutException {
    try (InstancesClient instancesClient = InstancesClient.create()) {
      // Use the network interface provided in the networkName argument.
      NetworkInterface networkInterface;
      if (subnetwork != null) {
        networkInterface = NetworkInterface.newBuilder()
            .setName(network).setSubnetwork(subnetwork)
            .build();
      } else {
        networkInterface = NetworkInterface.newBuilder()
            .setName(network).build();
      }

      machineType = String.format("zones/%s/machineTypes/%s", zone, machineType);

      // Bind `instanceName`, `machineType`, `disk`, and `networkInterface` to an instance.
      Instance instanceResource =
          Instance.newBuilder()
              .setName(instanceName)
              .setMachineType(machineType)
              .addAllDisks(disks)
              .addNetworkInterfaces(networkInterface)
              .build();

      System.out.printf("Creating instance: %s at %s ", instanceName, zone);

      // Insert the instance in the specified project and zone.
      InsertInstanceRequest insertInstanceRequest = InsertInstanceRequest.newBuilder()
          .setProject(project)
          .setZone(zone)
          .setInstanceResource(instanceResource).build();

      OperationFuture<Operation, Operation> operation = instancesClient.insertAsync(
          insertInstanceRequest);

      // Wait for the operation to complete.
      Operation response = operation.get(3, TimeUnit.MINUTES);

      if (response.hasError()) {
        System.out.println("Instance creation failed ! ! " + response);
        return null;
      }
      System.out.println("Operation Status: " + response.getStatus());

      return instancesClient.get(project, zone, instanceName);
    }
  }

  /**
   * Create a new VM instance with Debian 11 operating system and a 11 GB additional empty disk.
   *
   * @param project project ID or project number of the Cloud project you want to use.
   * @param zone name of the zone to create the instance in. For example: "us-west3-b"
   * @param instanceName name of the new virtual machine (VM) instance.
   * @return Instance object.
   */
  public static Instance createWithAdditionalDisk(String project, String zone, String instanceName)
      throws IOException, InterruptedException, ExecutionException, TimeoutException {
    try (ImagesClient imagesClient = ImagesClient.create()) {
      // List of public operating system (OS) images: https://cloud.google.com/compute/docs/images/os-details
      Image image = imagesClient.getFromFamily("debian-cloud", "debian-11");
      String diskType = String.format("zones/%s/diskTypes/pd-standard", zone);
      Vector<AttachedDisk> disks = new Vector<>();
      disks.add(diskFromImage(diskType, 10, true, image.getSelfLink()));
      disks.add(emptyDisk(diskType, 11));
      return createWithDisks(project, zone, instanceName, disks, "n1-standard-1",
          "global/networks/default", null);
    }
  }

Node.js

Avant d'essayer cet exemple, suivez les instructions de configuration Node.js décrites dans le guide de démarrage rapide de Compute Engine sur l'utilisation des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Node.js Compute Engine.

Pour vous authentifier auprès de Compute Engine, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes. 

/**
 * TODO(developer): Uncomment and replace these variables before running the sample.
 */
// const projectId = 'YOUR_PROJECT_ID';
// const zone = 'europe-central2-b';
// const instanceName = 'YOUR_INSTANCE_NAME';

const compute = require('@google-cloud/compute');

// Create a new VM instance with Debian 10 operating system and a 11 GB additional empty disk.
async function createWithAdditionalDisk() {
  const instancesClient = new compute.InstancesClient();
  const imagesClient = new compute.ImagesClient();

  // List of public operating system (OS) images: https://cloud.google.com/compute/docs/images/os-details.
  const [newestDebian] = await imagesClient.getFromFamily({
    project: 'debian-cloud',
    family: 'debian-11',
  });

  const [response] = await instancesClient.insert({
    project: projectId,
    zone,
    instanceResource: {
      name: instanceName,
      disks: [
        {
          initializeParams: {
            diskSizeGb: '10',
            sourceImage: newestDebian.selfLink,
            diskType: `zones/${zone}/diskTypes/pd-standard`,
          },
          autoDelete: true,
          boot: true,
          type: 'PERSISTENT',
        },
        {
          initializeParams: {
            diskSizeGb: '11',
            diskType: `zones/${zone}/diskTypes/pd-standard`,
          },
          autoDelete: true,
          boot: false,
          type: 'PERSISTENT',
        },
      ],
      machineType: `zones/${zone}/machineTypes/n1-standard-1`,
      networkInterfaces: [
        {
          name: 'global/networks/default',
        },
      ],
    },
  });
  let operation = response.latestResponse;
  const operationsClient = new compute.ZoneOperationsClient();

  // Wait for the create operation to complete.
  while (operation.status !== 'DONE') {
    [operation] = await operationsClient.wait({
      operation: operation.name,
      project: projectId,
      zone: operation.zone.split('/').pop(),
    });
  }

  console.log('Instance created.');
}

createWithAdditionalDisk();

Python

Avant d'essayer cet exemple, suivez les instructions de configuration pour Python décrites dans le Guide de démarrage rapide de Compute Engine à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Python Compute Engine.

Pour vous authentifier auprès de Compute Engine, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes. 

from __future__ import annotations

import re
import sys
from typing import Any
import warnings

from google.api_core.extended_operation import ExtendedOperation
from google.cloud import compute_v1


def get_image_from_family(project: str, family: str) -> compute_v1.Image:
    """
    Retrieve the newest image that is part of a given family in a project.

    Args:
        project: project ID or project number of the Cloud project you want to get image from.
        family: name of the image family you want to get image from.

    Returns:
        An Image object.
    """
    image_client = compute_v1.ImagesClient()
    # List of public operating system (OS) images: https://cloud.google.com/compute/docs/images/os-details
    newest_image = image_client.get_from_family(project=project, family=family)
    return newest_image


def disk_from_image(
    disk_type: str,
    disk_size_gb: int,
    boot: bool,
    source_image: str,
    auto_delete: bool = True,
) -> compute_v1.AttachedDisk:
    """
    Create an AttachedDisk object to be used in VM instance creation. Uses an image as the
    source for the new disk.

    Args:
         disk_type: the type of disk you want to create. This value uses the following format:
            "zones/{zone}/diskTypes/(pd-standard|pd-ssd|pd-balanced|pd-extreme)".
            For example: "zones/us-west3-b/diskTypes/pd-ssd"
        disk_size_gb: size of the new disk in gigabytes
        boot: boolean flag indicating whether this disk should be used as a boot disk of an instance
        source_image: source image to use when creating this disk. You must have read access to this disk. This can be one
            of the publicly available images or an image from one of your projects.
            This value uses the following format: "projects/{project_name}/global/images/{image_name}"
        auto_delete: boolean flag indicating whether this disk should be deleted with the VM that uses it

    Returns:
        AttachedDisk object configured to be created using the specified image.
    """
    boot_disk = compute_v1.AttachedDisk()
    initialize_params = compute_v1.AttachedDiskInitializeParams()
    initialize_params.source_image = source_image
    initialize_params.disk_size_gb = disk_size_gb
    initialize_params.disk_type = disk_type
    boot_disk.initialize_params = initialize_params
    # Remember to set auto_delete to True if you want the disk to be deleted when you delete
    # your VM instance.
    boot_disk.auto_delete = auto_delete
    boot_disk.boot = boot
    return boot_disk


def empty_disk(
    disk_type: str, disk_size_gb: int, boot: bool = False, auto_delete: bool = True
) -> compute_v1.AttachedDisk():
    """
    Create an AttachedDisk object to be used in VM instance creation. The created disk contains
    no data and requires formatting before it can be used.

    Args:
         disk_type: the type of disk you want to create. This value uses the following format:
            "zones/{zone}/diskTypes/(pd-standard|pd-ssd|pd-balanced|pd-extreme)".
            For example: "zones/us-west3-b/diskTypes/pd-ssd"
        disk_size_gb: size of the new disk in gigabytes
        boot: boolean flag indicating whether this disk should be used as a boot disk of an instance
        auto_delete: boolean flag indicating whether this disk should be deleted with the VM that uses it

    Returns:
        AttachedDisk object configured to be created as an empty disk.
    """
    disk = compute_v1.AttachedDisk()
    initialize_params = compute_v1.AttachedDiskInitializeParams()
    initialize_params.disk_type = disk_type
    initialize_params.disk_size_gb = disk_size_gb
    disk.initialize_params = initialize_params
    # Remember to set auto_delete to True if you want the disk to be deleted when you delete
    # your VM instance.
    disk.auto_delete = auto_delete
    disk.boot = boot
    return disk


def wait_for_extended_operation(
    operation: ExtendedOperation, verbose_name: str = "operation", timeout: int = 300
) -> Any:
    """
    Waits for the extended (long-running) operation to complete.

    If the operation is successful, it will return its result.
    If the operation ends with an error, an exception will be raised.
    If there were any warnings during the execution of the operation
    they will be printed to sys.stderr.

    Args:
        operation: a long-running operation you want to wait on.
        verbose_name: (optional) a more verbose name of the operation,
            used only during error and warning reporting.
        timeout: how long (in seconds) to wait for operation to finish.
            If None, wait indefinitely.

    Returns:
        Whatever the operation.result() returns.

    Raises:
        This method will raise the exception received from `operation.exception()`
        or RuntimeError if there is no exception set, but there is an `error_code`
        set for the `operation`.

        In case of an operation taking longer than `timeout` seconds to complete,
        a `concurrent.futures.TimeoutError` will be raised.
    """
    result = operation.result(timeout=timeout)

    if operation.error_code:
        print(
            f"Error during {verbose_name}: [Code: {operation.error_code}]: {operation.error_message}",
            file=sys.stderr,
            flush=True,
        )
        print(f"Operation ID: {operation.name}", file=sys.stderr, flush=True)
        raise operation.exception() or RuntimeError(operation.error_message)

    if operation.warnings:
        print(f"Warnings during {verbose_name}:\n", file=sys.stderr, flush=True)
        for warning in operation.warnings:
            print(f" - {warning.code}: {warning.message}", file=sys.stderr, flush=True)

    return result


def create_instance(
    project_id: str,
    zone: str,
    instance_name: str,
    disks: list[compute_v1.AttachedDisk],
    machine_type: str = "n1-standard-1",
    network_link: str = "global/networks/default",
    subnetwork_link: str = None,
    internal_ip: str = None,
    external_access: bool = False,
    external_ipv4: str = None,
    accelerators: list[compute_v1.AcceleratorConfig] = None,
    preemptible: bool = False,
    spot: bool = False,
    instance_termination_action: str = "STOP",
    custom_hostname: str = None,
    delete_protection: bool = False,
) -> compute_v1.Instance:
    """
    Send an instance creation request to the Compute Engine API and wait for it to complete.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        zone: name of the zone to create the instance in. For example: "us-west3-b"
        instance_name: name of the new virtual machine (VM) instance.
        disks: a list of compute_v1.AttachedDisk objects describing the disks
            you want to attach to your new instance.
        machine_type: machine type of the VM being created. This value uses the
            following format: "zones/{zone}/machineTypes/{type_name}".
            For example: "zones/europe-west3-c/machineTypes/f1-micro"
        network_link: name of the network you want the new instance to use.
            For example: "global/networks/default" represents the network
            named "default", which is created automatically for each project.
        subnetwork_link: name of the subnetwork you want the new instance to use.
            This value uses the following format:
            "regions/{region}/subnetworks/{subnetwork_name}"
        internal_ip: internal IP address you want to assign to the new instance.
            By default, a free address from the pool of available internal IP addresses of
            used subnet will be used.
        external_access: boolean flag indicating if the instance should have an external IPv4
            address assigned.
        external_ipv4: external IPv4 address to be assigned to this instance. If you specify
            an external IP address, it must live in the same region as the zone of the instance.
            This setting requires `external_access` to be set to True to work.
        accelerators: a list of AcceleratorConfig objects describing the accelerators that will
            be attached to the new instance.
        preemptible: boolean value indicating if the new instance should be preemptible
            or not. Preemptible VMs have been deprecated and you should now use Spot VMs.
        spot: boolean value indicating if the new instance should be a Spot VM or not.
        instance_termination_action: What action should be taken once a Spot VM is terminated.
            Possible values: "STOP", "DELETE"
        custom_hostname: Custom hostname of the new VM instance.
            Custom hostnames must conform to RFC 1035 requirements for valid hostnames.
        delete_protection: boolean value indicating if the new virtual machine should be
            protected against deletion or not.
    Returns:
        Instance object.
    """
    instance_client = compute_v1.InstancesClient()

    # Use the network interface provided in the network_link argument.
    network_interface = compute_v1.NetworkInterface()
    network_interface.network = network_link
    if subnetwork_link:
        network_interface.subnetwork = subnetwork_link

    if internal_ip:
        network_interface.network_i_p = internal_ip

    if external_access:
        access = compute_v1.AccessConfig()
        access.type_ = compute_v1.AccessConfig.Type.ONE_TO_ONE_NAT.name
        access.name = "External NAT"
        access.network_tier = access.NetworkTier.PREMIUM.name
        if external_ipv4:
            access.nat_i_p = external_ipv4
        network_interface.access_configs = [access]

    # Collect information into the Instance object.
    instance = compute_v1.Instance()
    instance.network_interfaces = [network_interface]
    instance.name = instance_name
    instance.disks = disks
    if re.match(r"^zones/[a-z\d\-]+/machineTypes/[a-z\d\-]+$", machine_type):
        instance.machine_type = machine_type
    else:
        instance.machine_type = f"zones/{zone}/machineTypes/{machine_type}"

    instance.scheduling = compute_v1.Scheduling()
    if accelerators:
        instance.guest_accelerators = accelerators
        instance.scheduling.on_host_maintenance = (
            compute_v1.Scheduling.OnHostMaintenance.TERMINATE.name
        )

    if preemptible:
        # Set the preemptible setting
        warnings.warn(
            "Preemptible VMs are being replaced by Spot VMs.", DeprecationWarning
        )
        instance.scheduling = compute_v1.Scheduling()
        instance.scheduling.preemptible = True

    if spot:
        # Set the Spot VM setting
        instance.scheduling.provisioning_model = (
            compute_v1.Scheduling.ProvisioningModel.SPOT.name
        )
        instance.scheduling.instance_termination_action = instance_termination_action

    if custom_hostname is not None:
        # Set the custom hostname for the instance
        instance.hostname = custom_hostname

    if delete_protection:
        # Set the delete protection bit
        instance.deletion_protection = True

    # Prepare the request to insert an instance.
    request = compute_v1.InsertInstanceRequest()
    request.zone = zone
    request.project = project_id
    request.instance_resource = instance

    # Wait for the create operation to complete.
    print(f"Creating the {instance_name} instance in {zone}...")

    operation = instance_client.insert(request=request)

    wait_for_extended_operation(operation, "instance creation")

    print(f"Instance {instance_name} created.")
    return instance_client.get(project=project_id, zone=zone, instance=instance_name)


def create_with_additional_disk(
    project_id: str, zone: str, instance_name: str
) -> compute_v1.Instance:
    """
    Create a new VM instance with Debian 10 operating system on a 20 GB disk
    and a 25 GB additional empty disk.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        zone: name of the zone to create the instance in. For example: "us-west3-b"
        instance_name: name of the new virtual machine (VM) instance.

    Returns:
        Instance object.
    """
    newest_debian = get_image_from_family(project="debian-cloud", family="debian-12")
    disk_type = f"zones/{zone}/diskTypes/pd-standard"
    disks = [
        disk_from_image(disk_type, 20, True, newest_debian.self_link),
        empty_disk(disk_type, 25),
    ]
    instance = create_instance(project_id, zone, instance_name, disks)
    return instance

REST

Vous pouvez créer jusqu'à 127 disques non amorçables au moment de la création d'une instance, en utilisant la propriété initializeParams pour chaque disque supplémentaire. Créez des disques supplémentaires avec une image publique ou privée. Pour ajouter un disque vide, définissez l'entrée initializeParams sans valeur sourceImage. Incluez la propriété de disque replicaZones pour créer des disques régionaux plutôt que des disques zonaux.

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

{
   "machineType":"zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
   "name":"VM_NAME",
   
   "disks":[
      {
         "initializeParams":{
            "sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE"
         },
         "boot":true
      },
      {
         "initializeParams":{
            "diskSizeGb":"SIZE_GB",
            "sourceImage":"projects/DISK_IMAGE_PROJECT/global/images/DISK_IMAGE",
            "diskType":"DISK_TYPE"
         }
      },
      {
         "initializeParams":{
            "diskSizeGb":"SIZE_GB",
            "diskType":"DISK_TYPE"
         },
      },
      {
         "boot": false,
         "deviceName":"DISK_NAME",
         "initializeParams": {
            "diskType": "DISK_TYPE",
            "replicaZones": [
               "projects/PROJECT_ID/zones/ZONE",
               "projects/PROJECT_ID/zones/REMOTE_ZONE"
            ]
         }
      }
   ],
   
   
   "networkInterfaces":[
      {
         "network":"global/networks/NETWORK_NAME"
      }
   ],
   
  
   "shieldedInstanceConfig":{
      "enableSecureBoot":"ENABLE_SECURE_BOOT"
   }
}

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel créer la VM.
  • ZONE : zone dans laquelle créer la VM.
  • MACHINE_TYPE_ZONE : zone contenant le type de machine à utiliser pour la nouvelle VM.
  • MACHINE_TYPE : type de machine, prédéfini ou personnalisé, pour la nouvelle VM.
  • VM_NAME : nom de la nouvelle VM.
  • IMAGE_PROJECT : projet contenant l'image.
    Par exemple, si vous spécifiez debian-10 comme famille d'images, spécifiez debian-cloud comme projet d'image.
  • IMAGE : Spécifiez l'une des options suivantes :

    • IMAGE : version spécifique d'une image publique.

      Par exemple : "sourceImage": "projects/debian-cloud/global/images/debian-10-buster-v20200309"

    • IMAGE_FAMILY : famille d'images.

      Cela crée la VM à partir de l'image d'OS non obsolète la plus récente. Par exemple, si vous spécifiez "sourceImage": "projects/debian-cloud/global/images/family/debian-10", Compute Engine crée une VM à partir de la version de l'image d'OS la plus récente dans la famille d'images Debian 10.

  • Pour les disques supplémentaires, remplacez les éléments suivants :

    • SIZE_GB : taille du disque
    • DISK_IMAGE ou
    • DISK_IMAGE_FAMILY : spécifiez une image source ou une famille d'images source pour le disque non amorçable :
      • DISK_IMAGE : nom de l'image que vous souhaitez utiliser comme disque non amorçable. Par exemple, "sourceImage": "projects/DISK_IMAGE_PROJECT/global/images/DISK_IMAGE".
      • DISK_IMAGE_FAMILY : famille d'images à utiliser comme disque non amorçable. Exemple :"sourceImage": "projects/DISK_IMAGE_PROJECT/global/images/family/DISK_IMAGE_FAMILY"
    • DISK_TYPE : URL complète ou partielle du type du type de disque. Par exemple, https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/hyperdisk-balanced. Le type de machine doit être compatible avec le type de disque.
    • DISK_NAME : facultatif. Nom du disque affiché sur l'OS invité après la création de la VM.

    • REMOTE_ZONE : zone vers laquelle répliquer le disque régional.

    Pour les disques vides, ne spécifiez pas la propriété sourceImage.

    Pour les disques zonaux, ne spécifiez pas la propriété replicaZones.

  • NETWORK_NAME : réseau VPC que vous souhaitez utiliser pour la VM. Vous pouvez spécifier default pour utiliser votre réseau par défaut.

  • ENABLE_SECURE_BOOT : (facultatif) si vous avez choisi une image compatible avec les fonctionnalités de VM protégée, Compute Engine active par défaut le module vTPM et la surveillance de l'intégrité. Compute Engine n'active pas le démarrage sécurisé par défaut.

    Si vous spécifiez true pour enableSecureBoot, Compute Engine crée une VM avec les trois fonctionnalités de VM protégée activées. Une fois que Compute Engine a démarré votre VM, vous devez l'arrêter pour modifier les options de VM protégée.

Après avoir créé l'instance, vous devez formater les disques vides et installer tous les disques pour pouvoir les utiliser.