> 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/sriov-nics.md).

# NIC SR-IOV

VergeOS proporciona compatibilidad con tarjetas de red compatibles con SR-IOV, lo que permite compartir múltiples instancias de dispositivos (funciones virtuales) con inquilinos y VMs desde un único dispositivo controlador de red PCIe.

{% hint style="info" %}
**VergeOS proporciona capacidad integrada y virtualizada de adaptador de red para máquinas virtuales. Se admiten NIC de función virtual SR-IOV (versión 4.13 y superior) para escenarios en los que el paso directo de NIC es un requisito. Cuando se utiliza el paso directo de NIC, se omite la red de VergeOS, perdiendo la portabilidad inherente, la redundancia y otras funciones de red.**
{% endhint %}

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

Las siguientes instrucciones configurarán el paso directo de funciones virtuales creando automáticamente las reglas de recursos necesarias para cada conjunto de funciones virtuales y adjuntando las reglas al grupo de recursos seleccionado. Para obtener más información sobre cómo funcionan los grupos de recursos y las reglas de recursos, consulte: [**Paso directo de dispositivos - Reglas de recursos**](/run-the-platform/es/administracion-del-sistema/device-pass-overview.md#resource-rules).

1. Vaya al **Panel de control del Administrador de recursos** (**Infraestructura** > **Recursos**) **-O-** Navegue a un **panel de nodo específico** (**Infraestructura** > **Nodos** > haga doble clic en el nodo deseado de la lista.)
2. Haga clic en **NIC SR-IOV**. Cualquier dispositivo virtual SR-IOV ya configurado se mostrará en la lista que aparece.
3. Haga clic en **Dispositivos PCI de NIC** en el menú de la izquierda. Se mostrará la lista de dispositivos físicos compatibles.
4. **Seleccione el/los dispositivo(s) deseado(s)** en la lista y haga clic en **Crear recurso** en el menú de la izquierda.
5. **Seleccione un grupo de recursos SR-IOV** deseado de la lista **-O-** **Crear un nuevo grupo de recursos SR-IOV**.

### Creación de un grupo de recursos de NIC SR-IOV

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, *NIC SR-IOV vlan10*
2. **Tipo**: ***NIC SR-IOV***.
3. **Descripción**: campo opcional para proporcionar más texto administrativo sobre el grupo de recursos.
4. **Clase**: ***Red***. Este campo solo se usa para aplicar un icono asociado al grupo de recursos y no afecta a la funcionalidad.

#### Configuración de NIC SR-IOV

* Especifique el **número de dispositivos VF** (por dispositivo físico). El número total de dispositivos VF que se crearán será el número especificado multiplicado por el número de dispositivos físicos seleccionados.
* Marque la ***Definido por el usuario*** opción para campos en los que se debe permitir que un usuario de la VM reemplace la configuración especificada; los campos que no tengan marcada la opción Definido por el usuario no pueden ser modificados por el usuario al adjuntar el dispositivo a una VM.
* **VLAN nativa**: (opcional) etiqueta VLAN para el dispositivo virtual.
* **Protocolo VLAN**: *802.1Q* (predeterminado) es el más utilizado. *802.1ad* proporciona soporte para QinQ (anidación de etiquetas VLAN).
* **Ancho de banda mínimo de transmisión (Mbps)**: (opcional) se puede configurar para garantizar la transmisión al menos al mínimo especificado (por vf). Esto puede usarse para asignar a diferentes grupos de recursos diferentes porciones del ancho de banda total. Establecerlo en 0 deshabilita la limitación de velocidad. La configuración de Ancho de banda mínimo de transmisión debe establecerse en un valor inferior al Ancho de banda máximo de transmisión.
* **Estado del enlace virtual**:\
  \&#xNAN;***Automático*** - el estado de la VF simplemente reflejará el del dispositivo físico asociado.\
  \&#xNAN;***Habilite*** - permitirá que el dispositivo virtual se comunique con otros dispositivos virtuales en el mismo host incluso cuando el dispositivo físico esté caído.\
  \&#xNAN;***Deshabilitar*** - los paquetes enviados por el dispositivo virtual son descartados por el hardware.
* **Comprobación de suplantación**: activa o desactiva la comprobación de suplantación MAC para el dispositivo virtual.
* **QoS de VLAN (Prioridad)**: (opcional) valor 0-7; establece la prioridad de QoS para el tráfico de vf. La prioridad de QoS depende del hardware, el controlador y la compatibilidad del sistema operativo invitado.
* **Ancho de banda máximo de transmisión (Mbps)**: se puede configurar para limitar el ancho de banda (por vf). Esto puede usarse para asignar a diferentes grupos de recursos (es decir, grupos de funciones virtuales) diferentes porciones del ancho de banda total.
* **Confianza**: cuando se activa, el consumidor de la VM puede configurar funciones específicas que pueden afectar la seguridad y/o el rendimiento (por ejemplo, el modo promiscuo de multidifusión); ciertos casos de uso, como los servicios de capa 2, requerirán que Confianza esté activada.
* **Comprobación de RSS de consulta**: cuando se activa, se puede obtener información de configuración del dispositivo desde el dispositivo virtual dentro del sistema operativo invitado; algunos dispositivos lo prohibirán de forma predeterminada porque la información puede considerarse sensible cuando se comparte entre el dispositivo virtual y el físico.

5. Haga clic en **Enviar** para finalizar la creación del nuevo grupo de recursos.

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

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

El panel del grupo de recursos contiene las reglas de recursos que se generaron automáticamente para los dispositivos seleccionados. Puede hacer clic en una regla individual para ver los detalles de configuración. Una regla creada por el sistema puede modificarse según sea necesario; por ejemplo, el *Nodo* filtro puede cambiarse a *-- Ninguno --* para incluir dispositivos coincidentes de todos los nodos. La información sobre las reglas de recursos está disponible en: [**Resumen del paso directo de dispositivos - Reglas de recursos**](/run-the-platform/es/administracion-del-sistema/device-pass-overview.md#resource-rules)

## Configuración de VM/invitado

1. Vaya al **de la VM** (desde el menú superior: 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 adjuntar dispositivos a una VM a través del Administrador de recursos: desde el panel del grupo de recursos > haga doble clic en el grupo SR-IOV deseado > Ver dispositivos de máquina > Nuevo; seleccione la VM en la lista desplegable Máquina.**
{% endhint %}

### Campos del formulario de entrada de dispositivos

* **Nombre**: proporcione un nombre para identificar el dispositivo, por ejemplo, "Intel xl710 sriov", o déjelo en blanco para permitir que el sistema genere automáticamente un nombre de dispositivo.
* **Tipo**: seleccione ***NIC SR=IOV***;
* **Descripción**(opcional): aquí se puede introducir texto adicional con fines administrativos.
* **Grupo de recursos**: seleccione el grupo de recursos SR-IOV correspondiente en la lista desplegable
* **Cantidad**: indique el número de dispositivos vf SR-IOV que se adjuntarán a la VM (de este grupo de recursos).
* **Configuración de NIC SR-IOV**: las opciones disponibles aquí dependerán de la *Definido por el usuario* selecciones de alternancia definidas en la Configuración de SR-IOV del grupo de recursos (consulte **Configuración de SR-IOV** arriba.)

4. Haga clic en **Enviar** para completar la adición del nuevo dispositivo.
5. 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.
6. Instale cualquier cliente requerido **Controladores NIC**. Los controladores requeridos variarán según la marca/modelo específico de la NIC SR-IOV y el sistema operativo invitado; consulte la documentación del proveedor de hardware.
7. **Reiniciar** la VM.

## Compartir dispositivos SR-IOV con un inquilino

Los dispositivos SR-IOV pueden pasarse a un inquilino para que este los pase a sus propias VMs. Cuando pasa NIC de función virtual SR-IOV 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**: configurar en ***NIC SR-IOV***.
8. **Descripción**: proporciona un lugar para almacenar información administrativa adicional sobre el grupo de dispositivos.
9. **Cantidad**: número de NIC de función virtual que se pasarán al grupo de recursos del inquilino.
10. Un dirección MAC específica **Dirección MAC** puede introducirse o dejarse en blanco para permitir que el sistema genere automáticamente una dirección MAC (se recomienda dejar este campo en blanco, permitiendo direcciones MAC únicas generadas por el sistema para evitar introducir inadvertidamente direcciones MAC duplicadas dentro de la misma red.)
11. Cuando los campos estén completados, haga clic en **Enviar** para finalizar el paso al inquilino.
12. 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/sriov-nics.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.
