Kapazität einer Managed Lustre-Instanz erhöhen

Sie können die Speicherkapazität Ihrer Managed Lustre-Instanz erhöhen. Die Kapazität kann nicht verringert werden.

Wenn Sie die Kapazität einer Instanz erhöhen, können Sie die Instanz während des Aktualisierungsvorgangs weiterhin verwenden.

Einschränkungen bei der Kapazitätserhöhung

Bei Leistungsstufen mit zwei verschiedenen Schrittgrößen bestimmt die aktuelle Kapazität der Instanz ihre maximal mögliche Größe.

Wenn die Kapazität einer Instanz dem Schwellenwert für die Schrittgröße entspricht oder darunter liegt, kann ihre Größe bis zum Schwellenwert erhöht werden. Sie kann nicht über dieses Limit hinaus erweitert werden.

In der Stufe mit 250 MB/s pro TiB liegt der Schwellenwert, bei dem sich die Schrittgröße ändert, beispielsweise bei 10.224.000 GiB. Jede Instanz,die mit einer Kapazität von maximal diesem Schwellenwert erstellt wurde,kann nur bis zu diesem Limit von 10.224.000 GiB erweitert werden.

Neue Kapazität berechnen

Sie können die Kapazität einer Instanz bis zum maximal zulässigen Wert für die Leistungsstufe und Schrittgröße aktualisieren. Diese Werte sind:

Leistungsstufe Minimale Kapazität Maximale Kapazität Schrittgröße
1.000 MB/s pro TiB 9.000 GiB 10.008.000 GiB (9,5 PiB) Für Speicherkapazitäten bis zu 2.556.000 GiB: 9.000 GiB
Für größere Speicherkapazitäten: 72.000 GiB
500 MB/s pro TiB 18.000 GiB 20.016.000 GiB (19,1 PiB) Für Speicherkapazitäten bis zu 5.112.000 GiB: 18.000 GiB
Für größere Speicherkapazitäten: 144.000 GiB
250 MB/s pro TiB 36.000 GiB 40.032.000 GiB (38,2 PiB) Für Speicherkapazitäten bis zu 10.224.000 GiB: 36.000 GiB
Für größere Speicherkapazitäten: 288.000 GiB
125 MB/s pro TiB 72.000 GiB 20.448.000 GiB (19,5 PiB) 72.000 GiB
Dynamisch (25 MB/s pro TiB) 472.000 GiB 84.016.000 GiB (80,1 PiB) 472.000 GiB

Die aktualisierte Kapazität muss ein Vielfaches der Schrittgröße sein und darf das Maximum für diese Schrittgröße nicht überschreiten.

Ihr Google Cloud -Projekt hat Durchsatz- und Kapazitätskontingente, die sich auf die verfügbare Kapazität pro VPC-Netzwerk (Virtual Private Cloud) pro Zone auswirken. Möglicherweise müssen Sie ein zusätzliches Durchsatz- oder Kapazitätskontingent anfordern, bevor Sie die Kapazität Ihrer Instanz erhöhen können. Weitere Informationen finden Sie unter Kontingente und Limits.

Kapazitätsrechner

Verwenden Sie den folgenden Rechner, um eine gültige Kapazität für die ausgewählte Leistungsstufe zu ermitteln.

Instanzkapazität aktualisieren

Sie können die Kapazität der Instanz über die Google Cloud Console oder die Google Cloud CLI aktualisieren.

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Seite Managed Lustre auf.

    Zu Managed Lustre

  2. Klicken Sie auf den Instanznamen der Instanz, die Sie aktualisieren möchten. Die Übersichtsseite der Instanz wird angezeigt.

  3. Klicken Sie auf Bearbeiten.

  4. Geben Sie den neuen Wert für die Speicherkapazität ein. Der Wert muss kleiner oder gleich der maximal zulässigen Kapazität und ein Vielfaches der Schrittgröße sein. Informationen zu diesen Werten finden Sie unter Neue Kapazität berechnen.

  5. Klicken Sie auf Senden.

gcloud

Verwenden Sie den Befehl gcloud lustre instances update, um die Speicherkapazität Ihrer Instanz zu erhöhen:

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY

Wobei:

  • INSTANCE_NAME ist die zu aktualisierende Instanz.
  • LOCATION ist die Zone, in der sich die Instanz befindet.
  • NEW_CAPACITY ist die neue Speicherkapazität für diese Instanz in Gibibyte (GiB). Der Wert darf die maximal zulässige Kapazität nicht überschreiten und muss ein Vielfaches der Schrittgröße sein. Informationen zu diesen Werten finden Sie unter Neue Kapazität berechnen.

REST

Wenn Sie eine Instanz mit der REST API aktualisieren möchten, senden Sie eine PATCH-Anfrage an den entsprechenden Endpunkt:

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=capacityGib
Authorization: Bearer [YOUR_ACCESS_TOKEN]

{
  "capacityGib": NEW_CAPACITY
}

Dabei müssen die folgenden Werte angegeben werden:

  • PROJECT_ID ist Ihre Google Cloud Projekt-ID.
  • ZONE ist die Google Cloud Zone der Instanz.
  • INSTANCE_NAME ist der Name der zu aktualisierenden Managed Lustre-Instanz.
  • updateMask=capacityGib gibt das zu aktualisierende Feld an. Ein Feld wird nur überschrieben, wenn es in der Maske enthalten ist.
  • NEW_CAPACITY ist die neue Speicherkapazität für diese Instanz in Gibibyte (GiB). Der Wert darf die maximal zulässige Kapazität nicht überschreiten und muss ein Vielfaches der Schrittgröße sein. Informationen zu diesen Werten finden Sie unter Neue Kapazität berechnen.

Weitere Informationen finden Sie in der API-Referenz zu instances.patch.

Nachdem die Aktualisierungsanfrage gesendet wurde, prüft Managed Lustre Ihr verfügbares Kontingent. Wenn ausreichend Kontingent vorhanden ist, wird die Instanzkapazität je nach Größenänderung über einen bestimmten Zeitraum erhöht. Erhöhungen können zwischen 20 Minuten und einer Stunde oder länger dauern.

Sie können Ihre Instanz während des Updates weiterhin verwenden.

Aktualisierungsstatus ansehen

Sie können den Status einer Aktualisierungsanfrage über die folgenden Schnittstellen einsehen.

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Seite Managed Lustre auf.

    Zu Managed Lustre

  2. Klicken Sie in der Liste auf den Instanznamen. Die Seite Instanzdetails wird angezeigt. Sie enthält den aktuellen Status Ihrer Anfrage zur Instanzaktualisierung.

gcloud

Standardmäßig wartet der Befehl gcloud lustre instances update, bis der Vorgang abgeschlossen ist, bevor die Shell-Eingabeaufforderung zurückgegeben wird:

Request issued for: [my-instance]
Waiting for operation [projects/my-project/locations/us-central1-a/operations/operation-1234567890-123] to complete...

Nach Abschluss des Vorgangs werden in der Befehlszeile Updated instance [my-instance] und die Instanzdetails, einschließlich der aktualisierten Kapazität, angezeigt.

Wenn Sie den Aktualisierungsbefehl mit dem Flag --async ausgeführt haben oder den Aktualisierungsstatus anderweitig über die Befehlszeile abfragen müssen, können Sie die Vorgangsdetails abrufen, um zu sehen, ob die Aktualisierung der Instanz abgeschlossen ist:

gcloud lustre operations describe OPERATION_ID \
  --location=ZONE

Während die Instanz aktualisiert wird, wird in der Antwort der Wert done: false angezeigt. Nach Abschluss ist done auf true festgelegt.

Beispiel:

$ gcloud lustre operations describe operation-1234567890-123abc456-789def012-a1b2c3d4 \
    --location=us-central1-a

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.lustre.v1.OperationMetadata
  apiVersion: v1
  createTime: '2025-08-27T18:13:49.771203623Z'
  requestedCancellation: false
  target: projects/my-project/locations/us-central1-a/instances/my-instance
  verb: update
name: projects/my-project/locations/us-central1-a/operations/operation-1234567890-123abc456-789def012-a1b2c3d4

REST

Verwenden Sie die Vorgangs-ID aus der Antwort, um den Status eines Aktualisierungsvorgangs abzufragen. Die Vorgangs-ID hat das folgende Format:

  • operation-1234567890123-6127783ad26ea-88913969-02748053

Senden Sie eine Anfrage an den folgenden Endpunkt:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/operations/OPERATION_ID
Authorization: Bearer

Bei erfolgreicher Ausführung enthält der Antworttext eine Operation-Instanz.

Leistung nach Erhöhung der Kapazität

Der maximale Durchsatz einer Managed Lustre-Instanz wird durch ihre Speicherkapazität und Leistungsstufe bestimmt. Wenn Sie die Speicherkapazität einer vorhandenen Instanz erhöhen, erhöht sich auch der maximale Durchsatz.

Die Leistungssteigerung ist möglicherweise erst sichtbar, wenn neue Daten geschrieben wurden. Die Durchsatzleistung verbessert sich allmählich, wenn neue Daten geschrieben und auf den zusätzlichen Speicher verteilt werden.

Fehler „Kein Speicherplatz mehr auf dem Gerät“

Wenn Ihr Dateisystem fast voll ist (in der Regel mehr als 90 % Auslastung), erhalten Sie möglicherweise vorzeitig No space left on device- oder FILESYSTEM_NO_SPACE_ON_DEVICE-Fehler (ENOSPC), auch wenn Monitoring-Tools anzeigen, dass noch freier Speicherplatz verfügbar ist.

Dieses Verhalten kann aufgrund mehrerer zugrunde liegender Mechanismen in verteilten Dateisystemen auftreten:

  • OST-Ungleichgewicht: Lustre verteilt Dateidaten auf mehrere Objektspeicherziele (OSTs). Bestimmte Arbeitslastmuster können jedoch unabhängig von Ihrer Striping-Konfiguration ein einzelnes OST füllen. Häufige Ursachen sind das Schreiben von Dateien im Anfügemodus (O_APPEND) oder das Beibehalten großer nicht verknüpfter Dateien.

  • Fehler nach der Erweiterung: Möglicherweise erhalten Sie auch nach dem Hinzufügen von Kapazität zu Ihrem Cluster weiterhin ENOSPC-Fehler. Durch das Erweitern der Kapazität werden zwar neue OSTs hinzugefügt, Ihre vorhandenen Dateien werden jedoch nicht automatisch auf die neu hinzugefügten Ziele verteilt.

  • Client-Speicherplatz-Zuweisungen: Compute Engine-Clients reservieren dynamisch Teile des Speicherplatzes, um die Leistung zu verbessern. Dieser reservierte Speicherplatz reduziert den verfügbaren physischen Pool. Das bedeutet, dass Kapazitätsmesswerte möglicherweise nicht den Speicherplatz widerspiegeln, den verteilte Clients bereits beansprucht haben.

  • Inode-Erschöpfung: Arbeitslasten, die Millionen von Dateien generieren, können die verfügbaren Inodes des Dateisystems erschöpfen, bevor die physischen Speicherlimits erreicht sind. Dies führt zu ENOSPC-Fehlern beim Erstellen neuer Dateien.

Empfohlene Abhilfemaßnahmen:

  • Kapazität überwachen und Benachrichtigungen einrichten: Überwachen Sie die Kapazitätsauslastung pro OST und die einzelnen Inode-Messwerte zusätzlich zur aggregierten Clusterkapazität. Führen Sie den Befehl lfs df von einem bereitgestellten Client aus, um die Kapazitätsnutzung pro Ziel aufzurufen. Verwenden Sie lfs df -i für die Inode-Nutzung pro Ziel oder rufen Sie Instanzen und Vorgänge überwachen auf, um Details zu Monitoring-Messwerten zu erhalten.

    Richten Sie automatisierte Benachrichtigungen ein, die ausgelöst werden, wenn die Gesamtkapazität oder die Auslastung einzelner OSTs 80 % überschreitet (siehe Benachrichtigung zur Speicherkapazität erstellen).

  • Kapazität erhöhen: Wenn die Gesamtkapazität 80–90 % erreicht, sollten Sie die Kapazität Ihrer Managed Lustre-Instanz erhöhen. Möglicherweise müssen Sie vor der Erweiterung zusätzliches Kontingent anfordern.

  • Speicher neu ausgleichen: Verwenden Sie den Befehl lfs migrate, vorzugsweise im nicht blockierenden Modus (-n), um Dateien manuell von überlasteten OSTs auf leerere oder neu hinzugefügte OSTs zu übertragen.

  • Suchen Sie auf Clients nach nicht verknüpften Dateien: Offene, nicht verknüpfte Dateien sind große Dateien, die von einem Prozess auch nach dem Aufheben der Verknüpfung mit dem Namespace des Dateisystems offen gehalten werden. Diese verwaisten Dateien verbleiben auf dem Laufwerk und belegen Speicherplatz, sind aber in Standardverzeichnislisten nicht sichtbar. In diesem Fall melden die Cloud Monitoring-Kapazitätsmesswerte und der Befehl lfs df eine höhere Speicherplatznutzung als du oder lfs find. Verwenden Sie den Befehl lsof auf Clients, um diese Dateien zu identifizieren. Suchen Sie dazu nach Einträgen, die als (deleted) markiert sind. Sobald der Prozess identifiziert wurde, wird der Speicherplatz im Dateisystem freigegeben, indem der Prozess, der das Dateihandle enthält, beendet oder die Anwendung neu gestartet wird.