How elastic/cloud-on-k8s works
ECK is a Kubernetes operator for deploying and managing Elastic products. Users submit custom resources to the Kubernetes API; the operator manager registers controllers that reconcile those resources and related configuration into Kubernetes workloads and supporting resources. Elasticsearch has additional cluster lifecycle, certificate, and autoscaling behavior; other controllers cover the product families and cross-cutting policies. The README documents the broader supported product set and capabilities. Relationships for sampled controllers are cited where visible; unsampled controller behavior is represented by its source path without inferred internal links.
Main entry points: main.go Controller manager · elasticsearch_controller.go Elasticsearch reconcile · remotecluster/controller.go Remote clusters · stackconfigpolicy/controller.go Stack configuration policy
Components 26
Operator runtime
- Operator CLI
cmd/main.go - Controller manager
cmd/manager/main.go - Elasticsearch resource
pkg/apis/elasticsearch/v1/elasticsearch_types.go - APM resource
pkg/apis/apm/v1/apmserver_types.go - Enterprise Search resource
pkg/apis/enterprisesearch/v1/enterprisesearch_types.go - Maps resource
pkg/apis/maps/v1alpha1/maps_types.go
Product controllers
- APM controller
pkg/controller/apmserver/controller.go - Enterprise Search controller
pkg/controller/enterprisesearch/enterprisesearch_controller.go - Kibana controller
pkg/controller/kibana/controller.go - Beats controllers
pkg/controller/beat/controller.go - Agent controller
pkg/controller/agent/controller.go - Logstash pipeline config
pkg/controller/logstash/pipeline.go - Maps controller
pkg/controller/maps/controller.go - Package Registry controller
pkg/controller/packageregistry/controller.go - AutoOps controller
pkg/controller/autoops/controller.go
Cluster lifecycle
- Elasticsearch reconcile
pkg/controller/elasticsearch/elasticsearch_controller.go - Cluster driver
pkg/controller/elasticsearch/driver/stateful/driver.go - Cluster certificates
pkg/controller/elasticsearch/certificates/transport/reconcile.go - Autoscaling recommender
pkg/controller/autoscaling/elasticsearch/autoscaler/recommender/storage.go - Kubernetes workloads
pkg/controller/common/statefulset/reconcile.go
Policies and integrations
- Associations
pkg/controller/association/controller.go - Remote clusters
pkg/controller/remotecluster/controller.go - Stack configuration policy
pkg/controller/stackconfigpolicy/controller.go - License management
pkg/controller/license/license_controller.go
Other components
- Cluster operator
- Kubernetes API
Connections 42
- Cluster operator → Kubernetes API: submits resources
- Operator CLI → Controller manager: starts
cmd/main.go - Controller manager → Kubernetes API: watches resources
- Controller manager → Elasticsearch reconcile: registers
cmd/manager/main.go - Controller manager → APM controller: registers
cmd/manager/main.go - Controller manager → Enterprise Search controller: registers
cmd/manager/main.go - Controller manager → Kibana controller: registers
- Controller manager → Beats controllers: registers
- Controller manager → Agent controller: registers
- Controller manager → Maps controller: registers
cmd/manager/main.go - Controller manager → Package Registry controller: registers
cmd/manager/main.go - Controller manager → AutoOps controller: registers
cmd/manager/main.go - Controller manager → Associations: registers
- Controller manager → Remote clusters: registers
- Controller manager → Stack configuration policy: registers
- Controller manager → License management: registers
- Cluster operator → Elasticsearch resource: defines
- Cluster operator → APM resource: defines
- Cluster operator → Enterprise Search resource: defines
- Cluster operator → Maps resource: defines
- Elasticsearch resource → Kubernetes API: stored as
- APM resource → Kubernetes API: stored as
- Enterprise Search resource → Kubernetes API: stored as
- Maps resource → Kubernetes API: stored as
- Elasticsearch reconcile → Kubernetes API: reads resource
pkg/controller/elasticsearch/elasticsearch_controller.go - Maps controller → Kubernetes API: reads resource
pkg/controller/maps/controller.go - Remote clusters → Kubernetes API: reads clusters
pkg/controller/remotecluster/controller.go - Stack configuration policy → Kubernetes API: reads policy
pkg/controller/stackconfigpolicy/controller.go - Elasticsearch reconcile → Elasticsearch resource: validates
- Elasticsearch reconcile → Cluster driver: delegates
- Elasticsearch reconcile → Kubernetes workloads: reconciles
- Elasticsearch reconcile → Cluster certificates: manages certificates
- Autoscaling recommender → Kubernetes workloads: recommends capacity
- APM controller → Kubernetes API: reconciles resources
- Enterprise Search controller → Kubernetes API: reconciles resources
- Package Registry controller → Kubernetes API: reconciles resources
- AutoOps controller → Kubernetes API: reconciles resources
- Logstash pipeline config → Kubernetes API: writes pipeline Secret
pkg/controller/logstash/pipeline.go - Associations → Kubernetes API: manages associations
- Remote clusters → Kubernetes API: manages remote access
pkg/controller/remotecluster/controller.go - Stack configuration policy → Kubernetes API: manages config Secrets
pkg/controller/stackconfigpolicy/controller.go - License management → Kubernetes API: checks license