How starrocks/starrocks-kubernetes-operator works
This repository implements a Kubernetes operator for deploying and managing StarRocks clusters and warehouses. Users submit StarRocks custom resources; the operator reconciles them into Kubernetes workloads and services, tracks status, and supports scaling, upgrades, persistent volumes, FE/BE/CN separation, and warehouse-driven CN management. The README documents STREAM LOAD and autoscaling capabilities; the source index identifies related load and autoscaler modules, but their runtime wiring is not shown in the excerpts. Edges without direct excerpt or README support are omitted.
Main entry points: starrockscluster_controller.go Cluster reconciler · starrockswarehouse_controller.go Warehouse reconciler · be_controller.go BE controller · cn_controller.go CN controller
Components 19
Operator runtime
- Controller manager
cmd/main.go - Controller registration
pkg/controllers/controllers.go
Cluster API
- Cluster resource
pkg/apis/starrocks/v1/starrockscluster_types.go - Warehouse resource
pkg/apis/starrocks/v1/starrockswarehouse_types.go
Reconciliation
- Cluster reconciler
pkg/controllers/starrockscluster_controller.go - Warehouse reconciler
pkg/controllers/starrockswarehouse_controller.go
Workload management
- FE controller
pkg/subcontrollers/fe/fe_controller.go - BE controller
pkg/subcontrollers/be/be_controller.go - CN controller
pkg/subcontrollers/cn/cn_controller.go - FE proxy
pkg/subcontrollers/feproxy/feproxy_controller.go - Workload status
pkg/subcontrollers/subcontroller.go - Kubernetes resources
pkg/k8sutils/k8sutils.go - Service builder
pkg/common/resource_utils/service.go - Volume mounting
pkg/k8sutils/templates/pod/mount.go
Operational features
- CN autoscaling
pkg/common/resource_utils/autoscaler.go - STREAM LOAD support
pkg/k8sutils/load/load.go - FE SQL access
pkg/subcontrollers/cn/cn_mysql.go
Other components
- Cluster operator
- Kubernetes API
Connections 26
- Cluster operator → Kubernetes API: applies resources
README.md - Kubernetes API → Controller manager: watches resources
- Controller manager → Controller registration: sets up controllers
cmd/main.go - Controller registration → Cluster reconciler: registers
pkg/controllers/controllers.go - Controller registration → Warehouse reconciler: registers
pkg/controllers/controllers.go - Cluster reconciler → Cluster resource: reads and updates
pkg/controllers/starrockscluster_controller.go - Warehouse reconciler → Warehouse resource: reads and updates
pkg/controllers/starrockswarehouse_controller.go - Cluster reconciler → FE controller: reconciles FE
pkg/controllers/starrockscluster_controller.go - Cluster reconciler → BE controller: reconciles BE
pkg/controllers/starrockscluster_controller.go - Cluster reconciler → CN controller: reconciles CN
pkg/controllers/starrockscluster_controller.go - Cluster reconciler → FE proxy: reconciles proxy
pkg/controllers/starrockscluster_controller.go - Warehouse reconciler → CN controller: reconciles warehouse
pkg/controllers/starrockswarehouse_controller.go - FE controller → Kubernetes resources: applies workloads
- BE controller → Kubernetes resources: applies workloads
- CN controller → Kubernetes resources: applies workloads
- FE proxy → Kubernetes resources: applies deployment
pkg/subcontrollers/feproxy/feproxy_controller.go - BE controller → Service builder: builds service
pkg/subcontrollers/be/be_controller.go - FE controller → Workload status: updates status
- BE controller → Workload status: updates status
pkg/subcontrollers/be/be_controller.go - FE proxy → Workload status: updates status
pkg/subcontrollers/feproxy/feproxy_controller.go - Cluster reconciler → Kubernetes API: persists status
pkg/controllers/starrockscluster_controller.go - Warehouse reconciler → Kubernetes API: persists status
pkg/controllers/starrockswarehouse_controller.go - Volume mounting → Cluster resource: mounts configured volumes
README.md - CN autoscaling → Kubernetes API: manages scaling
- STREAM LOAD support → Kubernetes API: supports data loading
README.md - CN controller → FE SQL access: queries FE
pkg/subcontrollers/cn/cn_controller.go