La maintenance en libre-service vous permet d'appliquer des mises à niveau de maintenance à vos instances Managed Lustre à la demande.
Lorsque Managed Lustre publie une nouvelle version logicielle, elle est immédiatement disponible pour la maintenance en libre-service. Cela se produit généralement plusieurs semaines avant que la maintenance automatisée n'atteigne votre instance.
Vous pouvez effectuer la maintenance en libre-service à tout moment dès qu'une version est disponible. Si votre instance est associée à une règle de maintenance, vous pouvez effectuer une maintenance en libre-service jusqu'à une heure avant un intervalle de maintenance planifié.
Pour en savoir plus sur l'impact et les règles de maintenance, consultez Présentation de la maintenance.
Vérifier les versions de maintenance disponibles
Les instances Managed Lustre suivent les versions de maintenance à l'aide des champs de version suivants :
effectiveVersion: résultat uniquement. Version logicielle exécutée sur votre instance. Exemple :Lustre_20260516.00_p00availableVersion: résultat uniquement. Une version logicielle plus récente et qualifiée vers laquelle votre instance peut être mise à niveau. Si ce champ est vide, votre instance exécute déjà la dernière version disponible.targetVersion: entrée uniquement. Paramètre spécifié dans une requête de mise à jour pour lancer une mise à niveau vers une version candidate ou verslatest.
Pour vérifier la version actuelle de votre instance et voir si une mise à niveau est disponible :
Console Google Cloud
Dans la console Google Cloud , accédez à la page Lustre géré :
Dans la liste des instances, recherchez votre instance. Si une version de maintenance plus récente est disponible, un badge Mise à jour disponible s'affiche à côté de l'état
ACTIVE.Cliquez sur le nom de l'instance pour ouvrir la page Détails de l'instance et afficher la chaîne de version disponible.
gcloud CLI
Exécutez la commande gcloud lustre instances describe avec un filtre de format :
gcloud lustre instances describe INSTANCE_ID \ --location=LOCATION \ --format="yaml(effectiveVersion, availableVersion, state)"
Remplacez les éléments suivants :
- INSTANCE_ID : ID de votre instance Managed Lustre.
- LOCATION : zone où se trouve votre instance.
Si une version plus récente est disponible, le résultat se présente comme suit :
availableVersion: Lustre_20260716.01_p00
effectiveVersion: Lustre_20260516.00_p00
state: ACTIVE
Si availableVersion est vide, votre instance exécute déjà la dernière version disponible.
REST
Pour vérifier les détails de la version d'une instance, envoyez une requête GET au point de terminaison de l'instance :
GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID
Authorization: Bearer ACCESS_TOKEN
Où :
- PROJECT_ID est l'ID de votre projet Google Cloud .
- LOCATION est la zone dans laquelle se trouve l'instance.
- INSTANCE_ID est l'ID de l'instance Managed Lustre.
Si une version plus récente est disponible, la réponse contient effectiveVersion et availableVersion :
{
"name": "projects/my-project/locations/us-central1-a/instances/my-instance",
"state": "ACTIVE",
"effectiveVersion": "Lustre_20260516.00_p00",
"availableVersion": "Lustre_20260716.01_p00"
}
Si availableVersion est omis ou vide, votre instance exécute déjà la dernière version disponible.
Pour en savoir plus, consultez la documentation de référence de l'API instances.get.
Effectuer une mise à niveau en libre-service
Pour mettre à niveau votre instance vers une version logicielle disponible :
gcloud CLI
Exécutez la commande gcloud lustre instances update avec le flag --target-version :
gcloud lustre instances update INSTANCE_ID \ --location=LOCATION \ --target-version=latest
Remplacez les éléments suivants :
- INSTANCE_ID : ID de votre instance Managed Lustre.
- LOCATION : zone où se trouve votre instance.
Pour effectuer une mise à niveau vers une version qualifiée spécifique au lieu de latest, transmettez la chaîne de version :
gcloud lustre instances update INSTANCE_ID \ --location=LOCATION \ --target-version=TARGET_VERSION
Remplacez TARGET_VERSION par la chaîne de version de availableVersion. Par exemple, Lustre_20260716.01_p00.
REST
Pour mettre à niveau une instance à l'aide de l'API REST, envoyez une requête PATCH au point de terminaison de l'instance, en spécifiant targetVersion dans le paramètre de requête updateMask :
PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=targetVersion
Authorization: Bearer ACCESS_TOKEN
{
"targetVersion": "latest"
}
Où :
- PROJECT_ID est l'ID de votre projet Google Cloud .
- LOCATION est la zone dans laquelle se trouve l'instance.
- INSTANCE_ID est l'ID de l'instance Managed Lustre.
Pour passer à une version qualifiée spécifique au lieu de latest, spécifiez la chaîne de version dans le corps de la requête, par exemple "targetVersion": "Lustre_20260716.01_p00".
Pour en savoir plus, consultez la documentation de référence de l'API instances.patch.
Suivre la progression de la maintenance
La mise à niveau s'exécute en tant qu'opération de longue durée asynchrone. La maintenance en libre-service ne déclenche pas l'envoi d'e-mails de notification automatiques.
Pour suivre la progression en temps réel :
gcloud CLI
Interrogez l'état de l'opération à l'aide de la commande gcloud lustre operations describe :
gcloud lustre operations describe OPERATION_ID \ --location=LOCATION
Remplacez les éléments suivants :
- OPERATION_ID : ID d'opération renvoyé par la commande de mise à jour.
- LOCATION : zone où se trouve votre instance.
L'état de l'instance affiche UPGRADING pendant la mise à niveau et revient à ACTIVE une fois l'opération terminée.
REST
Envoyez une requête GET au point de terminaison operations.get :
GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID
Authorization: Bearer ACCESS_TOKEN
Où :
- PROJECT_ID est l'ID de votre projet Google Cloud .
- LOCATION est la zone dans laquelle se trouve l'instance.
- OPERATION_ID est l'ID d'opération renvoyé par la requête de mise à jour.
Pour en savoir plus, consultez la documentation de référence de l'API operations.get.
Une fois la migration terminée :
- L'instance revient à l'état
ACTIVE. effectiveVersionreflète la chaîne de version nouvellement appliquée.availableVersionest effacé et omis des réponses de l'API.
Interaction avec la maintenance planifiée
Si une maintenance est planifiée pour votre instance, l'exécution d'une mise à niveau en libre-service annule automatiquement cette maintenance planifiée. Si vous êtes abonné aux notifications de maintenance, vous recevez une notification par e-mail automatisée Maintenance annulée.
Si une mise à niveau en libre-service échoue, l'intervalle de maintenance planifié en attente n'est pas annulé. L'instance revient à l'état ACTIVE sur sa version actuelle, et l'intervalle de maintenance planifié est conservé.
Vous ne pouvez pas déclencher une mise à niveau en libre-service dans l'heure qui précède un intervalle de maintenance planifié. Si vous tentez de lancer une mise à niveau pendant cette période, une erreur 409 CONFLICT est renvoyée pour éviter tout chevauchement avec la maintenance planifiée à venir.
Messages d'erreur
Voici les erreurs de maintenance en libre-service possibles :
Instance is already running version "<CURRENT>": se produit si vous tentez de passer à la version logicielle déjà exécutée sur l'instance.Downgrading to a lower version is not supported.: se produit si vous tentez de passer à une version logicielle antérieure.Version "<TARGET>" is not a valid update version.: se produit si la version spécifiée ne correspond pas à la chaîneavailableVersionou à la valeurlatestde l'instance.Instance must be in ACTIVE state to update version: se produit si une mise à niveau est lancée alors que l'instance n'est pas à l'étatACTIVE.Cannot trigger self-service update within 1 hour of a scheduled maintenance window: se produit si une mise à niveau en libre-service est lancée moins d'une heure avant un intervalle de maintenance planifié.