DOCA 文档 v2.10.0

DOCA 概述

本文概述了 NVIDIA DOCA 文档的结构。它将引导您了解 DOCA 的开发者专区门户,其中包含关于 NVIDIA DOCA 工具包的所有信息,为您开发 NVIDIA® BlueField® 加速应用程序以及主机驱动程序提供所需的一切。

NVIDIA DOCA™ 框架支持在 BlueField 网络平台之上快速创建和管理应用程序及服务,并利用行业标准 API。借助 DOCA,开发者可以利用 NVIDIA BlueField 数据处理单元 (DPU) 和 SuperNIC 的强大功能,实现突破性的网络、安全和存储性能。在您的主机上安装 DOCA 将提供管理 NVIDIA® BlueField® 和 NVIDIA® ConnectX® 设备所需的所有驱动程序和工具。

image-2024-3-18_11-7-56-1-version-1-modificationdate-1734468288410-api-v2.png

DOCA 框架包括 DOCA-Host 软件包和用于 BlueField Arm 的 BlueField 软件包

  • BlueField 软件包 (BF-Bundle) 是安装在 BlueField Arm 核心上的软件包

  • DOCA-Host 是安装在主机服务器上的软件包,其中包括不同的 DOCA 安装配置文件

BlueField 软件包包括

  • 安装在 BlueField 平台之上的 DOCA 运行时驱动程序和库

  • 安装在 BlueField 平台上的操作系统

  • BlueField 平台软件(即固件和 UEFI 引导加载程序)

DOCA 为包含 NVIDIA 网络平台(即 BlueField 和 ConnectX)的主机提供所有必需的库和驱动程序,并提供专用的 DOCA-Host 软件包安装。

image-2024-3-18_11-20-56-1-version-1-modificationdate-1734468287777-api-v2.png

DOCA 包含运行时和开发环境,包括用于设备管理和可编程性的库和驱动程序,适用于主机以及作为 BlueField 平台软件的一部分。

image-2024-5-5_13-30-16-version-1-modificationdate-1734468287500-api-v2.png

DOCA 是 BlueField 主要硬件实体的软件基础设施

doca-as-software-framework-version-1-modificationdate-1734468290217-api-v2.png

主机和 BlueField 镜像的安装说明可在 DOCA Linux 安装指南中找到。

无论 DOCA 是安装在主机上还是 BlueField 网络平台上,都可以在 /opt/mellanox/doca 目录下找到不同的 DOCA 组件。这些组件包括传统的 SDK 相关组件(库、头文件等),以及 DOCA 示例、应用程序、工具等,如本文档所述。

DOCA SDK 构建于旨在利用 BlueField 功能的不同 DOCA 库之上。在编程指南部分,可以找到每个 DOCA 库的详细描述,包括其目标和 API。这些指南记录了 DOCA 的 API,旨在帮助开发基于 DOCA 的程序。

API 参考部分包含 DOCA 官方 API 的 Doxygen 生成文档。

DOCA 编程指南提供了 DOCA 库及其 API 的完整视图。每个指南都包括简介、架构、API 概述和其他特定于库的信息。

每个库的编程指南都包含用于实现基本 DOCA 任务的代码片段。建议在阅读相关 DOCA 库的编程指南时查看这些示例,以了解其 API。这些示例提供了给定 DOCA 库的单个功能的实现示例。

有关使用多个 DOCA 库的完整 DOCA 程序更详细的参考,请参阅参考应用程序

应用程序是比示例更高级别的参考代码,并演示了如何构建完整的基于 DOCA 的程序。除了提供的源代码和编译定义之外,应用程序还以编译后的二进制形式发布。这是为了让用户能够开箱即用地与基于 DOCA 的程序进行交互,而无需面向开发者的编译过程的麻烦。

许多 DOCA 应用程序结合了多个 DOCA 库的功能,并为用户感兴趣的常见场景提供了示例实现,例如根据传入/传出流量进行应用程序识别、使用硬件 RegEx 加速扫描文件等等。

有关 DOCA 应用程序的更多信息,请参阅DOCA 参考应用程序

一些 DOCA 库附带了用于运行时和开发的辅助工具。这些工具通常是库自身 API 的扩展,并弥合了库的预期输入格式与用户可用的输入之间的差距。

有关 DOCA 工具的更多信息,请参阅DOCA 工具

DOCA 服务是容器化的基于 DOCA 的程序,为给定的用例提供端到端解决方案。DOCA 服务可以从 NVIDIA 的容器目录 (NGC) 访问,从中可以轻松地直接部署到 BlueField,有时也可以部署到主机。

有关基于容器部署到 BlueField 平台的更多信息,请参阅DOCA 容器部署指南

有关 DOCA 服务的更多信息,请参阅DOCA 服务

信息

如有问题、意见和反馈,请通过 DOCA-Feedback@exchange.nvidia.com 联系我们。

© 版权所有 2025, NVIDIA。 上次更新于 2025 年 2 月 12 日。