DataSystem 可选部署

DataSystem 可选部署#

生产 Chart 默认部署 DataSystem。仅使用函数或实例的 direct invoke、且不需要对象存储、KV、stream、state 等能力时，可以关闭 DataSystem。

配置组合#

`global.dataSystem.enabled`	`global.dataSystem.bypass`	行为
`true`	`false`	默认；invoke 经过 DataSystem，DS API 可用
`true`	`true`	invoke 默认内联，DS API 仍可用
`false`	`true`	不部署 DataSystem，invoke 必须内联
`false`	`false`	非法，Helm 渲染失败

enabled 决定 DS API 是否可用；bypass 只决定 invoke 的默认传输路径。

安装或升级#

在已有安装参数后增加：

helm upgrade --install openyuanrong . \
  --namespace yr --create-namespace \
  --set global.dataSystem.enabled=false \
  --set global.dataSystem.bypass=true

Chart 会省略 DataSystem worker、端口和专用挂载，并向控制面和 Runtime 注入：

YR_DATASYSTEM_DEPLOYED=false
YR_BYPASS_DATASYSTEM=true

Python Driver 优先读取环境变量。off-cluster Driver 对缺失的部署能力通过 Frontend 发现；in-cluster 或进程模式 Driver 使用 DS 开启的兼容默认值，不向 FunctionProxy gRPC 地址发送 HTTP 请求。Config.bypass_datasystem 可显式覆盖默认 invoke 策略。旧 Frontend 返回 404 时使用兼容默认值，连接失败、超时、5xx 或响应无效时 yr.init() 快速失败。Runtime 不依赖 Frontend，使用 FunctionAgent/RuntimeManager 注入的环境变量。

检查#

确认没有 DataSystem Pod，其他组件均 Ready：

kubectl -n yr get pods
kubectl -n yr get pods -o name | grep -E 'ds-worker|datasystem'

第二条命令应无输出。检查 Runtime 环境：

kubectl -n yr exec <runtime-pod> -- env | grep -E 'YR_DATASYSTEM_DEPLOYED|YR_BYPASS_DATASYSTEM'

普通函数和实例 invoke 应返回 ObjectRefDirect。yr.get(ObjectRefDirect) 和 yr.wait 的 direct 路径可用。

限制与错误#

no-DS 模式不支持普通 ObjectRef get/wait、put、KV、stream、state/checkpoint、tensor/shared-memory、generator、ds:// 工作目录，以及把 ObjectRef 作为调用参数。Python SDK 应在 1 秒内返回 ERR_DATASYSTEM_FAILED，消息说明 DataSystem 已关闭及不可用操作。

内联请求和响应按方向分别限制为 100 MiB 的聚合序列化大小。等于上限允许发送，超过上限返回 ERR_PARAM_INVALID；序列化元数据计入总量，因此业务对象应预留空间。

回滚#

恢复默认模式：

helm upgrade openyuanrong . \
  --namespace yr \
  --set global.dataSystem.enabled=true \
  --set global.dataSystem.bypass=false

等待 DataSystem Pod Ready 后，再执行依赖 DS 的调用。