intel/compute-runtime

Intel®图形计算运行时（oneAPI Level Zero和OpenCL™驱动）容器

本容器为Intel图形硬件架构提供计算API支持（Level Zero和OpenCL）。

以下表格列出可用的Docker镜像标签及其含义：

内核要求

要在本容器中使用Intel GPU硬件，主机系统必须运行支持特定GPU型号的内核。本节描述获取兼容内核的所有方法。

Linux发行版内核

大多数Linux发行版会将硬件支持反向移植到稳定内核版本中。这意味着即使发行版内核版本号低于https://dgpu-docs.intel.com/devices/hardware-table.html%E4%B8%AD%E5%88%97%E5%87%BA%E7%9A%84%E4%B8%8A%E6%B8%B8%E5%86%85%E6%A0%B8%E7%89%88%E6%9C%AC%EF%BC%8C%E4%B9%9F%E5%8F%AF%E8%83%BD%E6%94%AF%E6%8C%81%E4%BD%A0%E7%9A%84GPU%E3%80%82%E8%AF%B7%E5%8F%82%E8%80%83%E5%8F%91%E8%A1%8C%E7%89%88%E5%AE%98%E6%96%B9%E6%96%87%E6%A1%A3%E4%BA%86%E8%A7%A3%E5%86%85%E6%A0%B8%E7%AE%A1%E7%90%86%E5%92%8C%E7%A1%AC%E4%BB%B6%E6%94%AF%E6%8C%81%E7%9A%84%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E3%80%82

注意：本容器仅在Ubuntu上官方支持。它可能在具有兼容内核的其他Linux发行版上工作，但此类配置未经过官方验证。对于非Ubuntu发行版，请参考https://dgpu-docs.intel.com/driver/installation.html%E5%B9%B6%E7%A1%AE%E4%BF%9D%E5%86%85%E6%A0%B8%E7%89%88%E6%9C%AC%E6%BB%A1%E8%B6%B3%E6%96%87%E6%A1%A3%E8%A6%81%E6%B1%82%E3%80%82

上游Linux内核

如果你的发行版内核不支持GPU，可以安装最新的上游Linux内核。较新的硬件通常需要仅在最近内核版本中可用的功能。请参考https://dgpu-docs.intel.com/devices/hardware-table.html%E8%8E%B7%E5%8F%96%E8%AE%BE%E5%A4%87%E6%89%80%E9%9C%80%E7%9A%84%E6%9C%80%E4%BD%8E%E4%B8%8A%E6%B8%B8%E5%86%85%E6%A0%B8%E7%89%88%E6%9C%AC%E3%80%82

Intel提供的内核

如果发行版和上游内核都不能完全支持你的硬件，Intel通过个人软件包存档（PPA）提供动态内核模块支持（DKMS）模块和专用Ubuntu内核。

DKMS

对于受支持的企业发行版，Intel通过DKMS模块提供硬件支持。要验证平台支持并安装DKMS模块，请参考https://dgpu-docs.intel.com/driver/installation.html%E3%80%82

Ubuntu PPA

对于Ubuntu系统，Intel通过PPA提供专用内核，为Intel GPU提供最大的硬件覆盖范围。

要从intel-graphics PPA安装Intel内核，请遵循以下步骤：

1. 更新软件包索引并安装仓库管理工具：

   bash
   sudo apt-get update
   sudo apt-get install -y software-properties-common
   

2. 添加Intel图形PPA：

   bash
   sudo add-apt-repository -y ppa:kobuk-team/intel-graphics
   

3. 安装Intel GPU内核包：

   bash
   sudo apt-get update
   sudo apt-get install -y linux-intel
   

支持的硬件

容器镜像支持广泛的Intel GPU架构。有关支持硬件的详细信息，请参考https://dgpu-docs.intel.com/devices/hardware-table.html%E3%80%82

已知限制

以下Intel GPU未通过提供的容器镜像完全验证，不保证能正常工作：

• Intel®数据中心GPU Max系列
• Intel®数据中心GPU Flex系列

运行容器

在安装了Intel GPU硬件和兼容内核的Linux主机上运行镜像，示例如下：

bash
DEVICE=${DEVICE:-/dev/dri/renderD128}
DEVICE_GRP=$(stat --format %g "$DEVICE")
docker run -it --rm \
    --device "$DEVICE" \
    --group-add "$DEVICE_GRP" \
    -v /dev/dri/by-path:/dev/dri/by-path \
    --ipc=host \
    intel/compute-runtime:latest

许可协议

通过下载和使用这些容器镜像及包含的软件，你同意https://github.com/intel/containers/tree/main/LICENSE%E7%9A%84%E6%9D%A1%E6%AC%BE%E5%92%8C%E6%9D%A1%E4%BB%B6%E3%80%82

根据这些许可协议的条款和条件，特别是要求源代码可用的条款（如GPL），这些容器镜像中包含的所有开源组件的源代码可从https://iotdk.intel.com/container-sources/%E8%8E%B7%E5%8F%96%E3%80%82

注意事项

所有Ubuntu容器镜像仅用于演示目的，不用于生产环境。要从Canonical获得Ubuntu基础层的扩展安全维护，你可以遵循https://documentation.ubuntu.com/pro-client/en/docs/howtoguides/enable_in_dockerfile/%EF%BC%8C%E8%BF%99%E9%9C%80%E8%A6%81%E9%87%8D%E6%96%B0%E6%9E%84%E5%BB%BA%E9%95%9C%E5%83%8F%E3%80%82

致谢

© Intel Corporation。Intel、Intel®图形计算运行时for oneAPI Level Zero和OpenCL™驱动及其他Intel标志是Intel Corporation或其子公司的商标。

• 其他名称和品牌可能是其各自所有者的财产。