LACT项目JSON API接口详解与使用指南

最新推荐文章于 2025-06-24 09:28:44 发布

纪嫣梦

最新推荐文章于 2025-06-24 09:28:44 发布

阅读量439

点赞数 10

CC 4.0 BY-SA版权

本文链接：https://blog.csdn.net/gitblog_00643/article/details/148863905

LACT项目JSON API接口详解与使用指南

概述

LACT项目提供了一个基于JSON的API接口，通过Unix域套接字或TCP连接实现对GPU设备的配置管理。本文将详细介绍该API的设计原理、使用方法以及实际应用场景。

API基础架构

通信机制

LACT守护进程(LACT Daemon)提供了两种通信方式：

Unix域套接字：默认路径为/run/lactd.sock
TCP连接：出于安全考虑默认禁用，需要手动配置启用

安全配置

访问控制通过配置文件/etc/lact/config.yaml实现，管理员可以通过设置daemon.admin_group或daemon.admin_user字段来限制访问权限。

协议格式

请求格式

API采用换行符分隔的JSON对象作为请求格式，基本结构如下：

{
  "command": "命令名称",
  "args": {
    // 命令参数(可选)
  }
}

响应格式

所有响应都遵循统一格式：

{
  "status": "ok|error",
  "data": {
    // 响应数据(可选)
  }
}

快速体验

可以使用ncat工具快速测试API：

echo '{"command": "list_devices"}' | ncat -U /run/lactd.sock

典型响应示例：

{
  "status": "ok",
  "data": [
    {
      "id": "1002:687F-1043:0555-0000:0b:00.0",
      "name": "Vega 10 XL/XT [Radeon RX Vega 56/64]"
    }
  ]
}

核心API命令

配置管理最佳实践

LACT推荐使用get_gpu_config和set_gpu_config这一对命令进行配置管理，它们采用与项目配置文件相同的结构，但使用JSON格式而非YAML。

配置修改流程

获取当前配置：首先获取设备的完整配置
修改配置：在本地修改需要的参数
提交新配置：将修改后的配置发送回服务端
确认更改：必须显式确认更改，否则配置将在5秒后自动回滚

这种设计可以有效防止因错误配置导致系统崩溃的情况。

实际操作示例：调整功率限制

获取设备ID

echo '{"command": "list_devices"}' | nc -U /run/lactd.sock

获取当前配置

echo '{"command": "get_gpu_config", "args": {"id": "10DE:2704-1462:5110-0000:09:00.0"}}' | nc -U /run/lactd.sock

设置新配置

echo '{"command": "set_gpu_config", "args": {"id": "10DE:2704-1462:5110-0000:09:00.0", "config": {...修改后的配置...}}}' | nc -U /run/lactd.sock

确认更改

echo '{"command": "confirm_pending_config", "args": {"command": "confirm"}}' | nc -U /run/lactd.sock

错误处理

API提供了详细的错误信息，例如：

echo '{"command": "test"}' | ncat -U /run/lactd.sock

响应将明确指示错误原因：

{
  "status": "error",
  "data": "Failed to deserialize request: unknown variant `test`, expected one of `ping`, `list_devices`, `system_info`, `device_info`, `device_stats`, `device_clocks_info`, `set_fan_control`, `set_power_cap`, `set_performance_level`, `set_clocks_value` at line 1 column 18"
}