Ajouter un disque persistant à votre VM


Vous pouvez créer un disque persistant vide ou créer un disque à partir d'une source de données. Vous pouvez utiliser un disque persistant comme disque de démarrage pour une instance de machine virtuelle (VM) ou comme disque de données que vous associez à une VM.

Ce document explique comment :

  • Créez un disque persistant zonal non amorçable vide et associez-le à votre VM.

Si vous souhaitez créer un disque de démarrage que vous pourrez utiliser ultérieurement pour créer une VM, consultez la section Créer un disque de démarrage personnalisé.

Si vous souhaitez ajouter un disque Google Cloud Hyperdisk à votre VM, consultez la section Ajouter un stockage Hyperdisk à une VM.

Si vous devez formater ou installer un disque persistant sur votre VM, consultez les pages suivantes :

Pour obtenir des informations générales sur les disques persistants et les types de disques disponibles, consultez la présentation des disques persistants.

Avant de commencer

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

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

    Console

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

    gcloud

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

      gcloud init
    2. Définissez une région et une zone par défaut.

    Terraform

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

    1. Installez Google Cloud CLI.
    2. Pour initialiser gcloudCLI, exécutez la commande suivante :

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

      gcloud auth application-default login

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

    REST

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

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

      gcloud init

Restrictions

  • Lors de la création de la VM, vous pouvez associer jusqu'à 127 disques persistants zonaux non amorçables secondaires.
  • Vous pouvez utiliser une capacité associée totale de 257 To par VM. Pour en savoir plus sur la façon d'optimiser les performances avec des volumes de plus grande taille, consultez la section Taille du volume logique.

Ajouter un disque non amorçable à votre VM

Créez et associez un disque zonal non amorçable à l'aide de la console Google Cloud, de la Google Cloud CLI ou de REST.

Si vous créez un disque dans la console Google Cloud, le type de disque par défaut est pd-balanced. Si vous créez un disque à l'aide de la gcloud CLI ou de REST, le type de disque par défaut est pd-standard.

Vous devez spécifier un nom d'appareil personnalisé lorsque vous associez le disque à une VM. Le nom que vous spécifiez est utilisé pour générer un lien symbolique pour le disque dans le système d'exploitation invité, ce qui facilite l'identification.

Console

  1. Accédez à la page Instances de VM.

    Accéder à la page "Instances de VM"

  2. Cliquez sur le nom de la VM à laquelle vous souhaitez ajouter un disque.

  3. Sur la page des détails, cliquez sur Modifier.

  4. Sous Disques supplémentaires, cliquez sur Ajouter un disque.

  5. Spécifiez un nom pour le disque, configurez les propriétés du disque et sélectionnez Vide comme Type de source.

  6. (Facultatif) Sous l'en-tête Nom de l'appareil, sélectionnez l'option Utiliser un nom d'appareil personnalisé. Le nom que vous saisissez est utilisé pour générer un lien symbolique pour le disque, ce qui facilite l'identification du disque.

  7. Cliquez sur Terminé pour terminer la configuration du disque.

  8. Cliquez sur Enregistrer pour appliquer les modifications apportées à la VM et ajouter le nouveau disque.

gcloud

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

    Activer Cloud Shell

    En bas de la fenêtre 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. Utilisez la commande gcloud compute disks create pour créer le disque persistant zonal.

    gcloud compute disks create DISK_NAME \
      --size DISK_SIZE \
      --type DISK_TYPE
    

    Remplacez l'élément suivant :

    • DISK_NAME : le nom du nouveau disque.
    • DISK_SIZE : la taille, en Go, du nouveau disque. Les tailles acceptées sont comprises entre 10 et 65 536 Go inclus (augmentation par incréments de 1 Go).
    • DISK_TYPE : URL complète ou partielle du type du disque persistant. Exemple : https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/pd-ssd.
  3. Après avoir créé le disque, associez-le à une VM en cours d'exécution ou arrêtée. Exécutez la commande gcloud compute instances attach-disk :

    gcloud compute instances attach-disk VM_NAME \
      --disk DISK_NAME --device-name=DEVICE_NAME
    

    Remplacez les éléments suivants :

    • VM_NAME : le nom de la VM à laquelle vous ajoutez le disque persistant zonal.
    • DISK_NAME : le nom du nouveau disque que vous associez à la VM.
    • DEVICE_NAME : (facultatif) le nom utilisé par le système d'exploitation invité pour identifier le disque.
  4. Utilisez la commande gcloud compute disks describe pour afficher la description de votre disque

Terraform

Pour créer un disque, utilisez la ressource google_compute_disk.

# Using pd-standard because it's the default for Compute Engine

resource "google_compute_disk" "default" {
  name = "disk-data"
  type = "pd-standard"
  zone = "us-west1-a"
  size = "5"
}

Pour associer le disque à une VM, utilisez la ressource google_compute_instance.

resource "google_compute_instance" "test_node" {
  name         = "test-node"
  machine_type = "f1-micro"
  zone         = "us-west1-a"

  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-11"
    }
  }
  attached_disk {
    source      = google_compute_disk.default.id
    device_name = google_compute_disk.default.name
  }

  network_interface {
    network = "default"
    access_config {
      # Ephemeral IP
    }
  }

  # Ignore changes for persistent disk attachments
  lifecycle {
    ignore_changes = [attached_disk]
  }

}

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

REST

  1. Envoyez une requête POST pour créer un disque persistant zonal à l'aide de la méthode disks.insert. Incluez les propriétés name, sizeGb et type. Pour créer un disque non amorçable vide et non formaté, ne spécifiez pas d'image source, ni d'instantané source.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks
    
    {
     "name": "DISK_NAME",
     "sizeGb": "DISK_SIZE",
     "type": "DISK_TYPE"
    }
    

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projet.
    • ZONE : la zone où se trouvent la VM et le nouveau disque.
    • DISK_NAME : le nom du nouveau disque.
    • DISK_SIZE : la taille, en Go, du nouveau disque. Les tailles acceptées sont comprises entre 10 et 65 536 Go inclus (augmentation par incréments de 1 Go).
    • DISK_TYPE : URL complète ou partielle du type du disque persistant. Exemple : https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/pd-ssd.
  2. Envoyez une requête POST à la méthode compute.instances.attachDisk et incluez l'URL du disque persistant zonal que vous venez de créer.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/attachDisk
    
    {
     "source": "/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME",
     "deviceName": DEVICE_NAME
    }
    

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projet.
    • ZONE : la zone dans laquelle se trouvent l'instance et le disque.
    • VM_NAME : le nom de la VM à laquelle vous ajoutez le disque persistant.
    • DISK_NAME : le nom du nouveau disque
    • DEVICE_NAME : (facultatif) le nom utilisé par le système d'exploitation invité pour identifier le disque.

Après avoir créé le disque et l'avoir associé à une VM, vous devez le formater et l'installer afin que le système d'exploitation puisse utiliser l'espace de stockage disponible.

Étapes suivantes