> 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/es/administracion-del-sistema/generic-pci-passthrough.md).

# PCI passthrough uno a uno

El passthrough PCI uno a uno implica otorgar a una sola VM a la vez acceso a un dispositivo PCI que está físicamente conectado a un nodo anfitrión. El sistema operativo invitado de la VM utiliza el dispositivo como si estuviera conectado directamente.

## Instalación/configuración del host

{% hint style="danger" %}
**Es importante leer y familiarizarse con** [**Riesgos y precauciones del passthrough PCI**](/run-the-platform/es/administracion-del-sistema/device-pass-overview.md#pci-passthrough-risksprecautions) **antes de realizar configuraciones de passthrough.**
{% endhint %}

1. Vaya al **Panel de control del Administrador de recursos** (**Infraestructura** > **Recursos** desde el menú superior **-O-** Panel principal > Recursos) **-O-** Navegue a un **panel de nodo específico** (**Infraestructura** > **Nodos** desde el menú superior \*-O-**Panel principal > Nodos**, luego haga doble clic en el nodo deseado en la lista.)
2. Haga clic en **Dispositivos PCI**.
3. Seleccione el/los dispositivo(s) deseado(s) en la lista y haga clic en **Crear recurso** en el menú de la izquierda.
4. **Seleccione un grupo de recursos de dispositivos PCI existente** deseado de la lista **-O-** **Crear un nuevo grupo de recursos PCI**.

### Creación de un grupo de recursos de dispositivos PCI

1. **Nombre**: etiqueta usada para identificar el grupo de recursos (es decir, el grupo de dispositivos); use un nombre descriptivo para que los usuarios puedan identificar fácilmente el tipo de dispositivo(s) en este grupo, por ejemplo, *GPU PCI*
2. **Tipo**: ***PCI***
3. **Descripción**: campo opcional para proporcionar más texto administrativo sobre el grupo de recursos.
4. **Clase**: seleccione la clasificación más adecuada de la lista desplegable. Este campo solo se usa para aplicar un icono asociado al grupo de recursos y no afecta la funcionalidad.
5. Haga clic en **Enviar** para finalizar la creación del nuevo grupo de recursos.
6. **Puede ser necesario reiniciar el/los nodo(s) asociado(s)**; aparecerá un mensaje en la parte superior del panel del Administrador de recursos.

{% hint style="warning" %}
**Siga los** [**Modo de mantenimiento**](/run-the-platform/es/operaciones/maintenance-mode.md) **procedimientos adecuados al reiniciar un nodo para evitar interrupciones en las cargas de trabajo.**
{% endhint %}

Después de seleccionar/crear el grupo de recursos, un *Éxito* debería aparecer un mensaje indicando que se crearon reglas de recursos para el/los dispositivo(s).

## Configuración de VM/invitado

1. Navegue al panel de la VM deseada (**Máquinas virtuales** > **Lista**  > haga doble clic en la VM deseada en la lista).
2. Haga clic en **Dispositivos** en el menú de la izquierda.
3. Haga clic en **Nuevo** en el menú de la izquierda.

{% hint style="success" %}
**También puede conectar dispositivos a una VM mediante el Administrador de recursos; este método permite agregar varios dispositivos a la VM a la vez. Desde el panel Grupo de recursos > haga doble clic en el Grupo PCI deseado > Ver dispositivos de la máquina > Nuevo; seleccione la VM en la lista desplegable Máquina.**
{% endhint %}

4. Campos del formulario de entrada de dispositivo:

* **Nombre**: proporcione un nombre para identificar adecuadamente el tipo de dispositivo(s), o déjelo en blanco para permitir que el sistema genere automáticamente un nombre de dispositivo.
* **Tipo**: ***PCI***
* **Descripción**(opcional): aquí se puede introducir texto adicional con fines administrativos.
* **Grupo de recursos**: seleccione el grupo de recursos PCI apropiado de la lista desplegable
* **Cantidad**: indique el número de dispositivos PCI que se adjuntarán a la VM (de este grupo de recursos).

5. Haga clic en **Enviar** para completar la adición del nuevo dispositivo.
6. La VM necesitará un **reinicio** para adjuntar el dispositivo. Desde el panel de la VM, haga clic en el *Reiniciar* enlace en el mensaje que aparece en la parte superior del panel, o haga clic en **Reiniciar** en el menú de la izquierda.
7. Instale cualquier cliente requerido **controladores**. Consulte la documentación del proveedor del hardware.
8. **Reinicie la VM**.

## Pasar un dispositivo PCI a un inquilino

Los dispositivos PCI pueden pasarse a un inquilino para que este los pase a sus propias VM. Cuando pasa dispositivos PCI al inquilino, se crea un nuevo grupo de recursos dentro del inquilino.

{% hint style="info" %}
**Cuando los dispositivos se comparten con un inquilino, se aprovisionan de forma gruesa (es decir, el inquilino pasa a ser el propietario de los dispositivos, por lo que no pueden asignarse a otras VM o inquilinos incluso cuando no están en uso.)**
{% endhint %}

1. Navegue hasta el deseado **panel del inquilino** (desde el menú superior: Inquilinos > Lista > haga doble clic en el inquilino dentro de la lista.)
2. Haga clic en **Nodos** en el menú de la izquierda.
3. **Haga doble clic en uno de los nodos del inquilino**.
4. Haga clic en **Dispositivos** en el menú de la izquierda.
5. Haga clic en **Nuevo** en el menú de la izquierda.
6. Introduzca un **Nombre** o déjelo en blanco para permitir que el sistema cree automáticamente un nombre; este nombre se usará para el grupo de recursos creado en el inquilino.
7. **Tipo**: ***PCI***
8. **Descripción**: proporciona un lugar para almacenar información administrativa adicional sobre el grupo de dispositivos.
9. **Cantidad**: número de dispositivos que se pasarán al grupo de recursos del inquilino.
10. Cuando los campos estén completados, haga clic en **Enviar** para finalizar el paso al inquilino.
11. El/los dispositivo(s) ahora estarán disponibles como un grupo de recursos para adjuntar a las VM del inquilino. Siga [**Configuración de VM/invitado**](#vmguest-configuration) las instrucciones anteriores. Para utilizar el dispositivo de passthrough, la VM debe ejecutarse en el nodo del inquilino donde está conectado el dispositivo.


---

# 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/es/administracion-del-sistema/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.