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 :

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. 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. Install the Google Cloud CLI.

      2. To initialize the gcloud CLI, run the following command: 

        gcloud init

      3. If you're using a local shell, then create local authentication credentials for your user account: 

        gcloud auth application-default login

        You don't need to do this if you're using Cloud Shell.

      Pour en savoir plus, consultez Set up authentication for a local development environment.

      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.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud.

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. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  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.

compute/add_persistent_disk/main.tf 
# 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.

compute/add_persistent_disk/main.tf 
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