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.

Lorsque vous mettez à jour des instances Lustre gérées, seuls la description et les libellés peuvent être modifiés.

Répertorier les instances

Pour lister toutes les instances d'un projet :

Console Google Cloud

  1. Accédez à la page Managed Lustre dans 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 dans 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
  • labels
  • capacité de stockage

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

Pour mettre à jour une instance :

Console Google Cloud

  1. Accédez à la page Managed Lustre dans 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.

Google Cloud CLI

Exécutez la commande gcloud lustre instances update :

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY \
  --description=NEW_DESCRIPTION

Où :

  • INSTANCE_NAME est l'instance à mettre à jour.
  • LOCATION est la zone dans laquelle se trouve l'instance.
  • NEW_CAPACITY est 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.

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"
  }
}

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

  • PROJECT_ID est l'ID de votre projet Google Cloud .
  • ZONE est 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 est 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.

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

Supprimer une instance

Pour supprimer une instance, procédez comme suit :

Console Google Cloud

  1. Accédez à la page Managed Lustre dans 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 qui peut être utilisé pour interroger l'état de l'opération. Pour en savoir plus, consultez la documentation de référence sur operations.get.