accelize.xilinx_xrt
Xilinx XRT Ansible 角色
该 Ansible 角色安装 Xilinx XRT,这是运行基于 Xilinx FPGA 设备的应用程序所必需的。
要求
目标主机上需要一个兼容的 Xilinx FPGA 设备。
该角色需要以 root 身份在目标主机上运行。
角色变量
- xilinx_xrt_install: 如果为
true
,则安装 XRT。
默认为true
。 - xilinx_xrt_version: 要安装的 Xilinx XRT 版本。
默认为最新可用版本。 - xilinx_xrt_from_src: 如果为
true
,则从源代码安装 XRT,而不是使用 Xilinx 提供的包。
默认为false
。 - xilinx_xrt_env: XRT 特定环境。
支持的值:aws
、azure
。
如果未指定,默认为经典的 Xilinx XRT 环境。 - xilinx_xrt_platforms: FPGA 平台列表。如果指定,则安装相关的部署目标平台包。
支持的值包括:u50
、u55c
、u200
、u250
、u280
。 - xilinx_xrt_ensure_compatible_kernel: 如果为
true
,则确保安装的 Linux 内核兼容。
默认为false
。 - xilinx_xrt_bashrc: 如果为
true
,则将 XRT 设置脚本的源添加到用户的~/.bashrc
。
默认为false
。 - xilinx_xrt_check_fpga: 如果为
true
,则检查 XRT 是否正确安装,通过尝试检测 FPGA。
默认为false
。 - xilinx_xrt_container: 如果在容器内运行该角色,请将其设置为
true
以避免内核版本不匹配问题。
默认为false
。 - xilinx_xrt_rhel7_devtoolset: 如果 XRT提供的依赖项安装脚本未安装,则在 RHEL/CentOS 7 上使用的回退 Red Hat 开发工具集版本。
如果 xilinx_xrt_from_src 为false
,则无效。
默认为9
。
AWS FPGA
AWS 环境支持与 AWS FPGA 相关的附加变量。
以下变量仅当 xilinx_xrt_env 设置为 aws
时可用。
- aws_fpga_install: 如果为
true
,则安装 AWS FPGA 运行时库。
默认为true
。 - aws_fpga_src_install: 如果指定,则在指定目录中安装 AWS FPGA 源代码。
默认为不安装源代码。 - aws_fpga_version: 要安装的 AWS FPGA 版本。
默认为最新可用版本。 - aws_fpga_allow_non_root: 如果为
true
,允许所有用户或特定组的用户访问 FPGA 设备。请参见 aws_fpga_sdk_others。
默认为false
。 - aws_fpga_sdk_others: 如果为
true
,则允许 FPGA 设备访问所有用户,否则仅允许访问由 aws_fpga_sdk_group 指定的组中的用户。
默认为false
。
如果 aws_fpga_allow_non_root 为false
,则无效。 - aws_fpga_sdk_group: 可以访问 FPGA 设备的用户组名称。
默认为fpgauser
。
如果 aws_fpga_allow_non_root 为false
或 aws_fpga_sdk_others 为true
,则无效。 - aws_fpga_sdk_override_group: 如果为
true
,如果 aws_fpga_sdk_group 指定的组已经存在,则不引发错误。
默认为false
。
如果 aws_fpga_allow_non_root 为false
或 aws_fpga_sdk_others 为true
,则无效。 - aws_fpga_driver: 如果指定,则安装指定的替代驱动程序。
如果未指定,则使用默认的 XOCL 驱动程序。
这可能需要将 xilinx_xrt_install 设置为false
。
支持的值:xdma
。
Xilinx 视频 SDK
与 Xilinx 视频 SDK 相关的附加变量,用于 Alveo U30/AWS VT1。
- xilinx_video_sdk_install: 如果为
true
,则安装 Xilinx 视频 SDK。
默认为false
。 - xilinx_video_sdk_version: 要安装的 Xilinx 视频 SDK 版本。
默认为最新可用版本。
注意:由于 Xilinx 视频 SDK 已经包含 XRT,xilinx_xrt_install
会自动设置为 false
。
示例剧本
包含一个如何使用您的角色的示例(例如,将变量作为参数传递)对用户总是很友好:
- hosts: servers
become: true
roles:
- role: accelize.xilinx_xrt
依赖关系
如果设置 xilinx_xrt_ensure_compatible_kernel 为 true
,则需要角色 accelize.linux_kernel。
许可证
版权所有 Accelize 2019,Apache 2.0
已安装组件许可证:
此 Ansible 角色并不被 Xilinx 或 AWS 认可或隶属。
作者信息
该角色由 Accelize 提供。