> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/fr/administration-systeme/nvidia-vgpu-configuration.md). # Configuration NVIDIA vGPU VergeOS permet une utilisation transparente de la plateforme vGPU de NVIDIA pour attribuer des périphériques GPU virtualisés entre les locataires et les VM. {% hint style="info" %} **Nouveautés de la version 26.1.3** VergeOS inclut désormais une prise en charge NVIDIA étendue, offrant une plus grande flexibilité pour répartir les périphériques GPU entre les charges de travail * **Profils vGPU hétérogènes** - utilisez plusieurs profils vGPU traditionnels au sein d’un même périphérique. Nécessite la version 17.2 ou ultérieure du pilote NVIDIA ainsi que la prise en charge du périphérique. * **Profils MIG** - un seul GPU peut être partitionné en jusqu’à sept instances isolées matériellement, pour un service garanti à plusieurs charges de travail simultanées. Nécessite la prise en charge du périphérique ; le dernier pilote NVIDIA pour centre de données est recommandé. {% endhint %} {% hint style="success" %} **La fonctionnalité NVIDIA vGPU nécessite une licence commerciale NVIDIA vGPU. Cela s’applique à la fois aux configurations vGPU traditionnelles et aux configurations vGPU adossées à MIG.** {% endhint %} *** ## Flux de travail global Voici les étapes de haut niveau nécessaires à la configuration NVIDIA vGPU dans VergeOS : * **Télécharger le pilote** Téléchargez le pilote NVIDIA fourni dans l’environnement VergeOS. * **Créer un groupe de ressources** Générez un groupe de ressources à partir du ou des périphériques GPU physiques sélectionnés, en choisissant un profil MIG ou vGPU traditionnel. Cela crée un pool de périphériques vGPU attribuables. Plusieurs groupes de ressources peuvent être créés par périphérique physique afin de proposer un mélange de différents types de vGPU pour différents cas d’utilisation. * **Charger les pilotes** Chaque nœud doit être placé en mode maintenance pour charger le pilote NVIDIA. (Un redémarrage du nœud peut être nécessaire si l’IOMMU n’a pas encore été activé et/ou lors du premier chargement du pilote.) * **Ajouter des périphériques aux VM individuelles** Ajoutez un périphérique à une VM en sélectionnant le groupe de ressources créé. Cela permet à la VM de puiser dans le pool de périphériques GPU virtuels disponibles au sein du groupe de ressources. * **Partager avec les locataires** Partagez des périphériques avec des locataires individuels, en leur permettant d’ajouter les périphériques vGPU à leurs propres VM. *** Les sections suivantes fournissent des instructions étape par étape pour activer et attribuer des ressources NVIDIA vGPU dans VergeOS. ## Prérequis Avant de commencer, assurez-vous que les éléments suivants sont en place : * **GPU compatible NVIDIA vGPU** installé dans un ou plusieurs nœuds VergeOS (voir [GPU pris en charge par NVIDIA](https://docs.nvidia.com/vgpu/gpus-supported-by-vgpu.html) ) * **IOMMU / VT-d / SR-IOV activés** dans le BIOS de l’hôte — si ce n’est pas encore activé, prévoyez un redémarrage du nœud au cours de ce processus (suivez les [**Mode maintenance**](/run-the-platform/fr/operations/maintenance-mode.md) procédures appropriées). * **Licence logicielle NVIDIA vGPU** — accès au [portail de licences NVIDIA](https://nvidia.com/en-us/data-center/resources/vgpu-evaluation) pour obtenir les pilotes * **Accès administrateur VergeOS** au Gestionnaire de ressources et à la configuration du nœud * Familiarité avec [**les risques et précautions liés au passthrough PCI**](/run-the-platform/fr/administration-systeme/device-pass-overview.md#pci-passthrough-risksprecautions) ## Installation/Configuration de l’hôte 1. Obtenez le pilote Linux-KVM NVIDIA approprié pour votre matériel GPU. Les pilotes NVIDIA vGPU peuvent être téléchargés depuis votre portail de licences NVIDIA ou en vous inscrivant à une évaluation gratuite NVIDIA : [**https://nvidia.com/en-us/data-center/resources/vgpu-evaluation**](https://nvidia.com/en-us/data-center/resources/vgpu-evaluation).

VergeOS prend en charge les pilotes NVIDIA en version bundle. Pour une liste des pilotes NVIDIA actuellement pris en charge, accédez à Gestionnaire de ressources > Groupes > Nouveau. Définissez Type=NVIDIA vGPU et cliquez sur le bouton pour afficher les pilotes tiers compatibles. En général, vous voudrez utiliser le pilote le plus récent de cette liste compatible avec votre matériel NVIDIA.

2. Téléchargez le pilote bundle NVIDIA sur le vSAN VergeOS. Voir [**Téléchargement vers le vSAN (Fichiers)**](/run-the-platform/fr/stockage/uploading-files-to-vsan.md) pour les instructions de téléchargement.

Les instructions suivantes configurent le ou les périphériques vGPU sélectionnés pour le passthrough de fonctions virtuelles en créant automatiquement les règles de ressources nécessaires pour chaque périphérique sélectionné et en attachant le ou les périphériques à un groupe de ressources. Cela crée un pool de périphériques de fonction virtuelle pouvant être attribués aux locataires et aux machines virtuelles. Pour plus d’informations sur les groupes de ressources et les règles de ressources, voir : Passage de périphérique - Présentation

3. Accédez au **Tableau de bord du gestionnaire de ressources** (**Infrastructure** > **Ressources** depuis le menu supérieur) **-OU-** Accédez à un **nœud spécifique** où le matériel NVIDIA est installé (**Infrastructure** > **Nœuds**). 4. Cliquez sur le **PÉRIPHÉRIQUES PCI** carte sur le tableau de bord. 5. **Sélectionnez le ou les périphériques physiques NVIDIA souhaités.** Pour localiser facilement la ou les cartes NVIDIA souhaitées, utilisez la barre de recherche pour filtrer par nom ("nvidia") ou Type : contrôleur d’affichage. 6. Cliquez sur **Créer une ressource** dans le menu de gauche. 7. **Sélectionnez un groupe de ressources vGPU existant** **-OU-** **sélectionnez --Nouveau groupe--** pour attacher le périphérique. *** **Champs du groupe de ressources**: * **Nom**: étiquette utilisée pour identifier le groupe de ressources (c.-à-d. le pool de périphériques) ; utilisez un nom descriptif afin que les utilisateurs puissent facilement identifier le type de périphériques virtuels qui seront disponibles dans ce groupe. * **Type**: doit être défini sur ***NVIDIA vGPU*** (Ce champ est défini automatiquement si le groupe de ressources a été créé à partir d’un périphérique NVIDIA.) * **Description**: champ facultatif permettant de fournir davantage de texte administratif sur le groupe de ressources * **Classe**: sélectionnez ***vGPU***. Ce champ est uniquement utilisé pour appliquer une icône de tableau de bord associée au groupe de ressources, et n’affecte pas la fonctionnalité * **Profil NVIDIA vGPU**: définissez ce champ sur le type de vGPU que vous souhaitez voir créer par ce groupe de ressources ```
``` ``` **Si la liste des profils est vide, ignorez ce champ pour le moment et cliquez sur **Submit** pour enregistrer le groupe de ressources. Suivez les instructions ci-dessous pour [recharger les pilotes](#reload-drivers) sur au moins un nœud, puis revenez au groupe de ressources (**Infrastructure** > **Ressources** > **Groupes** > double-cliquez sur le groupe > **Modifier**) pour sélectionner le profil.**
``` * Le **Pilote** la liste déroulante contiendra tous les pilotes NVIDIA vGPU (.zip) trouvés dans la section *Fichiers* Le pilote approprié devra être téléchargé sur le vSAN avant de pouvoir être sélectionné (étapes 1-2 ci-dessus). Sélectionnez le pilote approprié. * Cliquez sur **Soumettre** pour enregistrer le groupe de ressources. Après la sélection du groupe de ressources ou la création d’un nouveau, un **Succès** message devrait apparaître indiquant que des règles de ressources ont été créées pour le ou les périphérique(s). * Si un pilote n’a pas déjà été chargé ou si l’IOMMU n’est pas encore activé, **redémarrez le ou les nœuds associés** dans [**Mode maintenance**](/run-the-platform/fr/operations/maintenance-mode.md) avant de continuer. * Après le redémarrage du ou des nœuds, accédez au groupe de ressources NVIDIA vGPU qui vient d’être créé (Infrastructure > Ressources > Groupes > double-cliquez sur le groupe). * Cliquez sur **Modifier** dans le menu de gauche. * Sélectionnez **Profil NVIDIA vGPU**: Traditionnel ou MIG (les onglets ci-dessous fournissent les instructions associées) : {% tabs %} {% tab title="Configuration vGPU traditionnelle" %} * **Profil NVIDIA vGPU**: sélectionnez le profil traditionnel souhaité. * **Instances vGPU totales**: nombre d’instances virtuelles à créer avec le profil donné. * **Stratégie de planification**, **Fréquence**, **Facteur de moyenne**, **Durée du créneau temporel (ms)**, **Round robin strict**: paramètres spécifiques à NVIDIA — consultez la documentation NVIDIA pour des réglages précis des performances. * **Pilote**: prérempli à partir de l’étape précédente. {% hint style="info" %} **Configuration de profil flexible** À partir de la version 26.1.3, VergeOS prend en charge les profils vGPU hétérogènes. Cela offre une plus grande flexibilité, en permettant à un périphérique physique d’héberger simultanément un mélange de différents types et tailles de profils (nécessite la version 17.2 ou ultérieure du pilote NVIDIA et la prise en charge du périphérique). * NVIDIA n’autorise que le mélange de profils vGPU partageant la même architecture et appartenant au même groupe de compatibilité — consultez la documentation NVIDIA pour plus d’informations. * Les profils combinés doivent tenir dans le framebuffer total du GPU (VRAM disponible). * Les profils MIG et traditionnels **ne peuvent pas** être mélangés sur le même périphérique physique. * Les requêtes NVIDIA SMI peuvent fournir des informations sur les profils vGPU compatibles avec ceux déjà configurés pour un périphérique. Voir [Conseils de dépannage](#troubleshooting-tips) pour plus d’informations. {% endhint %} {% hint style="info" %} **Exemple : utilisation de profils hétérogènes** * **Périphérique physique**: Le NVIDIA L40S fournit **48 Go de mémoire framebuffer** * **Plusieurs types de profils** sont implémentés pour le périphérique : * **L40S-24C :** Une instance vGPU optimisée pour le calcul utilisant 24 Go * **L40S-12Q :** Une instance vGPU optimisée pour les graphismes utilisant 12 Go * **L40S-4C :** Trois instances vGPU de calcul légères utilisant chacune 4 Go (12 Go au total) * Un groupe de ressources distinct (pool de périphériques) est créé pour chaque type de profil. * Ensemble, ces profils hétérogènes allouent l’intégralité du framebuffer tout en **prenant en charge plusieurs types de charges de travail** (charges de travail de calcul, graphiques, inférence) sur le même GPU physique. * **Capacité restante**: Cette configuration utilise **l’intégralité du framebuffer de 48 Go**, ne laissant **aucune capacité restante** pour des profils vGPU supplémentaires. {% endhint %} {% endtab %} {% tab title="Configuration vGPU MIG" %} * **Profil NVIDIA vGPU**: sélectionnez le profil MIG souhaité. {% hint style="info" %} **Plusieurs profils utilisés pour un seul périphérique** * Les profils combinés doivent tenir dans le framebuffer total du GPU (VRAM disponible). * Les profils MIG et traditionnels ne peuvent pas être mélangés sur le même périphérique physique. {% endhint %} * **Instances GPU MIG**: (le maximum est indiqué dans la description) nombre d’instances MIG à créer. * **Instances vGPU totales**: défaut=0 (maximum) - ce paramètre détermine le nombre d’instances GPU virtuelles attribuables par partition MIG. * Laissez cette valeur à 0 pour créer automatiquement le nombre maximal de GPU virtuels pour le profil MIG sélectionné. * Définissez la valeur à 1 pour créer un seul GPU virtuel utilisant l’intégralité de la tranche MIG. * Définir une valeur autre que 0 ou 1 entraînera une capacité inutilisée à l’intérieur de la tranche MIG. * **Pilote**: prérempli à partir de l’étape précédente. {% hint style="info" %} **Exemple : instance MIG subdivisée en instances virtuelles** * **Périphérique physique**: Le RTX Pro 6000 Blackwell DC fournit 96 Go de mémoire framebuffer MIG-vGPU * **Profil MIG ajouté**: Sélection du profil *NVIDIA RTX Pro 6000 Blackwell DC‑2‑12Q‑MIG (2g.48gb+gfx)* et en spécifiant *Instances GPU MIG*:1 crée une tranche MIG avec 48 Go de framebuffer dédié. Cette tranche MIG prend en charge **quatre instances vGPU**, chacune utilisant **12 Go** (le profil « 12Q ») * **Capacité restante**: Après l’allocation de cette tranche MIG de 48 Go, **48 Go de framebuffer** restent disponibles pour des profils MIG supplémentaires * Un ou plusieurs groupes de ressources supplémentaires peuvent être créés pour utiliser la capacité restante avec différents types de profils MIG. {% endhint %} {% endtab %} {% endtabs %} ### ISO du pilote invité Les paramètres de pilote invité suivants s’appliquent aux configurations vGPU Traditionnelle et MIG. * **ISO du pilote**: utilisez l’option **Créer l’ISO du pilote invité** pour créer automatiquement un installateur de pilote invité pour vos VM. Si vous avez déjà créé les pilotes invités, sélectionnez l’ISO à l’étape suivante. * Le **ISO du pilote** le fichier spécifie un fichier ISO qui peut être attaché aux VM consommatrices, offrant un moyen pratique d’accéder aux pilotes client pour l’installation dans le système d’exploitation invité. (Sélectionnez l’option ***Attacher les pilotes invités*** lors de l’attachement du périphérique à une VM ou à un locataire.) {% hint style="info" %} **Si vous avez sélectionné l’option *****Créer l’ISO du pilote invité***** option, laissez le champ ISO du pilote défini sur *****-- Aucun --*****; le système créera automatiquement le fichier ISO (sur la base du pilote bundle sélectionné) pour installer les pilotes client sur les VM.** {% endhint %} *** ## Recharger les pilotes * Lorsque la configuration du groupe de ressources est terminée et a été soumise, placez le nœud en [**Mode maintenance**](/run-the-platform/fr/operations/maintenance-mode.md) et cliquez sur **Recharger les pilotes**. * Surveillez les journaux du tableau de bord du nœud (en bas de la page) pour **vérifier que le pilote est correctement installé** avant de désactiver le mode maintenance. {% hint style="success" %} Le tableau de bord du groupe de ressources contient les règles de ressources qui ont été générées automatiquement à partir de vos périphériques NVIDIA sélectionnés. Vous pouvez cliquer sur une règle individuelle pour afficher les détails de configuration. Une règle créée par le système peut être modifiée selon les besoins. Par exemple, le *Nœud* filtre peut être modifié en *-- Aucun --* pour inclure les périphériques correspondants de tous les nœuds ; le *emplacement* filtre peut être supprimé ou modifié pour prendre en compte les périphériques pouvant résider sur différents emplacements au sein d’un même nœud ou sur différents nœuds. Des informations sur les règles de ressources sont disponibles à : [**Présentation du pass-through de périphérique - Règles de ressource**](/run-the-platform/fr/administration-systeme/device-pass-overview.md#resource-rules) {% endhint %} ## Configuration de la VM / de l’invité 1. Accédez au tableau de bord de la VM (depuis le menu supérieur : Machines virtuelles > Liste > double-cliquez sur la VM souhaitée dans la liste) 2. Cliquez sur **Périphériques** dans le menu de gauche. 3. Cliquez sur **Nouveau** dans le menu de gauche.

Vous pouvez également attacher des périphériques à une VM via le Gestionnaire de ressources ; cette méthode permet d’ajouter plusieurs périphériques à la VM en une seule fois. Depuis le tableau de bord du groupe de ressources > double-cliquez sur le groupe vGPU souhaité > Afficher les périphériques de la machine > Nouveau ; sélectionnez la VM dans la liste déroulante Machine.

### Champs du formulaire d’entrée de périphérique * **Nom**: **fournir un nom** pour identifier le type de vGPU/profil **-OU-** laissez vide pour permettre au système de générer automatiquement un nom pour l’instance. * **Type**: sélectionnez ***NVIDIA vGPU***. * **Description** (facultatif) : du texte supplémentaire peut être saisi ici à des fins administratives. * **Groupe de ressources**: sélectionnez le groupe de ressources NVIDIA vGPU approprié dans la liste déroulante. (La liste des groupes de ressources affichera le nombre de périphériques actuellement disponibles dans le groupe.) * **Nombre**: indiquez le nombre de périphériques vGPU à attacher à la VM. (Cette option n’est disponible que lorsque l’entrée de périphérique est accessible via le Gestionnaire de ressources.) * **Attacher les pilotes invités**: si une ISO de pilote invité a été spécifiée pour le groupe de ressources, vous pouvez cocher cette option pour attacher automatiquement un lecteur CD-ROM, chargé avec les pilotes invités NVIDIA, à la VM. * **Limite de fréquence d’images**: pour définir un plafond sur les images par seconde. Les paramètres de taux de rafraîchissement recommandés dépendent de votre charge de travail spécifique. Des taux de rafraîchissement plus faibles réduisent la surcharge inutile sur le vGPU. S’il doit être utilisé uniquement pour des charges de travail de calcul (comme le ML/l’inférence), et non pour des usages graphiques/d’affichage, la limite de fréquence d’images peut être définie sur 0. * **Désactiver la console VNC**: cette option peut être utilisée lorsque le vGPU doit servir d’affichage principal, par exemple un accès uniquement via RDP. * **Paramètres NVIDIA avancés ; consultez la documentation NVIDIA pour des informations sur les options suivantes :** * **Activer la mémoire unifiée** * **Activer les débogueurs NVIDIA CUDA Toolkit** * **Activer les profils NVIDIA CUDA Toolkit** 4. Une fois les champs renseignés, cliquez sur **Soumettre** pour terminer l’ajout du nouveau périphérique. 5. La VM aura besoin d’un **redémarrage** pour attacher le périphérique. Depuis le tableau de bord de la VM, cliquez sur le *Redémarrer* lien dans le message qui apparaît en haut du tableau de bord, ou cliquez sur **Redémarrer** dans le menu de gauche. 6. **Installer le ou les pilotes invités NVIDIA requis**; les pilotes requis varient selon le modèle de GPU et la version du système d’exploitation invité. Si l’option d’attachement des pilotes invités a été sélectionnée, un lecteur CD-ROM sera disponible contenant les pilotes NVIDIA nécessaires à l’installation. 7. Consultez la documentation NVIDIA pour les exigences/instructions de licence vGPU client.

La licence client NVIDIA peut impliquer la génération d’un jeton de configuration client sur le serveur de licences NVIDIA, qui devra ensuite être téléchargé dans l’invité de la VM, suivi d’un redémarrage de la VM.

8. **Vérifier que le vGPU est détecté** — une fois les pilotes invités installés et la VM redémarrée, exécutez `nvidia-smi` dans la VM pour confirmer que le GPU virtuel est reconnu et opérationnel. ## Partager un vGPU NVIDIA avec un locataire Les périphériques vGPU NVIDIA peuvent être transmis à un locataire afin que celui-ci les transmette à ses propres VM. Lorsque vous faites un passthrough de périphériques à un locataire, un nouveau groupe de ressources est créé au sein du locataire. {% hint style="info" %} **Les périphériques partagés avec un locataire sont provisionnés en mode épais (c.-à-d. que le locataire en devient propriétaire, ils ne peuvent donc pas être attribués à d’autres VM ou locataires, même lorsqu’ils ne sont pas utilisés.)** {% endhint %} 1. Accédez au **tableau de bord du locataire** (depuis le menu supérieur : Tenants > Liste > double-cliquez sur le tenant dans la liste.) 2. Cliquez sur **Nœuds** dans le menu de gauche. 3. **Double-cliquez sur l’un des nœuds du tenant**. 4. Cliquez sur **Périphériques** dans le menu de gauche. 5. Cliquez sur **Nouveau** dans le menu de gauche. 6. Référez-vous à [**Champs du formulaire d’entrée de périphérique**](#device-entry-form-fields) ci-dessus. 7. Une fois les champs renseignés, cliquez sur **Soumettre** pour terminer l’ajout du nouveau périphérique. 8. Le périphérique sera désormais disponible pour être attaché aux VM du locataire. Suivez [**Configuration de la VM / de l’invité**](#vmguest-configuration) les instructions ci-dessus. ## Conseils de dépannage * **Recharger les pilotes**: Toute modification d’un groupe de ressources nécessite un rechargement du pilote. Suivez les invites de rechargement en haut du tableau de bord du nœud pour placer le nœud en **Mode maintenance** et recharger les pilotes. Surveillez les journaux du nœud pour vérifier que le pilote s’est bien chargé avant de désactiver le mode maintenance. Répétez le rechargement du pilote pour chaque nœud concerné. * **NVIDIA SMI (Interface de gestion du système)**: Il s’agit d’un puissant outil NVIDIA de dépannage des configurations accessible depuis l’interface VergeOS. Accédez à **Diagnostics des nœuds**, sélectionnez **Requête : *****NVIDIA SMI*** et la commande souhaitée pour fournir des informations de synthèse ou détaillées sur vos périphériques NVIDIA vGPU configurés. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/run-the-platform/fr/administration-systeme/nvidia-vgpu-configuration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.