Managed Lustre-Instanz erstellen

Eine Google Cloud Managed Lustre-Instanz ist ein vollständiges Lustre-Dateisystem in der Cloud. Sie kann auf einer Compute Engine-VM oder in einem Kubernetes Engine-Cluster bereitgestellt werden. Sie greifen mit standardmäßiger POSIX-Terminologie auf Daten in der Instanz zu.

Beim Erstellen einer verwalteten Lustre-Instanz müssen Sie die folgenden Attribute definieren:

  • Der Name der Instanz, der von Google Cloudverwendet wird.
  • Der Dateisystemname, der von clientseitigen Tools wie lfs verwendet wird.
  • Die Speicherkapazität in Gibibyte (GiB). Die Kapazität kann zwischen 9.000 GiB und 12.240.000 GiB (11,67 PiB) liegen. Die maximale Größe einer Instanz hängt von ihrer Leistungsstufe ab.
  • Die Leistungsstufe. Managed Lustre bietet Leistungsstufen von 125 MB/s pro TiB bis 1.000 MB/s pro TiB.
  • Der Standort Für eine optimale Leistung sollte sich die Instanz in derselben Zone wie Ihre Client-VMs oder Ihr GKE-Cluster befinden.
  • Das VPC-Netzwerk für diese Instanz. Dies muss dasselbe Netzwerk sein, das für Ihre VMs oder Cluster verwendet wird.
  • Gibt an, ob auf diese Instanz über einen Kubernetes Engine-Cluster (GKE) zugegriffen wird. Da sowohl Lustre als auch GKE standardmäßig Port 988 verwenden, wird durch diese Einstellung der Lustre-Port geändert, um Konflikte zu vermeiden.

Leistungsstufen und maximale Speicherkapazitäten

Managed Lustre bietet vier Leistungsstufen mit jeweils unterschiedlicher maximaler Durchsatzgeschwindigkeit pro TiB. Leistungsstufen wirken sich auch auf die Mindest- und Höchstinstanzgröße sowie auf die Schrittgröße zwischen akzeptablen Kapazitätswerten aus.

Stufe Mindestkapazität Maximale Kapazität Schrittgröße
125 MB/s pro TiB 72.000 GiB 12.240.000 GiB (11,67 PiB) 72.000 GiB
250 MB/s pro TiB 36.000 GiB 6.120.000 GiB (5,84 PiB) 36.000 GiB
500 MB/s pro TiB 18.000 GiB 3.060.000 GiB (2,92 PiB) 18.000 GiB
1.000 MB/s pro TiB 9.000 GiB 1.530.000 GiB (1,46 PiB) 9.000 GiB

Sie können die Leistungsstufe einer Instanz nach dem Erstellen nicht mehr ändern.

Erforderliche Berechtigungen

Wenn Sie eine neue Managed Lustre-Instanz erstellen möchten, benötigen Sie die IAM-Berechtigungen für Managed Lustre-Administrator (roles/lustre.admin) für Ihr Projekt.

Weitere Informationen finden Sie unter Zugriffssteuerung mit IAM.

Sie müssen auch die Managed Lustre API aktiviert haben.

Instanz erstellen

Sie können eine neue Managed Lustre-Instanz über die folgenden Schnittstellen erstellen.

gcloud

Verwenden Sie den Befehl gcloud lustre instances create, um eine neue verwaltete Lustre-Instanz zu erstellen:

gcloud lustre instances create INSTANCE_ID \
  --per-unit-storage-throughput=PER_UNIT_STORAGE_THROUGHPUT \
  --capacity-gib=CAPACITY_GIB \
  --filesystem=FILESYSTEM \
  --location=LOCATION \
  --network=NETWORK_PATH

Die folgenden Werte müssen angegeben werden:

  • INSTANCE_ID ist der Name dieser Managed Lustre-Instanz. Sie muss:

    • Er darf nur Kleinbuchstaben, Ziffern und Bindestriche umfassen.
    • Muss mit einem Buchstaben beginnen.
    • Muss 1–63 Zeichen umfassen.
    • Muss mit einer Ziffer oder einem Buchstaben enden.
    • Sie muss für das Projekt und den Standort eindeutig sein.

  • --per-unit-storage-throughput ist der maximale Durchsatz der Instanz in MBps pro TiB. Gültige Werte sind 125, 250, 500 und 1000. Die Wahl des Durchsatzes wirkt sich auf die minimale und maximale Speicherkapazität der Instanz aus.

  • --capacity-gib ist die Speicherkapazität der Instanz in Gibibyte (GiB). Die zulässigen Werte hängen von der von Ihnen angegebenen Speicherdurchsatzstufe ab. Weitere Informationen finden Sie im Abschnitt Leistungsstufen und maximale Speicherkapazitäten.

  • --filesystem ist der Name, der diesem Lustre-Dateisystem zugewiesen werden soll. Dieser Name wird von clientseitigen Befehlen wie mount und lfs verwendet. Sie darf maximal 8 Zeichen lang sein, darf nur Buchstaben und/oder Ziffern enthalten und muss die Groß-/Kleinschreibung beachten.

    Es wird empfohlen, einen Namen zu wählen, der für alle Managed Lustre-Instanzen in der VPC eindeutig ist. So können mehrere Instanzen von einem einzelnen GKE-Knoten aus verwendet werden.

  • --location muss eine gültige Google Cloud Zone sein, die von Managed Lustre unterstützt wird. Eine vollständige Liste finden Sie unter Unterstützte Standorte.

  • --network ist der vollständige Pfad des VPC-Netzwerk, zu dem die Instanz gehört, im Format projects/PROJECT_ID/global/networks/NETWORK. Weitere Informationen finden Sie unter VPC-Netzwerk konfigurieren.

  • --project ist die Google Cloud Projekt-ID.

Die optionalen Flags sind:

  • Mit --kms-key-name wird ein vom Kunden verwalteter Verschlüsselungsschlüssel angegeben, mit dem diese Instanz verschlüsselt werden soll. Weitere Informationen finden Sie unter Kundenverwaltete Verschlüsselungsschlüssel für Managed Lustre.

  • Mit --gke-support-enabled wird eine Instanz erstellt, die von Google Kubernetes Engine-Clustern verwendet werden kann. Dadurch wird der Lustre-LNet-accept_port auf 6988 festgelegt.

    Wenn Sie von einer Compute Engine-VM aus eine Verbindung herstellen möchten, wenn --gke-support-enabled angegeben ist, müssen Sie die LNet-Konfigurationsdatei auf der VM aktualisieren. Weitere Informationen finden Sie unter LNet für gke-support-enabled-Instanzen konfigurieren.

  • --async (optional) führt den Befehl asynchron aus. Anstatt darauf zu warten, dass die Instanzerstellung abgeschlossen ist, gibt die Google Cloud CLI eine Vorgangs-ID zurück, mit der der Status des Befehls abgefragt werden kann.

Bei einer erfolgreichen Anfrage wird eine Vorgangs-ID zurückgegeben:

Create request issued for: [$INSTANCE_ID]
Waiting for operation [projects/$PROJECT_ID/locations/us-central1-a/operations/
operation-1234567890-609d21deae6f0-befaf0bc-867b1aa1] to complete...

Die Erstellung einer Instanz mit einer Kapazität von 9.000 GiB dauert etwa 15 Minuten. Bei einer Instanz mit einer Kapazität von 12.240.000 GiB (11,67 PiB) kann es bis zu einer Stunde dauern. Eine Anleitung zum Prüfen des Status Ihrer Anfrage finden Sie unter Status der Instanzerstellung abfragen.

REST

Um eine Instanz mit der REST API zu erstellen, senden Sie eine Anfrage an den folgenden Endpunkt:

POST https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances?instanceId=INSTANCE_ID
Authorization: Bearer AUTH_TOKEN
{
  "filesystem": string,
  "perUnitStorageThroughput": int64,
  "capacityGib": int64,
  "network": string,
  "gkeSupportEnabled": boolean
}

Die folgenden Werte müssen angegeben werden:

  • PROJECT_ID ist die Google Cloud Projekt-ID.

  • ZONE muss eine gültige Google Cloud Zone sein, die von Managed Lustre unterstützt wird. Eine vollständige Liste finden Sie unter Unterstützte Standorte.

  • INSTANCE_ID ist der Name dieser verwalteten Lustre-Instanz. Sie muss:

    • Er darf nur Kleinbuchstaben, Ziffern und Bindestriche umfassen.
    • Muss mit einem Buchstaben beginnen.
    • Muss 1–63 Zeichen umfassen.
    • Muss mit einer Ziffer oder einem Buchstaben enden.
    • Sie muss für das Projekt und den Standort eindeutig sein.

  • filesystem ist der Name, der diesem Lustre-Dateisystem zugewiesen werden soll. Dieser Name wird von clientseitigen Befehlen wie mount und lfs verwendet. Sie darf maximal 8 Zeichen lang sein, darf nur Buchstaben und/oder Ziffern enthalten und muss die Groß-/Kleinschreibung beachten.

    Es wird empfohlen, einen Dateisystemnamen zu wählen, der für alle Managed Lustre-Instanzen in der VPC eindeutig ist. So können mehrere Instanzen von einem einzelnen GKE-Knoten aus verwendet werden.

  • perUnitStorageThroughput ist der maximale Durchsatz der Instanz in MBps pro TiB. Gültige Werte sind 125, 250, 500 und 1000. Die Wahl des Durchsatzes wirkt sich auf die minimale und maximale Speicherkapazität der Instanz aus.

  • capacityGib ist die Speicherkapazität der Instanz in Gibibyte (GiB). Die zulässigen Werte hängen von der von Ihnen angegebenen Speicherdurchsatzstufe ab. Weitere Informationen finden Sie im Abschnitt Leistungsstufen und maximale Speicherkapazitäten.

  • network ist der vollständige Pfad des VPC-Netzwerk, zu dem die Instanz gehört, im Format projects/PROJECT_ID/global/networks/NETWORK. Weitere Informationen finden Sie unter VPC-Netzwerk konfigurieren.

Die folgenden Felder sind optional:

  • Mit kmsKey wird ein vom Kunden verwalteter Verschlüsselungsschlüssel angegeben, mit dem diese Instanz verschlüsselt werden soll. Weitere Informationen finden Sie unter Kundenverwaltete Verschlüsselungsschlüssel für Managed Lustre.

  • gkeSupportEnabled gibt an, dass diese Instanz von Google Kubernetes Engine-Clustern verwendet werden kann. Dadurch wird der Lustre-LNet-accept_port auf 6988 festgelegt.

    Wenn Sie von einer Compute Engine-VM aus eine Verbindung herstellen möchten, wenn gkeSupportEnabled angegeben ist, müssen Sie die LNet-Konfigurationsdatei auf der VM aktualisieren. Weitere Informationen finden Sie unter LNet für gke-support-enabled-Instanzen konfigurieren.

Die API unterstützt zusätzliche optionale Felder für Instanzen. Eine vollständige Liste und Beschreibungen finden Sie in der Referenzdokumentation zur Instance-Ressource.

Google Cloud Console

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

    Zu Managed Lustre

  2. Klicken Sie auf Erstellen. Die Seite Instanz erstellen wird angezeigt.

  3. Geben Sie einen eindeutigen Instanznamen und optional eine Beschreibung ein. Der Instanzname wird von Google Cloud verwendet, um diese Instanz zu identifizieren.

  4. Geben Sie einen Namen für das Dateisystem ein. Dies ist der Name, der von clientseitigen Tools wie lfs verwendet wird. Sie darf maximal 8 Zeichen lang sein, darf nur Buchstaben und/oder Ziffern enthalten und muss die Groß-/Kleinschreibung beachten.

  5. Wählen Sie eine Region und eine Zone aus, in der diese Instanz erstellt werden soll. Ihre Instanz sollte sich in derselben Region und Zone wie die Compute Engine-VMs oder Google Kubernetes Engine-Cluster befinden, die eine Verbindung zu ihr herstellen.

  6. Wählen Sie die Leistungsstufe für diese Instanz aus.

  7. Geben Sie die Speicherkapazität Ihrer Instanz in Gibibyte (GiB) an. Gültige Werte hängen von der ausgewählten Stufe für den Speicherdurchsatz ab. Weitere Informationen finden Sie im Abschnitt Leistungsstufen und maximale Speicherkapazitäten.

  8. Wählen Sie im Abschnitt Verschlüsselung entweder Von Google verwalteter Verschlüsselungsschlüssel oder Cloud Key Management Service-Schlüssel aus. Informationen zur Option für Cloud Key Management Service-Schlüssel finden Sie unter Kundenverwaltete Verschlüsselungsschlüssel für Managed Lustre.

  9. Wenn Sie über einen GKE-Cluster eine Verbindung zu dieser Instanz herstellen möchten, wählen Sie GKE-Unterstützung aktivieren aus. Mit dieser Option wird der Lustre-LNet-accept_port auf 6988 festgelegt.

    Wenn Sie eine Verbindung von einer Compute Engine-VM herstellen möchten, wenn GKE-Unterstützung aktivieren angegeben ist, müssen Sie die LNet-Konfigurationsdatei auf der VM aktualisieren. Weitere Informationen finden Sie unter LNet für gke-support-enabled-Instanzen konfigurieren.

  10. Wählen Sie das Netzwerk aus, das Sie unter VPC-Netzwerk erstellen erstellt haben.

Der Abschnitt Zusammenfassung der Seite wird aktualisiert und zeigt eine Kostenschätzung basierend auf Ihren Auswahlmöglichkeiten an.

Klicken Sie auf Senden, um fortzufahren. Die Erstellung der Instanz dauert je nach Instanzkapazität 15 Minuten bis eine Stunde.

Status der Instanzerstellung abfragen

Sie können den Status einer Erstellungsanfrage über die folgenden Schnittstellen abfragen.

gcloud

Wenn Sie den Status eines Erstellungsvorgangs abfragen möchten, können Sie entweder den Vorgang oder die Instanz abrufen.

So rufen Sie die Instanz ab:

gcloud lustre instances describe INSTANCE_NAME \
  --location=ZONE

Der Erstellungsstatus ist der Wert von state.

Verwenden Sie zum Abrufen des Vorgangs die Vorgangs-ID aus der Antwort auf die Instanzerstellung. Die Vorgangs-ID hat das folgende Format:

  • operation-1234567890123-6127783ad26ea-88913969-02748053
gcloud lustre operations describe OPERATION_ID \
  --location=LOCATION

Der Erstellungsstatus ist der Wert von done.

Wenn die Instanz erstellt wurde, sieht das Ergebnis einer GET-Anfrage für die Instanz in etwa so aus:

Notieren Sie sich die IP-Adresse im Feld mountPoint und den Namen des Dateisystems. Sie benötigen diese Werte, wenn Sie die Instanz einbinden.

capacityGib: '27000'
createTime: '2025-03-14T00:07:34.308574307Z'
filesystem: lustre-fs
mountPoint: 10.115.0.3@tcp:/testfs
name: projects/$PROJECT/locations/us-central1-a/instances/$INSTANCE_NAME
network: projects/$PROJECT/global/networks/default
state: ACTIVE
updateTime: '2025-03-14T00:15:37.101024263Z'

REST

Verwenden Sie die Vorgangs-ID aus der Antwort, um den Status eines Erstellungsvorgangs 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.

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Seite Verwaltetes 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 Instanzerstellung.

Nächste Schritte