快速入门
整体开发流程
简介
为了方便后续的描述，我们对于不同的推理框架抽象为几个模块：
- 资源初始化模块。
- KV Cache管理模块。包括KV Cache的内存的创建，分配（PA场景）以及销毁。
- 模型推理模块。
- 资源释放模块。
本章节主要是介绍开发者如何在推理框架中使能LLM-DataDist的能力。
开发流程
- 找到推理框架中的资源初始化模块，在该阶段中调用LLM-DataDist的初始化接口和建链接口。
- 找到推理框架中的KV Cache管理模块，在该阶段中调用LLM-DataDist的KV Cache注册接口，LLM-DataDist的注册接口将自行申请的内存注册到LLM-DataDist。
- 推理框架需要拆分出Prefill阶段和Decode阶段，对推理脚本进行分离部署，部署到不同的集群节点上。在Decode阶段执行前需要接收来自Prefill阶段的输出作为输入，同时调用LLM-DataDist提供的KV Cache传输接口拉取或推送Prefill侧缓存的KV Cache。
- 分别执行Prefill推理脚本和Decode推理脚本。
- 在框架资源释放模块释放LLM-DataDist相关资源。
环境准备
支持的形态如下：
- Atlas A2 训练系列产品/Atlas A2 推理系列产品：针对Atlas A2 训练系列产品/Atlas A2 推理系列产品，仅支持Atlas 800I A2 推理服务器、A200I A2 Box 异构组件。该场景下Server内采用HCCS传输协议时，仅支持D2D。
- Atlas A3 训练系列产品/Atlas A3 推理系列产品，该场景下采用HCCS传输协议时，不支持Host内存作为远端Cache。
- Ascend 950PR/Ascend 950DT场景下，超节点内使用UB协议，超节点间使用RoCE协议。
请参考《CANN 软件安装》安装好驱动固件以及CANN软件。
使用hccn_tool查询Device IP，并且进行卡间网络检测，要求各个集群上的卡间有RDMA链路连接，否则无法使能LLM-DataDist能力。hccn_tool详细介绍请参考《HCCN Tool 接口参考》。以下是常用命令参考。
| 命令 | 使用场景 |
|---|---|
| hccn_tool [-i %d] -link -g | 获取指定Device网口Link状态。-i指定Device。样例：hccn_tool -i 0 -link -g |
| hccn_tool [-i %d] -ip -g | 获取IP地址和子网掩码。-i指定Device。样例：hccn_tool -i 0 -ip -g |
| hccn_tool [-i %d] -ping -g [address %s ] | 获取指定设备到目的地址的ping结果。-i指定当前server的某个Device， address指定ping的目的地址。样例：hccn_tool -i 0 -ping -g address 192.168.2.1 |
使用LLM-DataDist过程中，还涉及到如下环境变量，具体请参见《环境变量参考》。
| 名称 | 使用场景 |
|---|---|
| HCCL_RDMA_TC、HCCL_RDMA_SL | 当客户对参数面网络做了自己的规划时，对各种业务流量规定了类型，优先级。通过这两个环境变量设置参数面集合通信流量在网络上的流量类型和优先级，以适配客户网络流量规划的要求。 |
| HCCL_RDMA_RETRY_CNT、HCCL_RDMA_TIMEOUT | 分别对应RDMA硬件重试次数和重试超时时间。设置太大导致对网络异常反应不敏感，不能感知到网络故障。设置太小则容易造成网络闪断直接造成业务中断，不能被网卡硬件屏蔽。用户可根据自身网络情况设置合适的值。例如，可以根据大部分闪断的时间范围进行配置。推荐按照如下公式进行配置，以减少网络抖动带来的影响。HCCL_RDMA_TIMEOUT=log2(pull kv超时时间 * 10^6 / (HCCL_RDMA_RETRY_CNT + 1) / 4.096)，向上取整。当pull kv超时时间和HCCL_RDMA_RETRY_CNT都等于默认值时，HCCL_RDMA_TIMEOUT建议配置成15。 |
| HCCL_INTRA_ROCE_ENABLE | 用于配置Server内是否使用RoCE环路进行多卡间的通信。 |
| AUTO_USE_UC_MEMORY | 控制系统是否允许算子搬移数据不经过L2 Cache的功能。使用LLM-DataDist之前，如果没有配置该环境变量，使用LLM-DataDist过程中，会将其设置为0，表示所有算子搬移数据都必须经过L2 Cache。 |
完整样例参考
本示例是以transformers的LLAMA模型为样例，主要展示PD分离前后的脚本变化点，提供如何从非分离脚本改为PD分离脚本的一个参考，PD分离脚本示例请单击Gitee，根据版本配套表下载对应版本的sample包，从“npu_tuned_model/llm/llama/benchmark/pd_separate”目录中获取样例。样例中将全量模型和增量模型进行分离，部署到不同集群节点上执行。
如上分离脚本在整个推理流程中是如何被服务层调度的，请参考如下步骤。
- 当用户请求触发时，服务层将用户请求调度到全量的集群上，执行全量脚本的推理。将增量脚本需要的信息传输到增量脚本的执行节点上。此时全量集群节点可接收服务层下发的新的用户请求。
- 增量集群接收全量集群对应的请求信息，拉取对应请求的KV Cache（在全量集群节点上已经计算好的），同时按照增量模型的batch大小进行组batch操作，执行增量推理。
- 当增量集群上有请求推理完成空出对应batch位置时，再接收全量集群发过来的新的请求，并重复执行2和3。
- 全量集群重复执行1，增量集群重复执行2和3，直到业务结束，全量和增量集群退出。
更多代码样例，请单击Gitcode，选择配套版本，从“examples/python”目录中获取样例。