术语表

A

Addon（附加组件）

安装到数据平面并由 RLark 记录期望版本与安装状态的组件。

Agent

运行在数据平面的 RLark 组件，负责同步节点、Task、工作负载和网络等状态。Node 的接入形态可为 Kubernetes、Docker 或 Raw。

B

Bucket（存储桶）

对象存储中的顶层数据容器。对象通过 Bucket 内的完整对象键标识。

C

Cluster（集群）

已接入 RLark 的数据平面环境。控制台把连接信息、节点和存储汇总为集群视图；Cluster 不是同名的 RLark CRD。

Control Plane（控制面）

承载 Server、Gateway、Controller Manager 和 Web UI 的平台侧组件集合，保存期望状态并协调数据平面。

D

Data Plane（数据平面）

实际运行训练、评测或设备工作负载的集群与节点。

Domain

集群级资源，表示安全与网络边界。Job 指定 Domain，Task 从 Job 继承该值。

DomainPeer

把同一 Domain 的 Pod 路由和证书信息同步到一个数据平面的命名空间级资源，主要由平台网络组件管理。它不是两个 Domain 之间的用户可配置对等关系。

H

Header 角色 / Head Task

Header 角色是控制台中的选择，用于指定承载公共运行脚本和 Ray Head 职责的角色。提交后，该角色对应 head: true 的 Head Task。两者都不是具体 Node，也不是运行时自动选出的第一个 Worker；界面中的“选择 Head 节点”实际仍在选择角色。Head Task 的每个 Pod 都会运行 Head 包装脚本和运行脚本，因此该 Task 必须只有 1 个副本。只有引用界面原文时才使用 Header Worker 等页面标签。

hostPath

把数据面节点本地目录挂载到 Pod 的 Kubernetes 卷类型。它不提供跨节点共享语义。

J

Job（作业/训练任务）

集群级资源，描述一次作业的 Domain、停止标志和 Task 模板。控制台部分页面使用“任务”作为用户可见名称。

N

Node（节点）

命名空间级资源，描述数据平面计算节点的接入形态、在线状态、可调度性、资源和系统信息。

nodeSelector（节点选择器）

Task 中用于匹配 Node 标签的键值条件。RLark 还会使用匹配结果确定 Task 所在命名空间。匹配不到节点、选择器为空或跨集群命中时，工作负载可能无法落到预期数据平面。提交任务时只使用由不同标签键组成的单值条件，并确认完整匹配结果只属于预期集群。

O

Object / Object Key（对象/对象键）

对象存储中的数据及其完整标识。文件浏览器显示的“目录”通常只是对象键的公共前缀。

P

Pod

数据面中的 Kubernetes 运行实例。RLark Pod 资源记录其名称、节点、IP 和阶段等最近上报状态。

PVC（PersistentVolumeClaim）

Kubernetes 持久卷声明。创建任务时，RLark 会根据对象存储挂载自动创建 PVC，并通过它把 StorageClass 挂载到容器路径；普通用户不需要自行创建 PVC。

R

Role（角色）

作业创建器中用于组织 Worker 配置的逻辑分组。Task API 的角色语义为 Actor、Rollout 或 Env。

S

StorageClass

Kubernetes 集群级存储类。可以把它理解为管理员为集群准备的存储连接名称。RLark 的对象存储配置会在关联集群中创建同名的 rclone CSI StorageClass，并由 Task 的 PVC 引用。StorageClass 不是 Bucket 内的目录，也不表示 Bucket 容量。

T

Task

由 Job 模板生成的命名空间级执行单元，包含角色、Agent 类型、节点选择、工作负载、脚本和存储映射。

TensorBoard Proxy

Gateway 为 Task 计算的相对代理入口，用于访问对应工作负载的 6006 端口。是否可用取决于 Task 和服务实际状态。

V

volumeMount（容器挂载路径）

把卷放到 Worker 容器中的指定路径。创建向导中的挂载到 Worker填写的就是这个路径；训练程序通过它读写数据。它与节点上的源路径、Bucket 名称和对象键不是同一个值。

W

WebTerminal

控制台在 Job 详情中为已有 Pod 提供的终端弹窗，可用于运行时检查和文件传输。它不是独立页面。

Worker

控制台对一个运行实例的用户视图，通常对应 Task 下的 Pod。Worker 不是 RLark CRD。

Worker Group（旧术语）

旧平台用于分组 Worker 的模型。RLark API 不使用该对象；迁移时应改写为 Job 的 Task 模板、角色、节点选择和副本。

Workflow（工作流）

集群级 DAG 资源，由多个带依赖关系的 Job 模板组成。