# zecke/kubernetes architecture

> Architecture diagram of the GitHub repository zecke/kubernetes, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zecke/kubernetes
- Repository: https://github.com/zecke/kubernetes

## Overview

Kubernetes manages containerized applications across a cluster. The main workflow is to submit desired resources through the API, persist and reconcile cluster state through control loops, schedule work, and have node agents run containers and report status; services and the node proxy provide stable networking. The graph includes major controllers and runtime layers identified by the source index. Edges reflect shown calls, imports, or README descriptions; unsampled internals and some controller wiring limit the detail of the flow.

Main entry points: [`cmd/kube-apiserver/app/server.go`](https://github.com/zecke/kubernetes/blob/master/cmd/kube-apiserver/app/server.go) (API server), [`cmd/kube-controller-manager/app/controllermanager.go`](https://github.com/zecke/kubernetes/blob/master/cmd/kube-controller-manager/app/controllermanager.go) (Controller manager), [`cmd/kubelet/app/server.go`](https://github.com/zecke/kubernetes/blob/master/cmd/kubelet/app/server.go) (Kubelet server), [`pkg/controller/node/nodecontroller.go`](https://github.com/zecke/kubernetes/blob/master/pkg/controller/node/nodecontroller.go) (Node controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and storage"]
  node_apiserver["API server<br/>[server.go]"]
  node_rest["REST handlers<br/>[resthandler.go]"]
  node_etcd[("etcd storage<br/>[storage_factory.go]")]
  node_master["Master controllers<br/>[controller.go]"]
end

subgraph group_control["Control loops"]
  node_cm["Controller manager"]
  node_replication["Replication controller"]
  node_daemon["Daemon controller<br/>[controller.go]"]
  node_nodecontroller["Node controller<br/>[nodecontroller.go]"]
  node_pv["Volume provisioner"]
  node_servicecontroller["Service controller"]
  node_scheduler["Scheduler<br/>[server.go]"]
end

subgraph group_node["Node runtime"]
  node_kubelet["Kubelet server<br/>[server.go]"]
  node_docker["Container manager<br/>[manager.go]"]
  node_cgroups["Resource manager"]
  node_status["Pod status manager<br/>[manager.go]"]
end

subgraph group_network["Service networking"]
  node_proxy["Node proxy<br/>[server.go]"]
end

subgraph group_mesos["Mesos integration"]
  node_endpoints["Endpoint controller"]
  node_mesoscm["Mesos controller manager"]
end

node_operator(("Cluster user"))
node_kubectl["kubectl client<br/>[service.go]"]
node_cloud["Cloud provider"]
node_runtime["Container runtime"]

node_operator -->|"manages workloads"| node_kubectl
node_kubectl -.->|"submits API requests"| node_apiserver
node_apiserver -->|"serves REST"| node_rest
node_apiserver -->|"configures storage"| node_etcd
node_apiserver -.->|"starts controllers"| node_master
node_master -.->|"stores cluster state"| node_etcd
node_cm -->|"starts controller"| node_replication
node_cm -->|"wires controller"| node_daemon
node_cm -->|"starts controller"| node_nodecontroller
node_cm -->|"starts provisioner"| node_pv
node_cm -->|"starts controller"| node_servicecontroller
node_replication -->|"reconciles via API"| node_apiserver
node_daemon -->|"reconciles via API"| node_apiserver
node_nodecontroller -->|"updates cluster"| node_apiserver
node_nodecontroller -->|"syncs instances"| node_cloud
node_pv -->|"provisions volumes"| node_apiserver
node_servicecontroller -->|"manages load balancers"| node_cloud
node_scheduler -->|"reads cluster state"| node_apiserver
node_kubelet -->|"configures runtime"| node_docker
node_kubelet -.->|"sets resources"| node_cgroups
node_kubelet -.->|"reports pod status"| node_status
node_docker -->|"manages containers"| node_runtime
node_kubelet -.->|"syncs cluster state"| node_apiserver
node_proxy -->|"watches services"| node_apiserver
node_proxy -.->|"forwards traffic"| node_runtime
node_mesoscm -->|"starts controller"| node_endpoints
node_endpoints -->|"writes endpoints"| node_apiserver

click node_kubectl "https://github.com/zecke/kubernetes/blob/master/pkg/kubectl/service.go"
click node_apiserver "https://github.com/zecke/kubernetes/blob/master/cmd/kube-apiserver/app/server.go"
click node_rest "https://github.com/zecke/kubernetes/blob/master/pkg/apiserver/resthandler.go"
click node_etcd "https://github.com/zecke/kubernetes/blob/master/pkg/registry/generic/etcd/storage_factory.go"
click node_master "https://github.com/zecke/kubernetes/blob/master/pkg/master/controller.go"
click node_cm "https://github.com/zecke/kubernetes/blob/master/cmd/kube-controller-manager/app/controllermanager.go"
click node_replication "https://github.com/zecke/kubernetes/blob/master/pkg/controller/replication/replication_controller.go"
click node_daemon "https://github.com/zecke/kubernetes/blob/master/pkg/controller/daemon/controller.go"
click node_nodecontroller "https://github.com/zecke/kubernetes/blob/master/pkg/controller/node/nodecontroller.go"
click node_pv "https://github.com/zecke/kubernetes/blob/master/pkg/controller/persistentvolume/persistentvolume_provisioner_controller.go"
click node_servicecontroller "https://github.com/zecke/kubernetes/blob/master/pkg/controller/service/servicecontroller.go"
click node_scheduler "https://github.com/zecke/kubernetes/blob/master/plugin/cmd/kube-scheduler/app/server.go"
click node_kubelet "https://github.com/zecke/kubernetes/blob/master/cmd/kubelet/app/server.go"
click node_docker "https://github.com/zecke/kubernetes/blob/master/pkg/kubelet/dockertools/manager.go"
click node_cgroups "https://github.com/zecke/kubernetes/blob/master/pkg/kubelet/cm/container_manager_linux.go"
click node_status "https://github.com/zecke/kubernetes/blob/master/pkg/kubelet/status/manager.go"
click node_proxy "https://github.com/zecke/kubernetes/blob/master/cmd/kube-proxy/app/server.go"
click node_endpoints "https://github.com/zecke/kubernetes/blob/master/contrib/mesos/pkg/service/endpoints_controller.go"
click node_mesoscm "https://github.com/zecke/kubernetes/blob/master/contrib/mesos/pkg/controllermanager/controllermanager.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_apiserver,node_rest,node_etcd,node_master,node_operator,node_kubectl toneBlue
class node_cm,node_replication,node_daemon,node_nodecontroller,node_pv,node_servicecontroller,node_scheduler toneAmber
class node_kubelet,node_docker,node_cgroups,node_status toneMint
class node_proxy toneRose
class node_endpoints,node_mesoscm,node_cloud,node_runtime toneIndigo
```

## Components

### API and storage

- [API server](https://github.com/zecke/kubernetes/blob/master/cmd/kube-apiserver/app/server.go): `cmd/kube-apiserver/app/server.go`
- [REST handlers](https://github.com/zecke/kubernetes/blob/master/pkg/apiserver/resthandler.go): `pkg/apiserver/resthandler.go`
- [etcd storage](https://github.com/zecke/kubernetes/blob/master/pkg/registry/generic/etcd/storage_factory.go): `pkg/registry/generic/etcd/storage_factory.go`
- [Master controllers](https://github.com/zecke/kubernetes/blob/master/pkg/master/controller.go): `pkg/master/controller.go`

### Control loops

- [Controller manager](https://github.com/zecke/kubernetes/blob/master/cmd/kube-controller-manager/app/controllermanager.go): `cmd/kube-controller-manager/app/controllermanager.go`
- [Replication controller](https://github.com/zecke/kubernetes/blob/master/pkg/controller/replication/replication_controller.go): `pkg/controller/replication/replication_controller.go`
- [Daemon controller](https://github.com/zecke/kubernetes/blob/master/pkg/controller/daemon/controller.go): `pkg/controller/daemon/controller.go`
- [Node controller](https://github.com/zecke/kubernetes/blob/master/pkg/controller/node/nodecontroller.go): `pkg/controller/node/nodecontroller.go`
- [Volume provisioner](https://github.com/zecke/kubernetes/blob/master/pkg/controller/persistentvolume/persistentvolume_provisioner_controller.go): `pkg/controller/persistentvolume/persistentvolume_provisioner_controller.go`
- [Service controller](https://github.com/zecke/kubernetes/blob/master/pkg/controller/service/servicecontroller.go): `pkg/controller/service/servicecontroller.go`
- [Scheduler](https://github.com/zecke/kubernetes/blob/master/plugin/cmd/kube-scheduler/app/server.go): `plugin/cmd/kube-scheduler/app/server.go`

### Node runtime

- [Kubelet server](https://github.com/zecke/kubernetes/blob/master/cmd/kubelet/app/server.go): `cmd/kubelet/app/server.go`
- [Container manager](https://github.com/zecke/kubernetes/blob/master/pkg/kubelet/dockertools/manager.go): `pkg/kubelet/dockertools/manager.go`
- [Resource manager](https://github.com/zecke/kubernetes/blob/master/pkg/kubelet/cm/container_manager_linux.go): `pkg/kubelet/cm/container_manager_linux.go`
- [Pod status manager](https://github.com/zecke/kubernetes/blob/master/pkg/kubelet/status/manager.go): `pkg/kubelet/status/manager.go`

### Service networking

- [Node proxy](https://github.com/zecke/kubernetes/blob/master/cmd/kube-proxy/app/server.go): `cmd/kube-proxy/app/server.go`

### Mesos integration

- [Endpoint controller](https://github.com/zecke/kubernetes/blob/master/contrib/mesos/pkg/service/endpoints_controller.go): `contrib/mesos/pkg/service/endpoints_controller.go`
- [Mesos controller manager](https://github.com/zecke/kubernetes/blob/master/contrib/mesos/pkg/controllermanager/controllermanager.go): `contrib/mesos/pkg/controllermanager/controllermanager.go`

### Other components

- **Cluster user**
- [kubectl client](https://github.com/zecke/kubernetes/blob/master/pkg/kubectl/service.go): `pkg/kubectl/service.go`
- **Cloud provider**
- **Container runtime**

## Connections

- Cluster user → kubectl client: manages workloads (evidence: `README.md`)
- kubectl client → API server: submits API requests (evidence: `README.md`)
- API server → REST handlers: serves REST (evidence: `cmd/kube-apiserver/app/server.go`)
- API server → etcd storage: configures storage (evidence: `cmd/kube-apiserver/app/server.go`)
- API server → Master controllers: starts controllers
- Master controllers → etcd storage: stores cluster state
- Controller manager → Replication controller: starts controller (evidence: `cmd/kube-controller-manager/app/controllermanager.go`)
- Controller manager → Daemon controller: wires controller (evidence: `cmd/kube-controller-manager/app/controllermanager.go`)
- Controller manager → Node controller: starts controller (evidence: `cmd/kube-controller-manager/app/controllermanager.go`)
- Controller manager → Volume provisioner: starts provisioner (evidence: `cmd/kube-controller-manager/app/controllermanager.go`)
- Controller manager → Service controller: starts controller (evidence: `cmd/kube-controller-manager/app/controllermanager.go`)
- Replication controller → API server: reconciles via API (evidence: `pkg/controller/replication/replication_controller.go`)
- Daemon controller → API server: reconciles via API (evidence: `pkg/controller/daemon/controller.go`)
- Node controller → API server: updates cluster (evidence: `pkg/controller/node/nodecontroller.go`)
- Node controller → Cloud provider: syncs instances (evidence: `pkg/controller/node/nodecontroller.go`)
- Volume provisioner → API server: provisions volumes (evidence: `pkg/controller/persistentvolume/persistentvolume_provisioner_controller.go`)
- Service controller → Cloud provider: manages load balancers (evidence: `pkg/controller/service/servicecontroller.go`)
- Scheduler → API server: reads cluster state (evidence: `plugin/cmd/kube-scheduler/app/server.go`)
- Kubelet server → Container manager: configures runtime (evidence: `cmd/kubelet/app/server.go`)
- Kubelet server → Resource manager: sets resources
- Kubelet server → Pod status manager: reports pod status
- Container manager → Container runtime: manages containers (evidence: `pkg/kubelet/dockertools/manager.go`)
- Kubelet server → API server: syncs cluster state
- Node proxy → API server: watches services (evidence: `cmd/kube-proxy/app/server.go`)
- Node proxy → Container runtime: forwards traffic
- Mesos controller manager → Endpoint controller: starts controller (evidence: `contrib/mesos/pkg/controllermanager/controllermanager.go`)
- Endpoint controller → API server: writes endpoints (evidence: `contrib/mesos/pkg/service/endpoints_controller.go`)
