Mit der Self-Service-Wartung können Sie Wartungsupgrades für Ihre Managed Lustre-Instanzen bei Bedarf anwenden.
Wenn eine neue Softwareversion von Managed Lustre veröffentlicht wird, ist sie sofort für die Self-Service-Wartung verfügbar. Dies ist in der Regel mehrere Wochen, bevor die automatisierte Wartung Ihre Instanz erreicht.
Sie können die Self-Service-Wartung jederzeit durchführen, sobald eine Version verfügbar ist. Wenn Ihre Instanz eine Wartungsrichtlinie hat, können Sie die Wartung bis zu 1 Stunde vor einem geplanten Wartungsfenster selbst durchführen.
Eine Übersicht über die Auswirkungen und Richtlinien der Wartung finden Sie unter Wartungsübersicht.
Verfügbare Wartungsversionen prüfen
Managed Lustre-Instanzen verfolgen Wartungsreleases mithilfe der folgenden Versionsfelder:
effectiveVersion: Nur Ausgabe. Die Software-Release-Version, die auf Ihrer Instanz ausgeführt wird. Beispiel:Lustre_20260516.00_p00.availableVersion: Nur Ausgabe. Eine qualifizierte, neuere Software-Release-Version, auf die Ihre Instanz aktualisiert werden kann. Wenn dieses Feld leer ist, wird auf Ihrer Instanz bereits die neueste verfügbare Version ausgeführt.targetVersion: Nur Eingabe. Der Parameter, der in einer Aktualisierungsanfrage angegeben wird, um ein Upgrade auf eine Kandidatenversion oder auflatestzu initiieren.
So prüfen Sie die aktuelle Version Ihrer Instanz und ob ein Upgrade verfügbar ist:
Google Cloud Console
Rufen Sie in der Google Cloud Console die Seite Managed Lustre auf:
Suchen Sie in der Instanzliste nach Ihrer Instanz. Wenn eine neuere Wartungsversion verfügbar ist, wird neben dem Status
ACTIVEdas Badge Update verfügbar angezeigt.Klicken Sie auf den Instanznamen, um die Seite Instanzdetails zu öffnen und den verfügbaren Versionsstring aufzurufen.
gcloud-CLI
Führen Sie den Befehl gcloud lustre instances describe mit einem Formatfilter aus:
gcloud lustre instances describe INSTANCE_ID \ --location=LOCATION \ --format="yaml(effectiveVersion, availableVersion, state)"
Ersetzen Sie Folgendes:
- INSTANCE_ID: Die ID Ihrer Managed Lustre-Instanz.
- LOCATION: Zone, in der sich Ihre Instanz befindet.
Wenn eine neuere Version verfügbar ist, sieht die Ausgabe in etwa so aus:
availableVersion: Lustre_20260716.01_p00
effectiveVersion: Lustre_20260516.00_p00
state: ACTIVE
Wenn availableVersion leer ist, wird auf Ihrer Instanz bereits die neueste verfügbare Version ausgeführt.
REST
Wenn Sie die Versionsdetails für eine Instanz prüfen möchten, senden Sie eine GET-Anfrage an den Instanzendpunkt:
GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID
Authorization: Bearer ACCESS_TOKEN
Wobei:
- PROJECT_ID ist Ihre Google Cloud Projekt-ID.
- LOCATION ist die Zone, in der sich die Instanz befindet.
- INSTANCE_ID ist die ID der Managed Lustre-Instanz.
Wenn eine neuere Version verfügbar ist, enthält die Antwort effectiveVersion und availableVersion:
{
"name": "projects/my-project/locations/us-central1-a/instances/my-instance",
"state": "ACTIVE",
"effectiveVersion": "Lustre_20260516.00_p00",
"availableVersion": "Lustre_20260716.01_p00"
}
Wenn availableVersion weggelassen wird oder leer ist, wird auf Ihrer Instanz bereits die neueste verfügbare Version ausgeführt.
Weitere Informationen finden Sie in der API-Referenz zu instances.get.
Selfservice-Upgrade durchführen
So aktualisieren Sie Ihre Instanz auf eine verfügbare Softwareversion:
gcloud-CLI
Führen Sie den Befehl gcloud lustre instances update mit dem Flag --target-version aus:
gcloud lustre instances update INSTANCE_ID \ --location=LOCATION \ --target-version=latest
Ersetzen Sie Folgendes:
- INSTANCE_ID: Die ID Ihrer Managed Lustre-Instanz.
- LOCATION: Zone, in der sich Ihre Instanz befindet.
Wenn Sie ein Upgrade auf eine bestimmte qualifizierte Release-Version anstelle von latest durchführen möchten, übergeben Sie den Versionsstring:
gcloud lustre instances update INSTANCE_ID \ --location=LOCATION \ --target-version=TARGET_VERSION
Ersetzen Sie TARGET_VERSION durch den Versionsstring aus availableVersion. Beispiel: Lustre_20260716.01_p00
REST
Wenn Sie eine Instanz mit der REST API aktualisieren möchten, senden Sie eine PATCH-Anfrage an den Instanzendpunkt und geben Sie targetVersion im Abfrageparameter updateMask an:
PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=targetVersion
Authorization: Bearer ACCESS_TOKEN
{
"targetVersion": "latest"
}
Wobei:
- PROJECT_ID ist Ihre Google Cloud Projekt-ID.
- LOCATION ist die Zone, in der sich die Instanz befindet.
- INSTANCE_ID ist die ID der Managed Lustre-Instanz.
Wenn Sie ein Upgrade auf eine bestimmte qualifizierte Release-Version anstelle von latest durchführen möchten, geben Sie den Versionsstring im Anfragetext an, z. B. "targetVersion": "Lustre_20260716.01_p00".
Weitere Informationen finden Sie in der API-Referenz zu instances.patch.
Wartungsfortschritt verfolgen
Das Upgrade wird als asynchroner Vorgang mit langer Ausführungszeit ausgeführt. Bei der Self-Service-Wartung werden keine automatischen E‑Mail-Benachrichtigungen ausgelöst.
So verfolgen Sie den Fortschritt in Echtzeit:
gcloud-CLI
Fragen Sie den Vorgangsstatus mit dem Befehl gcloud lustre operations describe ab:
gcloud lustre operations describe OPERATION_ID \ --location=LOCATION
Ersetzen Sie Folgendes:
- OPERATION_ID: Die Vorgangs-ID, die vom Aktualisierungsbefehl zurückgegeben wird.
- LOCATION: Zone, in der sich Ihre Instanz befindet.
Während des Upgrades wird der Instanzstatus UPGRADING angezeigt. Nach Abschluss des Upgrades wird er wieder auf ACTIVE gesetzt.
REST
Senden Sie eine GET-Anfrage an den operations.get-Endpunkt:
GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID
Authorization: Bearer ACCESS_TOKEN
Wobei:
- PROJECT_ID ist Ihre Google Cloud Projekt-ID.
- LOCATION ist die Zone, in der sich die Instanz befindet.
- OPERATION_ID ist die Vorgangs-ID, die von der Aktualisierungsanfrage zurückgegeben wird.
Weitere Informationen finden Sie in der API-Referenz zu operations.get.
Nach erfolgreicher Umstellung:
- Die Instanz kehrt in den Status
ACTIVEzurück. effectiveVersionspiegelt den neu angewendeten Versionsstring wider.availableVersionwird gelöscht und in API-Antworten weggelassen.
Interaktion mit geplanter Wartung
Wenn für Ihre Instanz eine geplante Wartung ansteht, wird diese durch ein erfolgreiches Self-Service-Upgrade automatisch abgebrochen. Wenn Sie Wartungsbenachrichtigungen abonniert haben, erhalten Sie eine automatische E-Mail-Benachrichtigung Wartung abgebrochen.
Wenn ein Self-Service-Upgrade fehlschlägt, wird das ausstehende geplante Wartungsfenster nicht abgebrochen. Die Instanz kehrt in der aktuellen Version in den Status ACTIVE zurück und das geplante Wartungsfenster wird beibehalten.
Sie können ein Self-Service-Upgrade nicht innerhalb einer Stunde vor einem geplanten Wartungsfenster auslösen. Wenn Sie während dieses Zeitraums ein Upgrade initiieren, wird der Fehler 409 CONFLICT zurückgegeben, um Überschneidungen mit der anstehenden geplanten Wartung zu vermeiden.
Fehlermeldungen
Mögliche Fehler bei der Self-Service-Wartung:
Instance is already running version "<CURRENT>": Tritt auf, wenn Sie versuchen, ein Upgrade auf die Softwareversion durchzuführen, die bereits auf der Instanz ausgeführt wird.Downgrading to a lower version is not supported.: Tritt auf, wenn Sie versuchen, ein Downgrade auf eine frühere Softwareversion durchzuführen.Version "<TARGET>" is not a valid update version.: Tritt auf, wenn die angegebene Version nicht mit demavailableVersion-String oder derlatestder Instanz übereinstimmt.Instance must be in ACTIVE state to update version: Tritt auf, wenn ein Upgrade initiiert wird, während sich die Instanz nicht im StatusACTIVEbefindet.Cannot trigger self-service update within 1 hour of a scheduled maintenance window: Tritt auf, wenn ein Selfservice-Upgrade weniger als 1 Stunde vor einem anstehenden geplanten Wartungsfenster initiiert wird.