intel/oneapi-runtime

Intel® oneAPI Runtime Libraries 镜像文档

1. 镜像概述和主要用途

Intel® oneAPI Runtime Libraries 是一套核心库集合，用于在多样化架构上部署高性能、数据中心应用。该镜像提供了运行时环境，支持基于 oneAPI 开发的应用程序在不同硬件目标（CPU、GPU、FPGA 等）上高效执行，是部署 oneAPI 应用的基础组件。

2. 核心功能和特性

2.1 跨架构代码复用

集成 Data Parallel C++ (DPC++) 语言支持，允许代码在 CPU、GPU 和 FPGA 等多种硬件目标上复用，减少跨平台开发成本。

2.2 加速器自定义调优

支持针对特定加速器（如 GPU、FPGA）的自定义性能调优，满足不同硬件架构的优化需求，提升应用执行效率。

3. 使用场景和适用范围

适用于需要跨硬件架构部署的高性能计算、数据处理及人工智能应用场景，例如：

• 科学计算与数值模拟应用
• 大规模数据处理与分析任务
• 多加速器协同的异构计算场景

4. 使用方法和配置说明

4.1 容器获取

该镜像提供多种基础操作系统版本，可通过 Docker Hub 或 GitHub 仓库获取：

更多容器及资源可访问 Intel® oneContainer Portal 或 GitHub 仓库 https://github.com/intel/oneapi-containers/tree/master/images/docker/runtime%E3%80%82

4.2 部署示例

4.2.1 拉取镜像

使用 docker pull 命令拉取指定标签的镜像：

bash
# 拉取基于 Ubuntu 24.04 的镜像  
docker pull intel/oneapi-runtime:ubuntu24.04  

# 拉取基于 Rocky Linux 9 的镜像  
docker pull intel/oneapi-runtime:rockylinux9  

4.2.2 运行容器

通过 docker run 命令启动容器，示例如下（以 Ubuntu 24.04 镜像为例）：

bash
docker run -it --rm intel/oneapi-runtime:ubuntu24.04 /bin/bash  

• -it：交互式终端
• --rm：容器退出后自动删除
• 如需运行 oneAPI 应用，可将应用文件挂载至容器内（如 -v /host/app:/container/app），并执行应用程序。

4.3 配置说明

根据应用需求，可通过以下方式自定义容器配置：

• 环境变量：设置运行时环境变量（如 OMP_NUM_THREADS 控制线程数），具体参数需参考应用文档。
• 挂载卷：通过 -v 参数挂载主机目录，实现应用文件或数据的持久化存储。

5. 许可协议

使用本容器及包含的软件前，需同意 https://github.com/intel/oneapi-containers/tree/master/licensing 的条款和条件。
容器源代码可通过 Container Sources 获取。

6. 注意事项

• Ubuntu 容器用途：所有 Ubuntu 基础镜像仅用于演示，不适用于生产环境。如需在生产中使用并获取 Canonical 提供的扩展安全维护，需参考 如何在 Dockerfile 中启用 Ubuntu Pro 并重新构建镜像。
• DPC++ Compatibility Tool：如需使用 Intel® DPC++ Compatibility Tool，需通过 Intel® oneAPI Base Toolkit 安装程序 获取。

更多容器、模型及资源可访问 Intel® oneContainer Portal。