Managed Lustre-Instanz erstellen

Eine Google Cloud Managed Lustre-Instanz ist ein vollständiges Lustre-Dateisystem in der Cloud. Sie kann in eine Compute Engine-VM oder einen Google Kubernetes Engine-Cluster (GKE) eingebunden werden. Sie greifen mit der standardmäßigen POSIX-Terminologie auf Daten in der Instanz zu.

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

  • Der Name der Instanz, verwendet von Google Cloud.
  • Der Name des Dateisystems, verwendet von clientseitigen Tools wie lfs.
  • Die Speicherkapazität in Gibibyte (GiB). Die Kapazität kann zwischen 9.000 GiB und 84.016.000 GiB (80,1 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 sowie eine dynamische Stufe, die die Leistung basierend auf den Datenzugriffsmustern optimiert und einen Gesamtdurchsatz von 25 MB/s pro TiB bietet.
  • Der Standort. Für eine optimale Leistung sollten Sie die Instanz in derselben Zone wie Ihre Client-VMs oder Ihren GKE-Cluster platzieren.
  • Das VPC-Netzwerk für diese Instanz. Dies muss dasselbe Netzwerk sein, das für Ihre VMs oder Cluster verwendet wird.
  • Ob auf diese Instanz über einen GKE-Cluster zugegriffen wird. Da sowohl Lustre als auch GKE standardmäßig Port 988 verwenden, ändert diese Einstellung den Lustre-Port, um Konflikte zu vermeiden.

Leistungsstufen und maximale Speicherkapazitäten

Managed Lustre bietet vier festgelegte Leistungsstufen und eine dynamische Stufe. Die Leistungsstufen wirken sich auf die Mindest- und Höchstgröße der Instanz sowie auf die Schrittgröße zwischen akzeptablen Kapazitätswerten aus. Die Leistungsstufe einer Instanz kann nach dem Erstellen nicht mehr geändert werden.

Weitere Informationen finden Sie unter Leistungsstufen.

Sie können die Speicherkapazität einer Instanz nach dem Erstellen auf den für die Leistungsstufe und Schrittgröße zulässigen Höchstwert erhöhen.

Kapazitätsrechner

Wählen Sie eine Leistungsstufe aus und geben Sie die Zielkapazität ein, um die nächstgelegene gültige Größe zu ermitteln. Gültige Größen werden basierend auf der Mindest- und Schrittgröße der Stufe aufgerundet.

Speicherkapazitätskontingent

Das verfügbare Speicherkapazitätskontingent hängt von vielen Faktoren ab, z. B. vom Standort der Instanz und der angeforderten Leistungsstufe.

Das Standardspeicherkapazitätskontingent gilt pro VPC-Netzwerk (Virtual Private Cloud) und Zone und wird für alle Leistungsstufen gemeinsam verwendet. Wenn Sie Kapazität in einer Stufe verwenden, wird das verfügbare Speicherkapazitätskontingent in den anderen Stufen reduziert.

Weitere Informationen finden Sie unter Kontingente und Beschränkungen.

Erforderliche Berechtigungen

Zum Erstellen einer neuen Managed Lustre-Instanz 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.

Außerdem muss die Managed Lustre API aktiviert sein.

Instanz erstellen

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

gcloud

Verwenden Sie den gcloud lustre instances create Befehl, um eine neue Managed 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. Er muss:

    • nur Kleinbuchstaben, Zahlen und Bindestriche enthalten.
    • mit einem Buchstaben beginnen.
    • zwischen 1 und 63 Zeichen lang sein.
    • mit einer Zahl oder einem Buchstaben enden.
    • im Projekt und am Standort eindeutig sein.

  • --per-unit-storage-throughput ist der maximale Durchsatz der Instanz in MB/s pro TiB. Gültige Werte sind 0, 125, 250, 500 und 1000. Die Auswahl des Durchsatzes wirkt sich auf die Mindest- und Höchstspeicherkapazität der Instanz aus.

    Wenn Sie die dynamische Stufe angeben möchten, legen Sie diesen Wert auf 0 fest und fügen Sie das --dynamic-tier-options-mode=DEFAULT_CACHE Flag ein. Beispiel:

    gcloud lustre instances create my-dynamic-tier-instance \
  --per-unit-storage-throughput=0 \
  --dynamic-tier-options-mode=DEFAULT_CACHE \
  ...

  • --capacity-gib ist die Speicherkapazität der Instanz in Gibibyte (GiB). Die zulässigen Werte hängen von der von Ihnen angegebenen Stufe für den Speicherdurchsatz 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 verwendet, z. B. mount und lfs. Er darf maximal 8 Zeichen lang sein, darf nur Buchstaben und/oder Zahlen enthalten und muss die Groß-/Kleinschreibung beachten.

    Es wird empfohlen, einen Namen zu wählen, der für alle Managed Lustre-Instanzen im VPC eindeutig ist. So können mehrere Instanzen von einem einzelnen GKE-Knoten 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 für eine vollständige Liste.

  • --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 Ihre Google Cloud Projekt-ID.

Die folgenden Flags sind optional:

  • --dynamic-tier-options-mode gibt die dynamische Stufe für diese Instanz an. Legen Sie den Wert dieses Flags auf DEFAULT_CACHE fest und setzen Sie --per-unit-storage-throughput=0, um die dynamische Stufe zu aktivieren.

  • --kms-key-name gibt einen kundenverwalteten Verschlüsselungsschlüssel an, mit dem diese Instanz verschlüsselt werden soll. Weitere Informationen finden Sie unter Vom Kunden verwaltete Verschlüsselungsschlüssel für Managed Lustre.

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

    Wenn Sie eine Verbindung von einer Compute Engine-VM aus 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 zu warten, bis 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 dauert etwa 15 Minuten für eine Instanz mit einer Kapazität von 9.000 GiB und bis zu mehreren Stunden für eine Instanz mit einer Kapazität von 84.016.000 GiB (80,1 PiB). Unter Status der Instanzerstellung abfragen finden Sie eine Anleitung zum Prüfen des Status Ihrer Anfrage.

REST

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

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 Ihre 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 für eine vollständige Liste.

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

    • nur Kleinbuchstaben, Zahlen und Bindestriche enthalten.
    • mit einem Buchstaben beginnen.
    • zwischen 1 und 63 Zeichen lang sein.
    • mit einer Zahl oder einem Buchstaben enden.
    • im Projekt und am Standort eindeutig sein.

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

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

  • perUnitStorageThroughput ist der maximale Durchsatz der Instanz in MB/s pro TiB. Gültige Werte sind 0, 125, 250, 500 und 1000. Die Auswahl des Durchsatzes wirkt sich auf die Mindest- und Höchstspeicherkapazität der Instanz aus.

    Wenn Sie die dynamische Stufe angeben möchten, legen Sie diesen Wert auf 0 fest und fügen Sie das Objekt dynamicTierOptions ein. Beispiel:

    "perUnitStorageThroughput": 0,
"dynamicTierOptions": {
  "mode": "DEFAULT_CACHE"
}

  • capacityGib ist die Speicherkapazität der Instanz in Gibibyte (GiB). Die zulässigen Werte hängen von der von Ihnen angegebenen Stufe für den Speicherdurchsatz 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:

  • dynamicTierOptions aktiviert die dynamische Stufe für diese Instanz. Das Feld mode im Objekt dynamicTierOptions muss auf DEFAULT_CACHE und perUnitStorageThroughput auf 0 gesetzt sein, um die dynamische Stufe zu aktivieren.

  • kmsKey gibt einen kundenverwalteten Verschlüsselungsschlüssel an, mit dem diese Instanz verschlüsselt werden soll. Weitere Informationen finden Sie unter Vom Kunden verwaltete 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 eine Verbindung von einer Compute Engine-VM aus 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 Instance Referenzdokumentation zur Ressource.

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Seite Managed 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 Dateisystemnamen ein. Dieser Name wird von clientseitigen Tools wie lfs verwendet. Er darf maximal 8 Zeichen lang sein, darf nur Buchstaben und/oder Zahlen enthalten und muss die Groß-/Kleinschreibung beachten.

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

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

  7. Geben Sie die Speicherkapazität der Instanz in Gibibyte (GiB) an. Die zulässigen Werte hängen von der von Ihnen 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 „Cloud Key Management Service-Schlüssel“ finden Sie unter Vom Kunden verwaltete Verschlüsselungsschlüssel für Managed Lustre.

  9. Wenn Sie eine Verbindung zu dieser Instanz über einen GKE-Cluster 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 aus 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.

Im Abschnitt Zusammenfassung der Seite wird eine Kostenschätzung basierend auf Ihrer Auswahl angezeigt.

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

Status der Instanzerstellung abfragen

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

gcloud

Um den Status eines Erstellungsvorgangs abzufragen, 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 die Vorgangs-ID aus der Antwort auf die Instanzerstellung, um den Vorgang abzurufen. 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 etwa so aus:

Notieren Sie sich die IP-Adresse im Feld mountPoint und den Namen des Dateisystems. Sie benötigen diese Werte beim Einbinden der Instanz.

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 Instanz von Operation.

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 Instanzerstellung.

Nächste Schritte