> 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/generic-pci-passthrough.md).

# Pass-through PCI un-à-un

Le passthrough PCI un-à-un consiste à donner à une seule VM à la fois l’accès à un périphérique PCI physiquement attaché à un nœud hôte. Le système d’exploitation invité de la VM utilise le périphérique comme s’il était directement connecté.

## 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 %}

1. Accédez au **Tableau de bord du gestionnaire de ressources** (**Infrastructure** > **Ressources** depuis le menu supérieur **-OU-** (Tableau de bord principal > Ressources) **-OU-** Accédez à un **tableau de bord d’un nœud spécifique** (**Infrastructure** > **Nœuds** depuis le menu supérieur \*-OU-**Tableau de bord principal > Nœuds**, puis double-cliquez sur le nœud souhaité dans la liste.)
2. Cliquez sur **Périphériques PCI**.
3. Sélectionnez le ou les périphérique(s) souhaité(s) dans la liste et cliquez sur **Créer une ressource** dans le menu de gauche.
4. **Sélectionner un groupe de ressources de périphériques PCI existant** dans la liste **-OU-** **Créer un nouveau groupe de ressources PCI**.

### Création d’un groupe de ressources de périphériques PCI

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. *GPU PCI*
2. **Type**: ***PCI***
3. **Description**: champ facultatif permettant de fournir davantage de texte administratif sur le groupe de ressources.
4. **Classe**: sélectionnez la classification la plus appropriée dans la liste déroulante. Ce champ est uniquement utilisé pour appliquer une icône associée au groupe de ressources et n’affecte pas les fonctionnalités.
5. Cliquez sur **Soumettre** pour terminer la création du nouveau groupe de ressources.
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 %}

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).

## Configuration de la VM / de l’invité

1. Accédez au tableau de bord de la VM souhaitée (**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 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 PCI souhaité > Afficher les périphériques de la machine > Nouveau ; sélectionnez la VM dans la liste déroulante Machine.**
{% endhint %}

4. Champs du formulaire d’entrée du périphérique :

* **Nom**: indiquez un nom pour identifier adéquatement le type de périphérique(s), ou laissez vide pour permettre au système de générer automatiquement un nom de périphérique.
* **Type**: ***PCI***
* **Description**(facultatif) : du texte supplémentaire peut être saisi ici à des fins administratives.
* **Groupe de ressources**: sélectionnez le groupe de ressources PCI approprié dans la liste déroulante
* **Nombre**: indiquez le nombre de périphériques PCI à attacher à la VM (de ce groupe de ressources).

5. Cliquez sur **Soumettre** pour terminer l’ajout du nouveau périphérique.
6. 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.
7. Installez les **pilotes** clients requis. Consultez la documentation du fournisseur matériel.
8. **Redémarrez la VM**.

## Transférer un périphérique PCI à un tenant

Les périphériques PCI peuvent être transférés à un tenant afin que celui-ci les transmette à ses propres VM. Lorsque vous transmettez des périphériques PCI au tenant, un nouveau groupe de ressources est créé dans le tenant.

{% 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**: ***PCI***
8. **Description**: offre un emplacement pour stocker des informations administratives supplémentaires sur le pool de périphériques.
9. **Nombre**: nombre de périphériques à transférer dans le groupe de ressources du tenant.
10. Une fois les champs renseignés, cliquez sur **Soumettre** pour terminer le transfert vers le tenant.
11. 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/generic-pci-passthrough.md?ask=<question>&goal=<endgoal>
```

`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.