Gérer les instances Google Cloud Managed Lustre

Une fois que vous avez créé une instance, Google Cloud Managed Lustre vous permet de lister, d'obtenir, de mettre à jour et de supprimer des instances.

États des instances

Une instance Managed Lustre peut se trouver dans l'un des états suivants :

État Description
CREATING L'instance est en cours de création et n'est pas encore prête à être utilisée.
ACTIVE L'instance est disponible.
REPAIRING L'instance est en cours de réparation.
MAINTENANCE ou UPGRADING L'instance est en cours de maintenance. Pour en savoir plus, consultez Événements et règles de maintenance.
SUSPENDED L'instance est suspendue, généralement en raison d'un problème lié à une clé de chiffrement gérée par le client (CMEK).
DELETING L'instance est en cours de suppression.

Répertorier les instances

Pour lister toutes les instances d'un projet :

Console Google Cloud

  1. Accédez à la page Managed Lustre de la console Google Cloud .

    Accéder à Managed Lustre

    Les instances de votre projet sont listées.

CLI gcloud

Exécutez la commande gcloud lustre instances list :

gcloud lustre instances list --location=LOCATION

Remplacez LOCATION par une zone spécifique pour lister toutes les instances de cet emplacement. Pour afficher les projets dans tous les lieux, saisissez - comme valeur. Exemple :

gcloud lustre instances list --location=-

REST

Pour lister les instances à l'aide de l'API REST, envoyez une requête au point de terminaison suivant :

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Les valeurs suivantes doivent être spécifiées :

  • PROJECT_ID est l'ID de votre projet Google Cloud .

  • ZONE est la zone pour laquelle répertorier toutes les instances. Pour lister les instances de toutes les zones, utilisez - comme valeur.

Pour en savoir plus, consultez la documentation de référence de l'API instances.list.

Obtenir une instance

Pour obtenir les détails d'une instance :

Console Google Cloud

  1. Accédez à la page Managed Lustre de la console Google Cloud .

    Accéder à Managed Lustre

  2. Cliquez sur le nom de l'instance pour afficher les détails d'une instance spécifique.

CLI gcloud

Exécutez la commande gcloud lustre instances describe :

gcloud lustre instances describe INSTANCE_NAME --location=LOCATION

REST

Pour obtenir des informations sur une instance spécifique à l'aide de l'API REST, envoyez une requête au point de terminaison suivant :

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Les valeurs suivantes doivent être spécifiées :

  • PROJECT_ID est l'ID de votre projet Google Cloud .

  • ZONE doit être une zone Google Cloud valide compatible avec Managed Lustre. Pour obtenir la liste complète, consultez Emplacements disponibles.

  • INSTANCE_NAME est le nom de l'instance Managed Lustre à renvoyer.

Pour en savoir plus, consultez la documentation de référence de l'API instances.get.

Mettre à jour une instance

Vous pouvez mettre à jour les propriétés suivantes d'une instance existante :

  • Description
  • Étiquettes
  • Capacité de stockage
  • Stratégie de maintenance

Pour savoir comment augmenter la capacité de stockage d'une instance, consultez Augmenter la capacité d'une instance.

Pour en savoir plus sur la configuration des règles de maintenance, consultez Événements et règles de maintenance.

Pour mettre à jour une instance :

Console Google Cloud

  1. Accédez à la page Managed Lustre de la console Google Cloud .

    Accéder à Managed Lustre

  2. Cliquez sur le nom de l'instance à mettre à jour. La page de présentation de l'instance s'affiche.

  3. Cliquez sur Modifier.

  4. Saisissez la ou les nouvelles valeurs.

  5. Cliquez sur Envoyer.

CLI gcloud

Exécutez la commande gcloud lustre instances update :

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY \
  --description=NEW_DESCRIPTION \
  --maintenance-policy-weekly-windows=dayOfWeek=DAY,startTime={START_TIME}

Où :

  • INSTANCE_NAME est l'instance à mettre à jour.
  • LOCATION est la zone dans laquelle réside l'instance.
  • NEW_CAPACITY correspond à la nouvelle capacité de stockage de cette instance en gibioctets (Gio). La valeur ne peut pas dépasser la capacité maximale autorisée et doit être un multiple de la taille du pas. Pour en savoir plus, consultez Augmenter la capacité d'une instance.

  • NEW_DESCRIPTION est une nouvelle valeur pour le champ de description, qui remplace toute description existante.

  • DAY : jour de la semaine de l'intervalle de maintenance (par exemple, TUESDAY).

  • START_TIME : heure de début UTC de l'intervalle de maintenance au format dictionnaire (par exemple, {hours=1,minutes=0}).

Pour mettre à jour les libellés, consultez les commandes disponibles dans la documentation gcloud lustre instances update.

REST

Pour mettre à jour une instance à l'aide de l'API REST, envoyez une requête PATCH à son point de terminaison spécifique :

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=UPDATE_MASK
Authorization: Bearer [YOUR_ACCESS_TOKEN]

{
  "capacityGib": 72000,
  "description": "updated description",
  "labels": {
    "key1": "value1"
  },
  "maintenancePolicy": {
    "weeklyMaintenanceWindows": [
      {
        "dayOfWeek": "DAY",
        "startTime": {
          "hours": HOURS,
          "minutes": MINUTES
        }
      }
    ]
  }
}

Les valeurs suivantes doivent être spécifiées :

  • PROJECT_ID est l'ID de votre projet Google Cloud .
  • ZONE correspond à la zone Google Cloud de l'instance.
  • INSTANCE_NAME correspond au nom de l'instance Managed Lustre à mettre à jour.
  • UPDATE_MASK est une liste de champs à mettre à jour, séparés par une virgule. Un champ ne sera écrasé que s'il figure dans le masque.

Le corps de la requête doit contenir un ou plusieurs des champs suivants :

  • capacityGiB correspond à la nouvelle capacité de stockage de cette instance en gibioctets (Gio). La valeur ne peut pas dépasser la capacité maximale autorisée et doit être un multiple de la taille du pas. Pour en savoir plus, consultez Augmenter la capacité d'une instance.
  • description est la nouvelle description de cette instance.
  • labels est le nouvel ensemble de libellés pour cette instance. La valeur de labels est un objet JSON contenant une ou plusieurs paires clé/valeur.
  • maintenancePolicy correspond à la stratégie de maintenance de l'instance. Pour en savoir plus, consultez Événements et règles de maintenance.

Pour en savoir plus, consultez la documentation de référence de l'API instances.patch.

Impossible d'ajouter l'opération à la file d'attente

Si une erreur semblable à celle-ci s'affiche lorsque vous tentez de mettre à jour une instance :

ERROR: (gcloud.lustre.instances.update) ABORTED: unable to queue the operation

Cette erreur se produit lorsque vous essayez de démarrer une opération alors qu'une autre opération du même type est déjà en cours sur la même instance. Managed Lustre n'autorise qu'une seule mise à jour active par instance à la fois, et permet de mettre en file d'attente une opération de mise à jour supplémentaire.

Pour résoudre ce problème, attendez la fin de l'opération en cours avant d'en commencer une autre.

Supprimer une instance

Pour supprimer une instance, procédez comme suit :

Console Google Cloud

  1. Accédez à la page Managed Lustre de la console Google Cloud .

    Accéder à Managed Lustre

  2. Sélectionnez le menu à trois points à côté de l'instance à supprimer.

  3. Sélectionnez Supprimer l'instance. Confirmez la suppression en cliquant de nouveau sur Supprimer.

CLI gcloud

Exécutez la commande gcloud lustre instances delete :

gcloud lustre instances delete INSTANCE_NAME --location=LOCATION

Vous êtes invité à confirmer la suppression. Saisissez Y ou appuyez sur Entrée pour continuer.

REST

Pour supprimer une instance à l'aide de l'API REST, envoyez une requête au point de terminaison suivant :

DELETE https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Les valeurs suivantes doivent être spécifiées :

  • PROJECT_ID est l'ID de votre projet Google Cloud .

  • ZONE est la zone Google Cloud dans laquelle se trouve l'instance.

  • INSTANCE_NAME est le nom de l'instance Managed Lustre à supprimer.

Pour en savoir plus, consultez la documentation de référence de l'API instances.delete.

Les requêtes de suppression sont des requêtes de longue durée. Elles renvoient un ID d'opération dont l'état peut être vérifié. Pour en savoir plus, consultez la documentation de référence sur operations.get.