如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
OPAE nlb 示例应用镜像基于 Open Programmable Acceleration Engine (OPAE) 原生环回适配器(nlb)加速功能单元(AFU)构建,主要用于展示 Intel FPGA 设备插件功能及基于 OPAE 的 FPGA 编程方法。该镜像包含预编译的示例应用,可帮助用户快速理解 FPGA 设备在容器环境中的集成与使用方式。
4.2.1 本地容器运行
通过 docker run 命令启动容器,需挂载 FPGA 设备路径并配置设备访问权限:
bashdocker run --rm -it \ --device /dev/intel-fpga-port.0 \ # 挂载 FPGA 设备端口(根据实际设备调整) --device /dev/intel-fpga-fme.0 \ # 挂载 FPGA 管理设备(根据实际设备调整) -v /opt/opae/nlb:/opt/nlb \ # 挂载本地 AFU 配置文件(可选) intel/opae-nlb-samples:latest # 镜像名称(示例,需替换为实际镜像标签)
4.2.2 运行示例应用
容器启动后,可执行内置示例应用(如 nlb3、nlb0 等,具体取决于镜像版本):
bash# 运行 nlb3 环回测试应用 ./nlb3 --mode=loopback --iterations=1000
通过 Kubernetes Pod 部署示例应用,需指定 FPGA 设备资源:
yaml# fpga-nlb-sample.yaml apiVersion: v1 kind: Pod metadata: name: fpga-nlb-sample spec: containers: - name: nlb-app image: intel/opae-nlb-samples:latest command: ["./nlb3", "--mode=loopback", "--iterations=1000"] resources: limits: intel.com/fpga-arria10-nlb3: 1 # 请求 1 个 FPGA 设备(资源名称需与设备插件配置匹配)
部署命令:
bashkubectl apply -f fpga-nlb-sample.yaml
4.4.1 环境变量
| 环境变量名 | 说明 | 默认值 |
|---|---|---|
OPAE_LOG_LEVEL | OPAE 运行时日志级别(0-5) | 3(INFO) |
FPGA_DEVICE_ID | 指定 FPGA 设备 ID(多设备场景) | 自动发现第一个设备 |
AFU_IMAGE_PATH | AFU 镜像文件路径 | /opt/nlb/afu_image.gbs |
4.4.2 设备挂载
| 挂载路径 | 说明 | 必要性 |
|---|---|---|
/dev/intel-fpga-port.* | FPGA 端口设备文件 | 必需 |
/dev/intel-fpga-fme.* | FPGA 管理设备文件 | 必需 |
/opt/opae/nlb | 本地 AFU 配置/镜像文件目录 | 可选(自定义配置时) |
/dev/intel-fpga-port.0)需根据宿主环境实际设备调整,可通过 ls /dev/intel-fpga-* 查看。nlb3)可能因镜像版本而异,建议通过 ls / 查看容器内可执行文件。您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

来自真实用户的反馈,见证轩辕镜像的优质服务