Nichtflüchtigen Speicher zu Instanz hinzufügen

Sie können entweder einen leeren nichtflüchtigen Speicher oder ein Laufwerk aus einer Datenquelle erstellen. Sie können einen nichtflüchtigen Speicher als Bootlaufwerk für eine VM-Instanz oder als Datenlaufwerk verwenden, das Sie an eine VM anhängen.

In diesem Dokument wird Folgendes erläutert:

  • Erstellen Sie einen leeren zonalen nichtflüchtigen Speicher ohne Startfunktion und hängen Sie ihn an Ihre VM an.

Informationen zum Erstellen eines Bootlaufwerks, das Sie später zum Erstellen einer VM verwenden können, finden Sie unter Angepasstes Bootlaufwerk erstellen.

Informationen zum Hinzufügen eines Google Cloud-Hyperdisk-Laufwerks zu Ihrer VM finden Sie unter Hyperdisk-Speicher zu einer VM hinzufügen.

Informationen zum Formatieren oder Bereitstellen eines nichtflüchtigen Speichers auf der VM finden Sie unter:

Allgemeine Informationen zu nichtflüchtigen Speichern und den verfügbaren Typen finden Sie in der Übersicht über nichtflüchtige Speicher.

Hinweise

  • Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud-Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren.

    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

      Wenn Sie die Terraform-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.

      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.

      Weitere Informationen unter Set up authentication for a local development environment.

      REST

      Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

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

        gcloud init

      Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.

Einschränkungen

  • Bei der Erstellung einer VM können Sie bis zu 127 sekundäre zonale nichtflüchtige Speicher ohne Startfunktion anhängen.
  • Sie haben die Möglichkeit, pro VM 257 TB anzuhängen. Informationen zur Gewährleistung der maximalen Leistung bei großen Datenmengen finden Sie unter Logische Volume-Größe.

Nicht-Bootlaufwerk zur VM hinzufügen

Verwenden Sie für das Erstellen und Anhängen eines zonalen Nicht-Bootlaufwerks die Google Cloud Console, die Google Cloud CLI oder REST.

Wenn Sie ein Laufwerk in der Google Cloud Console erstellen, ist der Standard-Laufwerktyp pd-balanced. Wenn Sie ein Laufwerk mit der gcloud CLI oder REST erstellen, ist der Standardlaufwerkstyp pd-standard.

Sie sollten einen benutzerdefinierten Gerätenamen angeben, wenn Sie das Laufwerk an eine VM anhängen. Der angegebene Name wird verwendet, um einen Symlink für das Laufwerk im Gastbetriebssystem zu generieren. So wird die Identifizierung vereinfacht.

Console

  1. Rufen Sie die Seite VM-Instanzen auf.

    Zur Seite „VM-Instanzen"

  2. Klicken Sie auf den Namen der VM, der Sie ein Laufwerk hinzufügen möchten.

  3. Klicken Sie auf der Detailseite auf Bearbeiten.

  4. Klicken Sie unter Zusätzliche Laufwerke auf Laufwerk hinzufügen.

  5. Geben Sie einen Namen für das Laufwerk an, konfigurieren Sie die Laufwerkseigenschaften und wählen Sie als Quelltyp Leer aus.

  6. Optional: Wählen Sie unter der Überschrift Gerätename die Option Benutzerdefinierten Gerätenamen verwenden aus. Der eingegebene Name wird verwendet, um einen Symlink für das Laufwerk zu generieren. Dies vereinfacht die Identifizierung des Laufwerks.

  7. Klicken Sie auf Fertig, um die Konfiguration des Laufwerks abzuschließen.

  8. Klicken Sie auf Speichern, um die Änderungen für die VM zu übernehmen und das neue Laufwerk hinzuzufügen.

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. Verwenden Sie den Befehl gcloud compute disks create, um den zonalen nichtflüchtigen Speicher zu erstellen.

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

    Ersetzen Sie Folgendes:

    • DISK_NAME: durch den Namen des neuen Laufwerks.
    • DISK_SIZE: durch die Größe des neuen Laufwerks in Gigabyte. Die Größe innerhalb des zulässigen Bereichs von 10 GB bis einschließlich 65.536 GB kann in 1-GB-Schritten festgelegt werden.
    • DISK_TYPE ist die vollständige oder partielle URL für den Typ des nichtflüchtigen Speichers. Beispiel: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/pd-ssd

  3. Nachdem Sie das Laufwerk erstellt haben, hängen Sie es an eine laufende oder gestoppte VM an. Führen Sie folgenden gcloud compute instances attach-disk-Befehl aus:

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

    Ersetzen Sie Folgendes:

    • VM_NAME: der Name der VM, der Sie den neuen zonalen nichtflüchtigen Speicher hinzufügen.
    • DISK_NAME: der Name des neuen Laufwerks, das Sie an die VM anhängen.
    • DEVICE_NAME: Optional: ein Name, mit dem das Gastbetriebssystem das Laufwerk identifiziert.

  4. Verwenden Sie den Befehl gcloud compute disks describe, um eine Beschreibung des Laufwerks aufzurufen.

Terraform

Verwenden Sie zum Erstellen eines Laufwerks die 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"
}

Verwenden Sie die Ressource google_compute_instance, um das Laufwerk an eine VM anzuhängen.

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]
  }

}

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.

REST

  1. Erstellen Sie eine POST-Anfrage, um mit der Methode disks.insert einen zonalen nichtflüchtigen Speicher zu erstellen. Fügen Sie die Attribute name, sizeGb und type hinzu. Wenn Sie das Laufwerk leer, unformatiert und ohne Bootfunktion erstellen möchten, geben Sie weder ein Quell-Image noch einen Quell-Snapshot an.

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

{
 "name": "DISK_NAME",
 "sizeGb": "DISK_SIZE",
 "type": "DISK_TYPE"
}

    Ersetzen Sie Folgendes:

    • PROJECT_ID ist Ihre Projekt-ID.
    • ZONE ist die Zone, in der sich Ihre VM und das neue Laufwerk befinden.
    • DISK_NAME: durch den Namen des neuen Laufwerks.
    • DISK_SIZE: durch die Größe des neuen Laufwerks in Gigabyte. Die Größe innerhalb des zulässigen Bereichs von 10 GB bis einschließlich 65.536 GB kann in 1-GB-Schritten festgelegt werden.
    • DISK_TYPE: die vollständige oder partielle URL für den Typ des nichtflüchtigen Speichers. Beispiel: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/pd-ssd.

  2. Erstellen Sie eine POST-Anfrage für die Methode compute.instances.attachDisk und fügen Sie die URL dem zonalen nichtflüchtigen Speicher hinzu, den Sie gerade erstellt haben:

    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
}

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Ihre Projekt-ID.
    • ZONE ist die Zone, in der sich Ihre VM und das neue Laufwerk befinden
    • VM_NAME: der Name der VM, der Sie den neuen nichtflüchtigen Speicher hinzufügen
    • DISK_NAME: Name des neuen Laufwerks
    • DEVICE_NAME: Optional: ein Name, mit dem das Gastbetriebssystem das Laufwerk identifiziert.

Nachdem Sie das neue Laufwerk erstellt und an eine VM angehängt haben, müssen Sie es formatieren und bereitstellen, damit das Betriebssystem den verfügbaren Speicherplatz nutzen kann.

Nächste Schritte