Managed Lustre-Instanz erstellen

Eine Google Cloud Managed Lustre-Instanz ist ein vollständiges Lustre-Dateisystem in der Cloud. Er kann auf einer Compute Engine-VM oder in einem Google Kubernetes Engine-Cluster (GKE) bereitgestellt werden. Sie greifen auf Daten auf der Instanz mit der POSIX-Standardterminologie zu.

Wenn Sie eine Managed Lustre-Instanz erstellen, müssen Sie die folgenden Attribute definieren:

• Der Name der Instanz, der von Google Cloudverwendet wird.
• Der Name des Dateisystems, der von clientseitigen Tools wie lfs verwendet wird.
• 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 Datenzugriffsmustern optimiert, mit einem Gesamtdurchsatz von 25 MB/s pro TiB.
• Der Standort. Um eine optimale Leistung zu erzielen, sollten Sie Ihre 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.

Leistungsstufen und maximale Speicherkapazitäten

Managed Lustre bietet vier Leistungsstufen und eine dynamische Stufe. Leistungsstufen wirken sich auf die minimale und maximale Instanzgröße sowie auf die Schrittgröße zwischen akzeptablen Kapazitätswerten aus. Sie können die Leistungsstufe einer Instanz nach dem Erstellen nicht mehr ändern.

Weitere Informationen finden Sie unter Leistungsstufen.

Sie können die Speicherkapazität einer Instanz nach dem Erstellen bis zum maximal zulässigen Wert für die Leistungsstufe und Schrittgröße 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 finden. Gültige Größen werden basierend auf der Mindest- und Schrittgröße der Stufe aufgerundet.

Kontingente

Ihr Projekt hat Kontingente für Durchsatz und Kapazität, die beim Erstellen einer Instanz verbraucht werden. Wenn Sie in der Zone und im VPC-Netzwerk der Instanz nicht genügend Kontingent für die von Ihnen ausgewählte Instanzgröße und Leistungsstufe haben, schlägt die Erstellungsanfrage fehl. Weitere Informationen finden Sie unter Kontingente und Limits.

Erforderliche Berechtigungen

Zum Erstellen einer neuen Managed Lustre-Instanz benötigen Sie die IAM-Berechtigungen „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 Befehl gcloud lustre instances create, 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. Sie muss:

  • Darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten.
  • Muss mit einem Buchstaben beginnen.
  • Zwischen 1 und 63 Zeichen lang sein.
  • Muss mit einer Ziffer oder einem Buchstaben enden.
  • Sie muss innerhalb des Projekts und des Standorts 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 Wahl des Durchsatzes wirkt sich auf die minimale und maximale Speicherkapazität der Instanz aus.

  Wenn Sie die dynamische Stufe angeben möchten, setzen Sie diesen Wert auf 0 und fügen Sie das Flag --dynamic-tier-options-mode=DEFAULT_CACHE hinzu. 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 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 verwendet, einschließlich mount und lfs. Sie darf maximal 8 Zeichen lang sein, nur Buchstaben und/oder Ziffern enthalten und die Groß-/Kleinschreibung beachten.

  Es wird empfohlen, einen Namen zu wählen, der für alle Managed Lustre-Instanzen in der VPC eindeutig ist. Dadurch 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 Ihre Google Cloud Projekt-ID.

Optionale Flags:

• --dynamic-tier-options-mode gibt die dynamische Stufe für diese Instanz an. Legen Sie den Wert dieses Flags auf DEFAULT_CACHE fest und legen Sie --per-unit-storage-throughput=0 fest, 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 Kundenverwaltete Verschlüsselungsschlüssel für Managed Lustre.

• --maintenance-policy-weekly-windows und --maintenance-policy-exclusion-window definieren Wartungsrichtlinien für diese Instanz. Weitere Informationen finden Sie unter Wartungsereignisse und -richtlinien.

• --async (optional) führt den Befehl asynchron aus. Anstatt auf den Abschluss der Instanzerstellung zu warten, 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 84.016.000 GiB (80,1 PiB) bis zu mehrere Stunden. Eine Anleitung zum Prüfen des Status Ihrer Anfrage finden Sie unter Status der Instanzerstellung abfragen.

REST

Wenn Sie eine Instanz mit der REST API erstellen möchten, 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
}

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.

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

  • Darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten.
  • Muss mit einem Buchstaben beginnen.
  • Zwischen 1 und 63 Zeichen lang sein.
  • Muss mit einer Ziffer oder einem Buchstaben enden.
  • Sie muss innerhalb des Projekts und des Standorts eindeutig sein.

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

  Es wird empfohlen, einen Dateisystemnamen zu wählen, der für alle Managed Lustre-Instanzen in der VPC eindeutig ist. Dadurch können mehrere Instanzen von einem einzelnen GKE-Knoten aus 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 Wahl des Durchsatzes wirkt sich auf die minimale und maximale Speicherkapazität der Instanz aus.

  Wenn Sie die dynamische Stufe angeben möchten, legen Sie hier 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 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:

• 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 Kundenverwaltete Verschlüsselungsschlüssel für Managed Lustre.

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

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 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, nur Buchstaben und/oder Ziffern enthalten und die Groß-/Kleinschreibung beachten.

5. Wählen Sie eine Region und eine Zone aus, in der diese Instanz erstellt werden soll. Sie sollten Ihre 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 Ihrer Instanz in Gibibyte (GiB) an. Die gültigen Werte hängen von der ausgewählten Speicherdurchsatzstufe 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 Schlüsseloption des Cloud Key Management Service finden Sie unter Kundenverwaltete Verschlüsselungsschlüssel für Managed Lustre.

9. Optional: Wenn Sie festlegen möchten, wann Wartungsarbeiten an dieser Instanz durchgeführt werden können, maximieren Sie den Abschnitt Wartungsrichtlinie und konfigurieren Sie ein Wartungsfenster oder ein Ausschlussfenster. Weitere Informationen finden Sie unter Wartungsereignisse und -richtlinien.

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 Ihrer Auswahl an.

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

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

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

Fehlerbehebung

IP-Adressbereich aufgebraucht

Wenn die Instanzerstellung mit einem Fehler aufgrund eines erschöpften IP-Adressbereichs fehlschlägt:

FAILED_PRECONDITION: Invalid resource state for "NETWORK_RANGES_NOT_AVAILABLE": IP address range exhausted

oder:

Private Service Access IP address range exhausted or does not exist.

Folgen Sie der Anleitung unter Zugriff auf private Dienste konfigurieren, um die vorhandene private Verbindung zu ändern und IP-Adressbereiche hinzuzufügen.

Wir empfehlen eine Präfixlänge von mindestens /20 (4.096 Adressen).

Netzwerk wurde nicht per Peering verbunden

Wenn die Instanzerstellung mit einem Netzwerk-Peering-Fehler fehlschlägt:

INVALID_ARGUMENT: the network has not been peered with Google managed services.

Dieser Fehler tritt auf, wenn das in --network angegebene VPC-Netzwerk nicht über den Zugriff auf private Dienste mit von Google verwalteten Diensten verbunden wurde.

Folgen Sie der Anleitung unter VPC erstellen und konfigurieren, um einen IP-Adressbereich zuzuweisen und die VPC-Peering-Verbindung herzustellen.

Nächste Schritte

• Verbindung von einem Compute Engine-Client herstellen
• Verbindung von Google Kubernetes Engine aus herstellen