大网数据广告活动
数据库部署与 SQL 参考

Doris Operator 总体架构

· 52CE 我爱测

Doris Operator 遵循标准的 Kubernetes Operator 设计模式。用户通过 CRD 声明期望状态,Operator 持续观察实际状态,并通过创建、更新或删除 Kubernetes 资源来收敛差异。

Doris Operator 遵循标准的 Kubernetes Operator 设计模式。用户通过 CRD 声明期望状态,Operator 持续观察实际状态,并通过创建、更新或删除 Kubernetes 资源来收敛差异。

本文聚焦整体架构。字段配置和部署步骤请参考对应的安装和配置文档。

架构分层

Doris Operator 可以分为控制面和数据面两层。

[图示请参阅官方原文]

控制面负责读取 Doris 自定义资源并执行 Reconcile 流程;数据面由实际运行 Doris 组件的 Kubernetes 原生资源组成。

Reconcile 模型

Reconcile 循环是 Doris Operator 的核心。每当用户创建或修改 Doris 自定义资源,或者相关资源状态变化时,Operator 都会重新计算期望状态与实际状态的差异,并执行必要操作。

典型流程如下:

  1. 读取 Doris 自定义资源。
  2. 判断资源是否正在删除。
  3. 解析组件、存储、认证和访问配置。
  4. 创建或更新对应的 StatefulSet、Service、PVC 等资源。
  5. 汇总组件状态并写回 CR status。
  6. 如果集群尚未就绪,则等待下一轮 Reconcile。

[图示请参阅官方原文]

存算一体控制链路

DorisCluster 用于存算一体部署。一个资源通常包含 FE、BE、CN、Broker 等组件配置。

[图示请参阅官方原文]

在这条链路里,主 Reconciler 负责读取 CR、组织组件执行顺序、清理无效资源并汇总状态;组件控制器负责各自组件的资源创建和状态检查。

存算分离控制链路

DorisDisaggregatedCluster 用于存算分离部署。一个资源中包含 MetaService、FE 和一个或多个 ComputeGroup。

[图示请参阅官方原文]

与存算一体相比,这条链路会涉及更多 Doris 元数据层动作。例如缩容 ComputeGroup 时,Operator 可能需要先执行 decommission 或 drop,再更新 Kubernetes 资源。

Webhook 与校验

Doris Operator 可以选择启用 Webhook,在配置进入 Reconcile 流程之前做默认值填充和基础校验。

常见校验包括:

  • FE 副本数与选举相关配置是否兼容。
  • 资源字段格式是否满足 CRD 约束。
  • 组件配置是否符合 Operator 支持的模型。

是否启用 Webhook 取决于部署方式和环境配置。即使未启用,CRD schema 校验和 Reconcile 状态反馈仍然提供基础约束。

状态汇总

Operator 不只负责创建资源,也会把组件状态写回 Doris 自定义资源。你可以通过 kubectl get 或 kubectl describe 判断组件是否可用、是否在扩缩容、是否等待调度,或者是否存在失败实例。

存算一体集群按 FE、BE、CN、Broker 汇总状态;存算分离集群按 MetaService、FE、ComputeGroup 汇总状态,并额外提供整体健康度。

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。