Bibliothèques de contenu

Créer une bibliothèque de contenu sur un datastore dans la console, enregistrer ou téléverser des éléments ISO et OVF, et les utiliser.

Une bibliothèque de contenu est un catalogue de fichiers ISO et OVF. Une bibliothèque repose sur un datastore et un élément pointe vers un fichier qui s'y trouve. Vous pouvez enregistrer un fichier déjà présent ou téléverser un fichier dans un nouvel élément. Les éléments de type ISO peuvent être choisis lorsque vous attachez une image ISO à une machine virtuelle, voir Modifier le matériel. Vous avez besoin d'un datastore disposant d'espace libre.

Dans la console

Sur la page d'accueil, sélectionnez Bibliothèques de contenu.

(Agrandir)
Fermer la vue agrandie
Sous Nouvelle bibliothèque, saisissez un Nom, choisissez le Datastore et sélectionnez Créer la bibliothèque. La bibliothèque apparaît dans la liste Bibliothèques.
Sélectionnez la bibliothèque dans la liste. La section Éléments de la bibliothèque affiche ses éléments.
Pour ajouter un élément, saisissez un Nom et choisissez le Type, ISO ou OVF/OVA.
Saisissez le Chemin du datastore d'un fichier déjà présent sur le datastore, ou choisissez un fichier sous Fichier à téléverser. Un téléversement crée un élément vide et envoie le fichier vers le datastore de la bibliothèque.
Sélectionnez Ajouter un élément, ou Téléverser si vous avez choisi un fichier.

Supprimer supprime une bibliothèque et Supprimer supprime un élément. Les fichiers du datastore sont décrits dans Fichiers d'un datastore.

Résultat

L'élément est listé avec son type et le chemin de son fichier sur le datastore. Les éléments ISO sont proposés dans la boîte de dialogue de modification du matériel d'une machine, sous Depuis la bibliothèque de contenu.

Automatisation

Avec la CLI

Shell

kyvernon content libraries create images --datastore <datastore> --description "ISO images"
kyvernon content items create ubuntu-26.04 --library <library> --type iso \
  --file-path iso/ubuntu-26.04.iso
kyvernon content items list --library <library>

Pour téléverser un fichier dans un élément vide, ouvrez une session de mise à jour, ajoutez le fichier, téléversez-le et terminez la session :

Shell

kyvernon content items create tools --library <library> --type iso
kyvernon content sessions create <item>
kyvernon content sessions add-file <session> tools.iso --size 734003200
kyvernon content sessions upload <session> tools.iso ./tools.iso
kyvernon content sessions complete <session>

sessions cancel abandonne une session et sessions files liste ses fichiers. Autres commandes : libraries list, get et delete ; items get et delete ; sessions list et get. Les types d'un élément sont iso, ovf et vm-template.

Avec l'API

Opération	Demande
Bibliothèques	`GET`, `POST /v1/content/libraries`; `GET`, `DELETE /v1/content/libraries/{id}`
Éléments	`GET`, `POST /v1/content/library-items`; `GET`, `DELETE /v1/content/library-items/{id}`
Sessions de mise à jour	`GET`, `POST /v1/content/update-sessions`; `GET`, `DELETE /v1/content/update-sessions/{id}`
Ajouter un fichier à une session	`POST /v1/content/update-sessions/{id}/files`
Envoyer le fichier	`PUT /v1/content/update-sessions/{id}/files/{name}/content`
Terminer	`POST /v1/content/update-sessions/{id}/complete`

Une bibliothèque se crée avec name, datastoreId et un description facultatif. Un élément prend libraryId, name, type et soit filePath, soit rien pour un téléversement. Les bibliothèques sont locales au contrôleur ; leur type est toujours LOCAL.