> 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/sriov-nics.md). # NIC SR-IOV VergeOS fournit la prise en charge des cartes réseau compatibles SR-IOV, permettant de partager plusieurs instances de périphériques (fonctions virtuelles) aux locataires et aux VM à partir d'un seul périphérique contrôleur réseau PCIe. {% hint style="info" %} **VergeOS fournit une capacité intégrée d'adaptateur réseau virtualisé pour les machines virtuelles. Les NIC à fonction virtuelle SR-IOV sont prises en charge (version 4.13 et supérieure) pour les scénarios où le pass-through direct de NIC est requis. Lorsque le pass-through direct de NIC est utilisé, la mise en réseau VergeOS est contournée, ce qui fait perdre la portabilité inhérente, la redondance et d'autres fonctionnalités réseau.** {% endhint %} ## Installation/Configuration de l’hôte {% hint style="danger" %} **Il est important de lire et de connaître** [**les risques et précautions liés au passthrough PCI**](/run-the-platform/fr/administration-systeme/device-pass-overview.md#pci-passthrough-risksprecautions) **avant de configurer le passthrough.** {% endhint %} Les instructions suivantes configureront le pass-through de fonction virtuelle en créant automatiquement les règles de ressource nécessaires pour chaque ensemble de fonctions virtuelles et en associant les règles au groupe de ressources sélectionné. Pour plus d'informations sur le fonctionnement des groupes de ressources et des règles de ressources, voir : [**Pass-through de périphérique - Règles de ressource**](/run-the-platform/fr/administration-systeme/device-pass-overview.md#resource-rules). 1. Accédez au **Tableau de bord du gestionnaire de ressources** (**Infrastructure** > **Ressources**) **-OU-** Accédez à un **tableau de bord d’un nœud spécifique** (**Infrastructure** > **Nœuds** > double-cliquez sur le nœud souhaité dans la liste.) 2. Cliquez sur **NIC SR-IOV**. Tous les périphériques virtuels SR-IOV déjà configurés s'afficheront dans la liste qui apparaît. 3. Cliquez sur **Périphériques PCI des NIC** dans le menu de gauche. La liste des périphériques physiques compatibles s'affichera. 4. **Sélectionnez le ou les périphérique(s) souhaité(s)** dans la liste, puis cliquez sur **Créer une ressource** dans le menu de gauche. 5. **Sélectionnez un groupe de ressources SR-IOV** dans la liste **-OU-** **Créer un nouveau groupe de ressources SR-IOV**. ### Création d'un groupe de ressources NIC SR-IOV 1. **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érique(s) dans ce groupe, par ex. *NIC SR-IOV vlan10* 2. **Type**: ***NIC SR-IOV***. 3. **Description**: champ facultatif permettant de fournir davantage de texte administratif sur le groupe de ressources. 4. **Classe**: ***Réseau***. Ce champ est uniquement utilisé pour appliquer une icône associée au groupe de ressources et n'affecte pas la fonctionnalité. #### Paramètres NIC SR-IOV * Spécifiez le **nombre de périphériques VF** (par périphérique physique). Le nombre total de périphériques VF à créer sera le nombre indiqué multiplié par le nombre de périphériques physiques sélectionnés. * Cochez la ***Défini par l'utilisateur*** option pour les champs pour lesquels un utilisateur de VM devrait être autorisé à remplacer le paramètre spécifié ; les champs pour lesquels l'option Défini par l'utilisateur n'est pas cochée ne peuvent pas être modifiés par l'utilisateur lors de la connexion du périphérique à une VM. * **VLAN natif**: (facultatif) étiquette VLAN pour le périphérique virtuel. * **Protocole VLAN**: *802.1Q* (par défaut) est le plus largement utilisé. *802.1ad* prend en charge QinQ (imbrication des balises VLAN). * **Bande passante minimale d'émission (Mbps)**: (facultatif) peut être défini pour garantir une transmission d'au moins le minimum spécifié (par VF). Cela peut être utilisé pour donner à différents groupes de ressources différentes parts de la bande passante globale. Le réglage de 0 désactive la limitation de débit. Le paramètre Bande passante minimale d'émission doit être défini sur une valeur inférieure à la bande passante maximale d'émission. * **État de lien virtuel**:\ \&#xNAN;***Auto*** - l'état de la VF reflétera simplement celui du périphérique physique associé.\ \&#xNAN;***Activez*** - permettra au périphérique virtuel de communiquer avec d'autres périphériques virtuels sur le même hôte même lorsque le périphérique physique est hors service.\ \&#xNAN;***Désactiver*** - les paquets envoyés par le périphérique virtuel sont rejetés par le matériel. * **Vérification de l'usurpation**: active ou désactive la vérification d'usurpation Mac pour le périphérique virtuel. * **QoS VLAN (Priorité)**: (facultatif) valeur 0-7 ; définit la priorité QoS pour le trafic VF. La priorité QoS dépend du matériel, du pilote et de la prise en charge du système d'exploitation invité. * **Bande passante maximale d'émission (Mbps)**: peut être défini pour limiter la bande passante (par VF). Cela peut être utilisé pour donner à différents groupes de ressources (c.-à-d. des pools de fonctions virtuelles) différentes parts de la bande passante globale. * **Confiance**: lorsqu'il est activé, le consommateur de la VM peut définir des fonctionnalités spécifiques qui peuvent avoir un impact sur la sécurité et/ou les performances (par ex. le mode promiscuité multicast) ; certains cas d'utilisation, tels que les services de couche 2, nécessiteront l'activation de Confiance. * **Vérification RSS de requête**: lorsqu'il est activé, les informations de configuration du périphérique peuvent être obtenues à partir du périphérique virtuel dans le système d'exploitation invité ; certains périphériques interdiront cela par défaut parce que ces informations peuvent être considérées comme sensibles lorsqu'elles sont partagées entre le périphérique virtuel et le périphérique physique. 5. Cliquez sur **Soumettre** pour terminer la création du nouveau groupe de ressources. Après la sélection/la création du groupe de ressources, 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). 6. **Un redémarrage du ou des nœud(s) associés peut être nécessaire** ; un message apparaîtra en haut du tableau de bord du gestionnaire de ressources. {% hint style="warning" %} **Suivez les** [**Mode maintenance**](/run-the-platform/fr/operations/maintenance-mode.md) **procédures appropriées lors du redémarrage d’un nœud afin d’éviter les perturbations de charge de travail.** {% endhint %} Le tableau de bord du groupe de ressources contient les règles de ressource qui ont été générées automatiquement pour les périphériques 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. Des informations concernant les règles de ressource 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) ## 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. {% hint style="success" %} **Vous pouvez également associer des périphériques à une VM via le Gestionnaire de ressources : depuis le tableau de bord du groupe de ressources > double-cliquez sur le groupe SR-IOV souhaité > Afficher les périphériques de la machine > Nouveau ; sélectionnez la VM dans la liste déroulante Machine.** {% endhint %} ### Champs du formulaire d'entrée de périphérique * **Nom**: fournissez un nom pour identifier le périphérique, par ex. « Intel xl710 sriov », ou laissez vide pour permettre au système de générer automatiquement un nom de périphérique. * **Type**: sélectionnez ***NIC SR-IOV***; * **Description**(facultatif) : du texte supplémentaire peut être saisi ici à des fins administratives. * **Groupe de ressources**: sélectionnez le groupe de ressources SR-IOV approprié dans la liste déroulante * **Nombre**: indiquez le nombre de périphériques VF SR-IOV à associer à la VM (à partir de ce groupe de ressources). * **Paramètres NIC SR-IOV**: les options disponibles ici dépendront des *Défini par l'utilisateur* sélections de bascule définies dans les paramètres SR-IOV du groupe de ressources (voir **Paramètres SR-IOV** ci-dessus.) 4. 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. Installez les **Pilotes NIC**. Le ou les pilotes requis varieront en fonction de la marque/modèle précis de la NIC SR-IOV et du système d'exploitation invité ; consultez la documentation du fournisseur du matériel. 7. **Redémarrer** la VM. ## Partager des périphériques SR-IOV avec un locataire Les périphériques SR-IOV peuvent être transmis à un locataire afin qu'il les transmette à ses propres VM. Lorsque vous transmettez des NIC à fonction virtuelle SR-IOV au locataire, un nouveau groupe de ressources est créé dans le locataire. {% hint style="info" %} **Lorsque des périphériques sont partagés avec un tenant, ils sont provisionnés en dur (c.-à-d. que le tenant en devient propriétaire, ils ne peuvent donc pas être attribués à d’autres VM ou tenants 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. Saisissez un **Nom** ou laissez vide pour permettre au système de créer automatiquement un nom ; ce nom sera utilisé pour le groupe de ressources créé dans le tenant. 7. **Type**: définissez sur ***NIC SR-IOV***. 8. **Description**: offre un emplacement pour stocker des informations administratives supplémentaires sur le pool de périphériques. 9. **Nombre**: nombre de NIC à fonction virtuelle à transmettre au groupe de ressources du locataire. 10. Un spécifique **Adresse MAC** peut être saisi ou laissé vide pour permettre au système de générer automatiquement une adresse MAC (il est recommandé de laisser ce champ vide, afin d'autoriser des adresses MAC uniques générées par le système pour éviter d'introduire involontairement des adresses MAC dupliquées au sein du même réseau.) 11. Une fois les champs renseignés, cliquez sur **Soumettre** pour terminer le transfert vers le tenant. 12. Le ou les périphérique(s) seront désormais disponibles en tant que groupe de ressources à attacher aux VM du tenant. Suivez [**Configuration de la VM / de l’invité**](#vmguest-configuration) les instructions ci-dessus. Afin d’utiliser le périphérique en passthrough, la VM doit s’exécuter sur le nœud du tenant où le périphérique est attaché. --- # 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/sriov-nics.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.