Kyvernon

Procédure Pour: administrateurs

Datastores

Ajouter un datastore local, NFS ou iSCSI à un hôte dans la console, le monter sur d'autres hôtes, le démonter ou le supprimer.

Un datastore s'ajoute via un hôte. L'agent d'hôte monte ou crée le stockage, et le datastore apparaît dans l'inventaire du datacenter dès qu'un hôte le monte. Vous avez besoin du privilège Host.Config.Storage sur l'hôte. Pour un datastore local, il faut un répertoire absolu de l'hôte qui existe et dispose de suffisamment d'espace libre. Pour un datastore NFS, il faut l'adresse du serveur NFS et le chemin de l'export, tous deux joignables depuis l'hôte, ainsi qu'une licence qui inclut la fonctionnalité remote_storage.nfs. Un datastore sur un LUN iSCSI nécessite d'abord la configuration iSCSI, voir iSCSI.

Dans la console

Pour ajouter un datastore :

  1. Dans l'inventaire, sélectionnez l'hôte puis Ajouter un datastore sous Autres actions. La même action se trouve dans la zone Stockage de l'onglet Configuration de l'hôte. La boîte de dialogue Ajouter un datastore s'ouvre.
  2. Choisissez l'Hôte, l'hôte qui monte le datastore en premier, et le Type : Dossier local, Export NFS ou LUN iSCSI.
  3. Saisissez le Nom du datastore, de 1 à 80 caractères sans barre oblique.
  4. Renseignez ce que demande le type :
    • Dossier local : le Chemin sur l’hôte, un chemin absolu d'un dossier de l'hôte.
    • Export NFS : le Serveur NFS, l'Chemin d’export qui commence par une barre oblique, la Version NFS (NFS 3 ou NFS 4.1) et, pour les images et les fichiers ISO, Monter en lecture seule.
    • LUN iSCSI : le LUN. La liste présente les LUN que l'hôte voit par ses cibles iSCSI et qu'aucun datastore n'utilise encore. Le LUN est formaté en datastore de type bloc, vérifiez donc qu'il ne contient rien dont vous avez besoin.

  5. Sélectionnez Ajouter un datastore.

    Boîte de dialogue d'ajout d'un datastore pour un export NFS (Agrandir)

Pour consulter un datastore, sélectionnez-le dans l'inventaire. Le résumé affiche son Type, sa Capacité, l'espace Utilisé et Libre, son Chemin et les hôtes qui le montent. La zone Hôtes de l'onglet Configuration liste les hôtes.

Résumé d'un datastore avec la capacité et les hôtes (Agrandir)

Pour monter un datastore NFS sur d'autres hôtes, sélectionnez Monter sur des hôtes sous Autres actions, choisissez les hôtes du datacenter qui ne le montent pas encore et confirmez. Un datastore de type bloc est monté par l'hôte qui voit le LUN, après une réanalyse. Démonter fonctionne en sens inverse : choisissez les hôtes qui cessent de monter le datastore. Les données restent en place. Un datastore qu'utilise une machine virtuelle en cours d'exécution ne peut pas être démonté de cet hôte, et la boîte de dialogue indique le nombre de machines qui l'en empêchent. Lorsque certains hôtes échouent, la boîte de dialogue indique combien.

Pour supprimer un datastore :

  1. Sélectionnez Supprimer le datastore sous Autres actions du datastore.

  2. Saisissez le nom du datastore et confirmez. Le datastore est démonté de tous ses hôtes et quitte l'inventaire. Les fichiers du stockage ne sont pas supprimés.

    Boîte de dialogue de retrait d'un datastore qui demande de saisir le nom (Agrandir)

Un datastore qu'utilise une machine virtuelle ne peut pas être supprimé.

Résultat

Le datastore apparaît sous le datacenter, accessible depuis l'hôte, sa taille et son espace libre sont ceux qu'un hôte a mesurés, il y a au plus cinq minutes. Chaque modification est une tâche du panneau des tâches.

Automatisation

Avec la CLI

Ajoutez un datastore local. <host> est l'identifiant de l'hôte, par exemple host-1 :

Shell
kyvernon host create-datastore <host> --type local --name images --path /srv/kyvernon/images

Ajoutez un datastore NFS :

Shell
kyvernon host create-datastore <host> --type nfs --name shared-01 \
  --remote-host 192.0.2.20 --remote-path /export/vm --nfs-type NFS41

--nfs-type vaut NFS (version 3) ou NFS41. --access-mode vaut readWrite ou readOnly, et --security-type désigne la variante de sécurité NFS, sys par défaut. Un datastore sur un LUN iSCSI utilise --type vmfs, voir iSCSI. Supprimez un datastore de l'hôte et lisez les datastores :

Shell
kyvernon host remove-datastore <host> <datastore>
kyvernon inventory datastores
kyvernon inventory datastore <datastore>

La taille et l'espace libre sont mesurés par un hôte connecté qui monte le datastore. Le contrôleur leader mesure chaque datastore toutes les cinq minutes ; le placement et les contrôles d'espace des nouveaux disques utilisent ces valeurs. Pour mesurer un datastore tout de suite, par exemple après l'ajout de fichiers sur le stockage en dehors de Kyvernon :

Shell
kyvernon datastore refresh <datastore>

La réponse contient capacityBytes, freeBytes, l'hôte qui a mesuré (measuredOn) et refreshedAt. Sans hôte connecté dont l'agent peut mesurer le datastore, la commande échoue avec error.datastore_no_host.

Avec l'API

POST /v1/datastores/{id}/refresh mesure le datastore sur un hôte et enregistre le résultat (System.Read sur le datastore).

POST /v1/hosts/{id}/datastores prend type (local, nfs ou vmfs), name et les champs du type : path pour un datastore local ; remoteHost, remotePath, nfsType, accessMode et securityType pour NFS ; disk pour iSCSI. Il répond 201 avec le nouveau datastore. DELETE /v1/hosts/{id}/datastores/{dsId} le supprime. GET /v1/inventory/datastores liste les datastores et GET /v1/inventory/datastores/{id} en lit un, avec datastore_type, capacity_bytes, free_bytes, accessible et hosts.

Version 0.1. Dernière modification : 2026-11-14