# elastic/cloud-on-k8s architecture

> Architecture diagram of the GitHub repository elastic/cloud-on-k8s, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/elastic/cloud-on-k8s
- Repository: https://github.com/elastic/cloud-on-k8s

## Overview

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: [`cmd/manager/main.go`](https://github.com/elastic/cloud-on-k8s/blob/main/cmd/manager/main.go) (Controller manager), [`pkg/controller/elasticsearch/elasticsearch_controller.go`](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/elasticsearch/elasticsearch_controller.go) (Elasticsearch reconcile), [`pkg/controller/remotecluster/controller.go`](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/remotecluster/controller.go) (Remote clusters), [`pkg/controller/stackconfigpolicy/controller.go`](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/stackconfigpolicy/controller.go) (Stack configuration policy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Operator runtime"]
  node_entry["Operator CLI<br/>[main.go]"]
  node_manager["Controller manager<br/>[main.go]"]
  node_esapi["Elasticsearch resource"]
  node_apmapi["APM resource<br/>[apmserver_types.go]"]
  node_entapi["Enterprise Search resource"]
  node_mapsapi["Maps resource<br/>[maps_types.go]"]
end

subgraph group_products["Product controllers"]
  node_apm["APM controller<br/>[controller.go]"]
  node_enterprise["Enterprise Search controller"]
  node_kibana["Kibana controller<br/>[controller.go]"]
  node_beats["Beats controllers<br/>[controller.go]"]
  node_agent["Agent controller<br/>[controller.go]"]
  node_logstash["Logstash pipeline config<br/>[pipeline.go]"]
  node_maps["Maps controller<br/>[controller.go]"]
  node_packageregistry["Package Registry controller<br/>[controller.go]"]
  node_autoops["AutoOps controller<br/>[controller.go]"]
end

subgraph group_cluster["Cluster lifecycle"]
  node_elasticsearch["Elasticsearch reconcile"]
  node_esdriver["Cluster driver<br/>[driver.go]"]
  node_escerts["Cluster certificates<br/>[reconcile.go]"]
  node_autoscale["Autoscaling recommender<br/>[storage.go]"]
  node_workloads["Kubernetes workloads<br/>[reconcile.go]"]
end

subgraph group_policy["Policies and integrations"]
  node_associations["Associations<br/>[controller.go]"]
  node_remote["Remote clusters<br/>[controller.go]"]
  node_stackpolicy["Stack configuration policy<br/>[controller.go]"]
  node_license["License management"]
end

node_user(("Cluster operator"))
node_kubeapi[("Kubernetes API")]

node_user -->|"submits resources"| node_kubeapi
node_entry -->|"starts"| node_manager
node_manager -.->|"watches resources"| node_kubeapi
node_manager -->|"registers"| node_elasticsearch
node_manager -->|"registers"| node_apm
node_manager -->|"registers"| node_enterprise
node_manager -.->|"registers"| node_kibana
node_manager -.->|"registers"| node_beats
node_manager -.->|"registers"| node_agent
node_manager -->|"registers"| node_maps
node_manager -->|"registers"| node_packageregistry
node_manager -->|"registers"| node_autoops
node_manager -.->|"registers"| node_associations
node_manager -.->|"registers"| node_remote
node_manager -.->|"registers"| node_stackpolicy
node_manager -.->|"registers"| node_license
node_user -->|"defines"| node_esapi
node_user -->|"defines"| node_apmapi
node_user -->|"defines"| node_entapi
node_user -->|"defines"| node_mapsapi
node_esapi -.->|"stored as"| node_kubeapi
node_apmapi -.->|"stored as"| node_kubeapi
node_entapi -.->|"stored as"| node_kubeapi
node_mapsapi -.->|"stored as"| node_kubeapi
node_elasticsearch -->|"reads resource"| node_kubeapi
node_maps -->|"reads resource"| node_kubeapi
node_remote -->|"reads clusters"| node_kubeapi
node_stackpolicy -->|"reads policy"| node_kubeapi
node_elasticsearch -.->|"validates"| node_esapi
node_elasticsearch -.->|"delegates"| node_esdriver
node_elasticsearch -.->|"reconciles"| node_workloads
node_elasticsearch -.->|"manages certificates"| node_escerts
node_autoscale -.->|"recommends capacity"| node_workloads
node_apm -.->|"reconciles resources"| node_kubeapi
node_enterprise -.->|"reconciles resources"| node_kubeapi
node_packageregistry -.->|"reconciles resources"| node_kubeapi
node_autoops -.->|"reconciles resources"| node_kubeapi
node_logstash -->|"writes pipeline Secret"| node_kubeapi
node_associations -.->|"manages associations"| node_kubeapi
node_remote -->|"manages remote access"| node_kubeapi
node_stackpolicy -->|"manages config Secrets"| node_kubeapi
node_license -.->|"checks license"| node_kubeapi

click node_entry "https://github.com/elastic/cloud-on-k8s/blob/main/cmd/main.go"
click node_manager "https://github.com/elastic/cloud-on-k8s/blob/main/cmd/manager/main.go"
click node_esapi "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/apis/elasticsearch/v1/elasticsearch_types.go"
click node_apmapi "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/apis/apm/v1/apmserver_types.go"
click node_entapi "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/apis/enterprisesearch/v1/enterprisesearch_types.go"
click node_mapsapi "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/apis/maps/v1alpha1/maps_types.go"
click node_elasticsearch "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/elasticsearch/elasticsearch_controller.go"
click node_esdriver "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/elasticsearch/driver/stateful/driver.go"
click node_escerts "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/elasticsearch/certificates/transport/reconcile.go"
click node_autoscale "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/autoscaling/elasticsearch/autoscaler/recommender/storage.go"
click node_apm "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/apmserver/controller.go"
click node_enterprise "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/enterprisesearch/enterprisesearch_controller.go"
click node_kibana "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/kibana/controller.go"
click node_beats "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/beat/controller.go"
click node_agent "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/agent/controller.go"
click node_logstash "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/logstash/pipeline.go"
click node_maps "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/maps/controller.go"
click node_packageregistry "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/packageregistry/controller.go"
click node_autoops "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/autoops/controller.go"
click node_associations "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/association/controller.go"
click node_remote "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/remotecluster/controller.go"
click node_stackpolicy "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/stackconfigpolicy/controller.go"
click node_license "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/license/license_controller.go"
click node_workloads "https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/common/statefulset/reconcile.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_manager,node_esapi,node_apmapi,node_entapi,node_mapsapi toneBlue
class node_apm,node_enterprise,node_kibana,node_beats,node_agent,node_logstash,node_maps,node_packageregistry,node_autoops,node_kubeapi toneAmber
class node_elasticsearch,node_esdriver,node_escerts,node_autoscale,node_workloads toneMint
class node_associations,node_remote,node_stackpolicy,node_license toneRose
class node_user toneIndigo
```

## Components

### Operator runtime

- [Operator CLI](https://github.com/elastic/cloud-on-k8s/blob/main/cmd/main.go): `cmd/main.go`
- [Controller manager](https://github.com/elastic/cloud-on-k8s/blob/main/cmd/manager/main.go): `cmd/manager/main.go`
- [Elasticsearch resource](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/apis/elasticsearch/v1/elasticsearch_types.go): `pkg/apis/elasticsearch/v1/elasticsearch_types.go`
- [APM resource](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/apis/apm/v1/apmserver_types.go): `pkg/apis/apm/v1/apmserver_types.go`
- [Enterprise Search resource](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/apis/enterprisesearch/v1/enterprisesearch_types.go): `pkg/apis/enterprisesearch/v1/enterprisesearch_types.go`
- [Maps resource](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/apis/maps/v1alpha1/maps_types.go): `pkg/apis/maps/v1alpha1/maps_types.go`

### Product controllers

- [APM controller](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/apmserver/controller.go): `pkg/controller/apmserver/controller.go`
- [Enterprise Search controller](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/enterprisesearch/enterprisesearch_controller.go): `pkg/controller/enterprisesearch/enterprisesearch_controller.go`
- [Kibana controller](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/kibana/controller.go): `pkg/controller/kibana/controller.go`
- [Beats controllers](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/beat/controller.go): `pkg/controller/beat/controller.go`
- [Agent controller](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/agent/controller.go): `pkg/controller/agent/controller.go`
- [Logstash pipeline config](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/logstash/pipeline.go): `pkg/controller/logstash/pipeline.go`
- [Maps controller](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/maps/controller.go): `pkg/controller/maps/controller.go`
- [Package Registry controller](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/packageregistry/controller.go): `pkg/controller/packageregistry/controller.go`
- [AutoOps controller](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/autoops/controller.go): `pkg/controller/autoops/controller.go`

### Cluster lifecycle

- [Elasticsearch reconcile](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/elasticsearch/elasticsearch_controller.go): `pkg/controller/elasticsearch/elasticsearch_controller.go`
- [Cluster driver](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/elasticsearch/driver/stateful/driver.go): `pkg/controller/elasticsearch/driver/stateful/driver.go`
- [Cluster certificates](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/elasticsearch/certificates/transport/reconcile.go): `pkg/controller/elasticsearch/certificates/transport/reconcile.go`
- [Autoscaling recommender](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/autoscaling/elasticsearch/autoscaler/recommender/storage.go): `pkg/controller/autoscaling/elasticsearch/autoscaler/recommender/storage.go`
- [Kubernetes workloads](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/common/statefulset/reconcile.go): `pkg/controller/common/statefulset/reconcile.go`

### Policies and integrations

- [Associations](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/association/controller.go): `pkg/controller/association/controller.go`
- [Remote clusters](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/remotecluster/controller.go): `pkg/controller/remotecluster/controller.go`
- [Stack configuration policy](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/stackconfigpolicy/controller.go): `pkg/controller/stackconfigpolicy/controller.go`
- [License management](https://github.com/elastic/cloud-on-k8s/blob/main/pkg/controller/license/license_controller.go): `pkg/controller/license/license_controller.go`

### Other components

- **Cluster operator**
- **Kubernetes API**

## Connections

- Cluster operator → Kubernetes API: submits resources
- Operator CLI → Controller manager: starts (evidence: `cmd/main.go`)
- Controller manager → Kubernetes API: watches resources
- Controller manager → Elasticsearch reconcile: registers (evidence: `cmd/manager/main.go`)
- Controller manager → APM controller: registers (evidence: `cmd/manager/main.go`)
- Controller manager → Enterprise Search controller: registers (evidence: `cmd/manager/main.go`)
- Controller manager → Kibana controller: registers
- Controller manager → Beats controllers: registers
- Controller manager → Agent controller: registers
- Controller manager → Maps controller: registers (evidence: `cmd/manager/main.go`)
- Controller manager → Package Registry controller: registers (evidence: `cmd/manager/main.go`)
- Controller manager → AutoOps controller: registers (evidence: `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 (evidence: `pkg/controller/elasticsearch/elasticsearch_controller.go`)
- Maps controller → Kubernetes API: reads resource (evidence: `pkg/controller/maps/controller.go`)
- Remote clusters → Kubernetes API: reads clusters (evidence: `pkg/controller/remotecluster/controller.go`)
- Stack configuration policy → Kubernetes API: reads policy (evidence: `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 (evidence: `pkg/controller/logstash/pipeline.go`)
- Associations → Kubernetes API: manages associations
- Remote clusters → Kubernetes API: manages remote access (evidence: `pkg/controller/remotecluster/controller.go`)
- Stack configuration policy → Kubernetes API: manages config Secrets (evidence: `pkg/controller/stackconfigpolicy/controller.go`)
- License management → Kubernetes API: checks license
