文档范围与其他资料

本网站说明如何在 Web 控制台中选择资源、提交和排查任务，以及完成日常管理操作。RLark 项目资料提供部署、架构、API、SDK 和设备接入说明；RLinf 项目资料提供算法和 Hydra 配置。把这些资料用于具体环境前，先确认版本、权限、资源和安全流程与目标环境一致。

在本站完成控制台任务

需要在浏览器中完成以下操作时，从本站相应指南开始：

• 登录控制台并找到集群、节点、任务、工作流和存储；
• 准备 RLinf 任务，创建 Job，查看 Worker、日志和运行结果；
• 使用对象存储、文件浏览、SSH 和 WebTerminal；
• 管理节点调度和标签、网络域及存储类；
• 处理常见的登录、任务、Ray 和存储问题；
• 把 RLinf 工作负载映射为 RLark Job，并为真机任务核对安全条件。

RLark 为 RLinf 等训练程序提供运行所需的平台能力，包括计算资源选择、Worker 部署、Ray 启动、网络、存储和状态查看。算法和 Hydra 配置随 RLinf 工作负载提供；数据和模型通过镜像或存储挂载接入，训练输出写入任务指定的存储位置。

为当前环境准备输入和运行条件

创建 Job 前，需要分别确认两类信息：

• 工作负载要求：代码来源、镜像地址和版本、Hydra 配置、数据与模型版本、运行命令、checkpoint、输出位置和业务进展信号。这些信息通常可以从 RLinf 项目、镜像和配置中取得。
• 目标环境条件：可用集群、节点选择、资源、存储、网络和访问方式。在共享或托管环境中，请向平台管理员确认；自行部署者可以参考为训练任务确认运行条件。

真机任务还需要完成现场安全审批，并确认设备独占、动作限制、急停、断能和恢复流程。任务要求、环境条件和安全结果都确认后，再填写 Job。

使用与任务匹配的项目资料

下面的 RLark 链接指向源码仓库的 main 分支。排查或维护已部署环境时，请改用与该环境相同的 Git tag 或 commit。RLinf 工作负载也应固定自己的代码来源和 commit。

部署 RLark

选择要部署的 RLark 版本后，请使用该 Git tag 或 commit 中的中文部署指南。如果只是了解最新代码，可以查看 main 分支中的 RLark 部署指南（简体中文）；实际部署时，请先在 GitHub 中切换到选定版本。

安装完成后，按照安装结果提供的访问方式和初始登录信息打开控制台。供团队长期使用时，还需要按组织要求配置域名、TLS、网络入口和访问权限。

安装、升级、卸载和数据平面接入会改变平台运行状态。执行这些操作时，应使用目标发行版本附带且已经验证的资料，以及当前环境的运行手册。没有这些资料时，请联系平台负责人，不要仅凭 main 分支中的示例操作生产环境。

了解 RLark 技术架构

阅读 RLark 技术架构（简体中文），可以进一步了解控制面、数据平面、资源协调和跨集群网络。

使用 API 和自动化

按自动化目标选择对应资料：

你的目标	建议阅读	说明
查看 REST API 请求示例	API 调用样例（简体中文）	用于开发和已获授权的自动化接入。
调用存储接口	Storage API 说明（简体中文）	多集群存储类、文件操作和 PVC 挂载的接口说明。
获取可供工具读取的接口定义	OpenAPI 文件	机器可读的接口定义，不包含当前环境的访问地址、凭据或授权。

这些接口资料描述对应代码版本提供的能力。开始自动化前，还需要平台管理员提供匹配版本的地址、认证方式、授权范围和支持方式。具体要求见API 与 CLI。

准备 RLinf 工作负载

使用 RLinf 中文文档选择算法、模型、运行后端和 Hydra 配置，并准备代码、依赖、数据与运行命令。确认实际使用的版本和输入后，再按RLark 与 RLinf映射角色、资源、挂载和运行入口。

接入机器人和摄像头

按设备接口或开发语言选择对应资料：

你的目标	建议阅读	说明
查询 Worker 中的设备状态	embodied-runtime CLI 用法（简体中文）	rosctr、camctr 的参数和输出格式。执行命令前，先确认目标版本、当前环境是否向 Worker 提供 CLI 和 socket、Job 与 WebTerminal 权限，以及允许执行的命令范围。
部署并验证设备运行时	部署与使用样例（简体中文）	Helm、设备资源申请、直接设备挂载和控制器接入示例。内容包含部署及设备状态变更命令，只供获授权的平台维护和设备接入人员使用。
查看机器人和摄像头接口	embodied-runtime gRPC API（简体中文）	gRPC 服务、HTTP 网关和字段说明。
在 Python 程序中调用设备	Python SDK 源码用法（简体中文）	RobotClient 和 CameraClient 的源码用法；接入前，请从平台管理员或 SDK 维护者处取得经过确认的安装来源和目标版本。
在 Go 程序中调用设备	Go SDK 源码用法（简体中文）	gRPC stub 和连接辅助包的源码用法；接入前先确认模块来源和目标版本。

如果只是为任务选择设备，可以先在本站查看机器人和摄像头资源，确认 Node、设备资源名称和 Worker 中可见的设备 ID。需要使用 CLI、部署设备运行时或调用控制接口时，请先取得当前环境要求的 Job、WebTerminal、设备查询或设备操作权限，再使用上表中与目标版本一致的源码资料。

完成设备软件接入后，还需要按现场流程确认安全审批、设备独占、动作限制、急停和恢复条件。准备真机任务前，请先阅读使用真实设备前的安全要求。

遇到内容不一致时

先确认当前环境使用的 RLark 版本，再对照同一 Git tag 或 commit 中的源码和文档。如果控制台行为、源码资料和平台管理员提供的说明不一致，请停止相关操作，记录环境、页面、资源名称和发生时间，再请平台管理员确认。

项目资料可以用来了解对应版本的架构、API、SDK 和接入方式。执行实际部署、接入或运维操作前，请先取得当前环境的运行手册和平台管理员确认。