Rol de Ansible para Xilinx XRT

Este rol de Ansible instala el Xilinx XRT que es necesario para ejecutar aplicaciones basadas en dispositivos FPGA de Xilinx.

Requisitos

Se requiere un dispositivo FPGA de Xilinx compatible en el host de destino.

El rol debe ejecutarse como root en el host de destino.

Variables del Rol

• xilinx_xrt_install: Si es true, instala XRT. Por defecto es true.
• xilinx_xrt_version: Versión de Xilinx XRT a instalar. Por defecto, la última disponible.
• xilinx_xrt_from_src: Si es true, instala XRT desde el código fuente en lugar de los paquetes proporcionados por Xilinx. Por defecto es false.
• xilinx_xrt_env: Entorno específico de XRT. Valores soportados: aws, azure. Si no se especifica, por defecto es el entorno clásico de Xilinx XRT.
• xilinx_xrt_platforms: Lista de plataformas FPGA. Si se especifica, instala los paquetes de la plataforma objetivo relacionada. Valores soportados en la lista: u50, u55c, u200, u250, u280.
• xilinx_xrt_ensure_compatible_kernel: Si es true, asegura que el kernel de Linux instalado sea compatible. Por defecto es false.
• xilinx_xrt_bashrc: Si es true, agrega la fuente del script de configuración de XRT al usuario ~/.bashrc. Por defecto es false.
• xilinx_xrt_check_fpga: Si es true, verifica si XRT está correctamente instalado tratando de detectar FPGA. Por defecto es false.
• xilinx_xrt_container: Establezca esto en true si ejecuta el rol dentro de un contenedor para evitar problemas de incompatibilidad de versiones del kernel. Por defecto es false.
• xilinx_xrt_rhel7_devtoolset: Versión de Red Hat Developer Toolset de respaldo para usar en RHEL/CentOS 7 si no se instala por el script de instalación de dependencias proporcionado por XRT. No tiene efecto si xilinx_xrt_from_src es false. Por defecto es 9.

FPGA de AWS

El entorno de AWS soporta variables adicionales asociadas a AWS FPGA.

Lo siguiente solo está disponible cuando xilinx_xrt_env está configurado como aws.

• aws_fpga_install: Si es true, instala las bibliotecas de tiempo de ejecución de AWS FPGA. Por defecto es true.
• aws_fpga_src_install: Si se especifica, instala los fuentes de AWS FPGA en el directorio especificado. Por defecto no se instalan fuentes.
• aws_fpga_version: Versión de AWS FPGA a instalar. Por defecto, la última disponible.
• aws_fpga_allow_non_root: Si es true, permite que los dispositivos FPGA sean accesibles por todos los usuarios o usuarios de un grupo específico. Ver aws_fpga_sdk_others. Por defecto es false.
• aws_fpga_sdk_others: Si es true, permite que los dispositivos FPGA sean accesibles para todos los usuarios; de lo contrario, permite el acceso a los usuarios en el grupo especificado por aws_fpga_sdk_group. Por defecto es false. No tiene efecto si aws_fpga_allow_non_root es false.
• aws_fpga_sdk_group: Nombre del grupo de usuarios que pueden acceder a los dispositivos FPGA. Por defecto es fpgauser. No tiene efecto si aws_fpga_allow_non_root es false o si aws_fpga_sdk_others es true.
• aws_fpga_sdk_override_group: Si es true, no genera un error si el grupo especificado por aws_fpga_sdk_group ya existe. Por defecto es false. No tiene efecto si aws_fpga_allow_non_root es false o si aws_fpga_sdk_others es true.
• aws_fpga_driver: Si se especifica, instala el controlador alternativo especificado. Si no se especifica, usa el controlador por defecto XOCL. Esto puede requerir que xilinx_xrt_install esté configurado como False. Valores soportados: xdma.

SDK de Video de Xilinx

Variable adicional asociada al SDK de Video de Xilinx para Alveo U30/AWS VT1.

• xilinx_video_sdk_install: Si es true, instala el SDK de video de Xilinx. Por defecto es false.
• xilinx_video_sdk_version: Versión del SDK de video de Xilinx a instalar. Por defecto, la última disponible.

Nota: xilinx_xrt_install se establece automáticamente como false con el SDK de video de Xilinx porque ya incluye XRT.

Ejemplo de Playbook

Incluir un ejemplo de cómo usar tu rol (por ejemplo, con variables pasadas como parámetros) siempre es útil para los usuarios:

- hosts: servers
  become: true  
  roles:
     - role: accelize.xilinx_xrt

Dependencias

El rol accelize.linux_kernel es requerido si xilinx_xrt_ensure_compatible_kernel está configurado como true.

Licencia

Copyright Accelize 2019, Apache 2.0

Licencias de los componentes instalados:

• Licencia de Xilinx XRT
• Licencia de Xilinx Video SDK
• Licencia de AWS FPGA

Este rol de Ansible no está respaldado ni afiliado a Xilinx o AWS.

Información del Autor

Este rol es proporcionado por Accelize.