Ajouter un stockage Hyperdisk à une VM

Vous pouvez utiliser un volume Hyperdisk Extreme ou Hyperdisk Throughput avec votre VM en effectuant les tâches suivantes :

  • Créez un volume Hyperdisk vide, non amorçable et zonal, puis associez-le à votre VM lors de sa création ou dans des tâches distinctes.
  • Formatez et installez le volume pour fournir l'accès à un système de données ou de fichiers.

Le processus est le même pour les volumes Hyperdisk Balanced, sauf que vous pouvez également créer des disques de démarrage de type Hyperdisk Balanced.

Pour obtenir des informations générales sur l'Hyperdisk, consultez la page À propos de l'Hyperdisk.

Avant de commencer

  • Passez en revue les limites de l'Hyperdisk avant d'ajouter un volume d'Hyperdisk à votre VM.
  • 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. 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.

Rôles et autorisations requis

Pour obtenir les autorisations nécessaires pour ajouter un volume Hyperdisk à votre VM, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :

Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Ces rôles prédéfinis contiennent les autorisations requises pour ajouter un volume Hyperdisk à votre VM. Pour afficher les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Vous devez disposer des autorisations suivantes pour ajouter un volume Hyperdisk à votre VM :

  • Pour créer et associer un volume Hyperdisk, procédez comme suit :
    • compute.disks.create sur le projet
    • compute.instances.attachDisk sur la VM.
    • compute.disks.use sur le volume que vous souhaitez associer à la VM.
  • Pour formater et installer le volume associé : compute.instances.setMetadata sur la VM

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

Ajouter un volume Hyperdisk à votre VM

Vous pouvez créer et associer un volume Hyperdisk à l'aide de la console Google Cloud, de la Google Cloud CLI ou de REST.

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 Informations sur l'instance de VM, cliquez sur Modifier.

  4. Dans l'en-tête Disques supplémentaires, cliquez sur Ajouter un disque.

  5. Spécifiez un nom pour le disque et ajoutez éventuellement une description. Sélectionnez Disque vide comme Type de source du disque.

  6. Sous Paramètres du disque, choisissez l'une des options suivantes pour le type de disque :

    1. Hyperdisk équilibré. Vous pouvez également modifier les paramètres par défaut pour la Taille, les IOPS provisionnées et le Débit provisionné du disque.
    2. Hyperdisk Extreme. Vous pouvez également modifier les paramètres par défaut de taille et d'IOPS provisionnées du disque.
    3. Hyperdisk Throughput. Vous pouvez également modifier les paramètres par défaut de taille et de débit provisionné du disque.

  7. Cliquez sur Enregistrer.

  8. Dans la fenêtre Modifier de votre VM, cliquez sur Enregistrer pour appliquer vos modifications à la VM et ajouter le nouveau disque.

gcloud

  1. Utilisez la commande gcloud compute disks create pour créer le volume hyperdisque.

    gcloud compute disks create DISK_NAME \
   --zone=ZONE \
   --size=DISK_SIZE \
   --type=DISK_TYPE \
   --provisioned-iops=IOPS_LIMIT
   --provisioned-throughput=THROUGHPUT_LIMIT

    Remplacez les éléments suivants :

    • DISK_NAME : le nom du nouveau disque.
    • ZONE : le nom de la zone dans laquelle le disque est en cours de création.
    • DISK_SIZE : Facultatif : taille du nouveau disque. La valeur doit être un nombre entier suivi d'une unité de taille (Go pour des gibioctets, To pour des tébioctets). Si aucune unité de taille n'est spécifiée, la valeur par défaut est 100 Go. Les valeurs acceptées pour la taille du disque sont les suivantes :
      • Hyperdisk Balanced : de 4 Gio à 64 Tio inclus, par incréments de 1 Gio.
      • Hyperdisk Extreme : de 64 Gio à 64 Tio inclus, par incréments de 1 Gio.
      • Hyperdisk Throughput : de 2 Tio à 32 Tio inclus, par incréments de 1 Gio.
    • DISK_TYPE : le type de disque. Utilisez l'une des valeurs suivantes : hyperdisk-balanced, hyperdisk-extreme ou hyperdisk-throughput.

    • IOPS_LIMIT : Facultatif : Pour les disques Hyperdisk Balanced ou Hyperdisk Extreme, il s'agit du nombre d'opérations d'E/S par seconde (IOPS) que le disque peut gérer. Les IOPS doivent être spécifiées dans les limites suivantes :

      • Hyperdisk équilibré :
        • Valeur minimale : valeur la plus faible entre 500 IOPS par Gio de capacité de disque ou 3 000
        • Valeur maximale : valeur la plus faible entre 500 IOPS par Gio ou 160 000 IOPS
      • Hyperdisk Extreme
        • Valeur minimale : deux IOPS par Gio de capacité de disque.
        • Valeur maximale : valeur inférieure de 1 200 fois la capacité mesurée en Gio, soit 350 000.

      Si vous ne spécifiez pas de valeur pour les IOPS ou la taille du disque, une valeur par défaut est utilisée :

      • Hyperdisk Balanced : le nombre d'IOPS par défaut est de 3 600. Si vous spécifiez une taille pour le disque, la valeur par défaut dépend de cette taille :
        • 6 Gio ou moins : 500 IOPS par Gio de taille de disque.
        • Plus de 6 Gio : valeur la plus faible entre 3 000 + 6 IOPS par Gio de taille de disque, ou 160 000.
      • Hyperdisk Extreme : la valeur par défaut est la valeur la plus faible entre 100 fois la capacité du disque mesurée en Gio ou le nombre maximal d'IOPS pour le type de machine.

      Par exemple, vous pouvez provisionner des IOPS comme suit pour Hyperdisk Extreme sur une VM C3 :

      • Pour un disque de 64 Gio, vous pouvez provisionner des IOPS comprises entre 128 et 64 000. La valeur par défaut de IOPS est de 6 400.
      • Pour un disque de 64 000 Gio, vous pouvez provisionner des IOPS comprises entre 128 000 et 350 000. Le nombre d'IOPS par défaut est de 350 000.

    • THROUGHPUT_LIMIT : Facultatif : pour les volumes Hyperdisk Balanced ou Hyperdisk Throughput, il s'agit d'un entier représentant le débit, mesuré en Mio par seconde, que le disque peut gérer. Le débit doit être spécifié dans les limites suivantes :

      • Hyperdisk équilibré :
        • Valeur minimale : la valeur la plus élevée entre le nombre d'IOPS divisé par 256 et 140 Mio/s.
        • Valeur maximale : la valeur maximale d'IOPS divisée par 256, ou 2 400 Mio/s.
      • Hyperdisk Throughput :
        • Valeur minimale : 10 Mo/s par Tio de capacité.
        • Valeur maximale : la valeur la plus basse entre 600 Mo/s par volume et 90 Mo/s par Tio de capacité.

      Si vous ne spécifiez pas de valeur pour les IOPS, le débit ou la taille du disque, une valeur par défaut est utilisée.

      • Hyperdisk Balanced : le débit par défaut est de 140 Mio/s. Si vous spécifiez une taille pour le disque, la valeur par défaut dépend de cette taille :
        • 6 Gio ou moins : 140 Mio/s.
        • Plus de 6 Gio : valeur inférieure, ((6 * disk size in GiB) / 4) + 140, ou 2 400 Mio/s.
      • Hyperdisk Throughput : le débit par défaut est de 90 Mio/s par Tio de capacité de disque, sans dépasser le débit maximal accepté par disque.

  2. Facultatif : Utilisez la commande gcloud compute disks describe DISK_NAME pour afficher la description de votre disque.

  3. Après avoir créé le disque, vous pouvez l'associer à une VM.

REST

  1. Envoyez une requête POST pour créer un Hyperdisk zonal à l'aide de la méthode disks.insert. Incluez les propriétés name, sizeGb, type, provisionedIops et provisionedThroughput. 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": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE",
   "provisionedIops": "IOPS_LIMIT",
   "provisionedThroughput": "THROUGHPUT_LIMIT"
}

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projet.
    • ZONE : la zone dans laquelle se trouvent l'instance et le disque.
    • DISK_NAME : le nom du nouveau disque
    • DISK_SIZE (facultatif) : taille du nouveau disque. La valeur doit être un nombre entier suivi d'une unité de taille (GB pour des gibioctets, TB pour des tébioctets). Tailles acceptées pour chaque plage de type de disque, par incréments de 1 Gio :
      • Hyperdisk Balanced : de 4 Gio à 64 Tio (inclus).
      • Hyperdisk Extreme : de 64 Gio à 64 Tio (inclus).
      • Hyperdisk Throughput : de 2 Tio à 32 Tio (inclus).
    • DISK_TYPE : le type de disque. Pour créer un volume Hyperdisk, utilisez l'une des valeurs suivantes : hyperdisk-balanced, hyperdisk-extreme ou hyperdisk-throughput.

    • IOPS_LIMIT (facultatif) : pour les volumes Hyperdisk Balanced et Hyperdisk Extreme, il s'agit du nombre d'opérations d'E/S par seconde que le disque peut gérer. Les IOPS doivent être spécifiées dans les limites suivantes :

      • Valeur minimale :
        • Hyperdisk Balanced : valeur la plus faible entre 500 IOPS par Gio de capacité de disque ou 3 000.
        • Hyperdisk Extreme : deux IOPS par Gio de capacité de disque.
      • Valeur maximale :
        • Hyperdisk Balanced : valeur la plus faible entre 500 IOPS par Gio de capacité de disque et 160 000 IOPS
        • Hyperdisk Extreme : valeur la plus faible entre 1 000 IOPS par Gio de capacité de disque ou le nombre maximum d'IOPS pour le type de machine.

      Si vous ne spécifiez pas de valeur pour les IOPS, une valeur par défaut est utilisée :

      • Hyperdisk Balanced : 3 600 IOPS si la taille de disque n'est pas spécifiée. Si vous spécifiez une taille pour le disque, la valeur par défaut dépend de cette taille :
        • 6 Gio ou moins : 500 IOPS par Gio de taille de disque.
        • Plus de 6 Gio : valeur la plus faible entre 3 000 + 6 IOPS par Gio de taille de disque, ou 160 000.
      • Hyperdisk Extreme : valeur la plus faible entre 100 IOPS par Gio de capacité de disque ou le nombre maximal d'IOPS pour le type de machine.

      Par exemple, vous pouvez provisionner des IOPS comme suit pour un disque Hyperdisk Extreme sur une VM C3 :

      • Pour un disque de 64 Gio, vous pouvez provisionner des IOPS comprises entre 128 et 64 000. La valeur par défaut de IOPS est de 6 400.
      • Pour un disque de 64 Tio, vous pouvez provisionner des IOPS compris entre 128 000 et 350 000. Le nombre d'IOPS par défaut est de 350 000.

    • THROUGHPUT_LIMIT : Facultatif : pour les volumes Hyperdisk Balanced ou Hyperdisk Throughput, il s'agit d'un entier représentant le débit, mesuré en Mio par seconde, que le disque peut gérer. Le débit doit être spécifié dans les limites suivantes :

      • Hyperdisk équilibré :
        • Valeur minimale : la valeur la plus élevée entre le nombre d'IOPS divisé par 256 et 140 Mio/s.
        • Valeur maximale : IOPS divisées par 256, mais pas plus de 2 400 Mio/s
      • Hyperdisk Throughput :
        • Valeur minimale : 10 Mo/s par Tio de capacité.
        • Valeur maximale : la valeur la plus basse entre 600 Mo/s par volume et 90 Mo/s par Tio de capacité.

      Si vous ne spécifiez pas de valeur pour les IOPS, le débit ou la taille du disque, une valeur par défaut est utilisée.

      • Hyperdisk Balanced : le débit par défaut est de 140 Mio/s. Si vous spécifiez une taille pour le disque, la valeur par défaut dépend de cette taille :
        • 6 Gio ou moins : 140 Mio/s.
        • Plus de 6 Gio : valeur la plus faible entre ((6 * disk size in GiB) / 4) + 140 et 2 400 Mio/s.
      • Hyperdisk Throughput : le débit par défaut est de 90 Mio/s par Tio de capacité de disque, sans dépasser le débit maximal accepté par disque.

  2. Facultatif : Utilisez la méthode compute.disks.get pour afficher la description de votre disque

  3. Après avoir créé le disque, vous pouvez l'associer à n'importe quelle VM en cours d'exécution ou arrêtée.

Formater et installer le disque

Après avoir créé et associé le disque à 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