# kubernetes/apiserver architecture

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

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

## Overview

apiserver is a generic Kubernetes API-server library. A client request enters the server, passes authentication, authorization, admission and request handling, then reaches resource registries backed by encoded persistent storage; the result is returned as an API response. Parallel capabilities provide discovery, auditing, API Priority and Fairness, webhooks, policy admission, caching and storage-version coordination. The graph reflects README capabilities and sampled implementations; several server-level connections are inferred from the documented delegated architecture.

Main entry points: [`pkg/server/genericapiserver.go`](https://github.com/kubernetes/apiserver/blob/master/pkg/server/genericapiserver.go) (Generic API Server), [`pkg/endpoints/handlers/rest.go`](https://github.com/kubernetes/apiserver/blob/master/pkg/endpoints/handlers/rest.go) (API Handlers), [`pkg/registry/generic/registry/store.go`](https://github.com/kubernetes/apiserver/blob/master/pkg/registry/generic/registry/store.go) (Resource Registry), [`pkg/server/storage/storage_factory.go`](https://github.com/kubernetes/apiserver/blob/master/pkg/server/storage/storage_factory.go) (Storage Factory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_request["Request Processing"]
  node_server["Generic API Server"]
  node_versionfilter["Version Filter<br/>[storageversion.go]"]
end

subgraph group_security["Security Controls"]
  node_authn["Authentication Factory<br/>[delegating.go]"]
  node_authz["Authorization Factory<br/>[delegating.go]"]
  node_audit["Audit Evaluation<br/>[evaluator.go]"]
  node_apf["Priority Fairness<br/>[apf_controller.go]"]
end

subgraph group_api["API Surface"]
  node_endpoint["API Handlers<br/>[rest.go]"]
  node_discovery["API Discovery<br/>[root.go]"]
  node_registry["Resource Registry<br/>[store.go]"]
end

subgraph group_storage["Persistence Layer"]
  node_storagefactory["Storage Factory<br/>[storage_factory.go]"]
  node_codec["Storage Codec<br/>[storage_codec.go]"]
  node_cacher["Watch Cache<br/>[storage_factory.go]"]
  node_errors["Storage Errors<br/>[storage.go]"]
  node_storageversion["Storage Versions<br/>[manager.go]"]
end

subgraph group_extensions["Extensibility"]
  node_admission["Admission Chain<br/>[chain.go]"]
  node_policy["Policy Admission"]
  node_webhooks["Webhook Dispatchers<br/>[webhook.go]"]
end

node_client(("Kubernetes Client"))
node_webhooksvc["Webhook Services"]
node_etcd[("etcd Storage")]
node_response["API Response"]

node_client -->|"sends request"| node_server
node_server -->|"authenticates"| node_authn
node_server -->|"authorizes"| node_authz
node_server -->|"admits request"| node_admission
node_server -->|"dispatches request"| node_endpoint
node_server -->|"records audit"| node_audit
node_server -->|"queues request"| node_apf
node_endpoint -->|"uses storage"| node_registry
node_endpoint -->|"writes result"| node_response
node_server -->|"serves discovery"| node_discovery
node_admission -->|"dispatches policy"| node_policy
node_admission -->|"dispatches webhooks"| node_webhooks
node_webhooks -.->|"calls webhook"| node_webhooksvc
node_registry -->|"creates storage"| node_storagefactory
node_storagefactory -->|"configures codec"| node_codec
node_storagefactory -->|"opens backend"| node_etcd
node_registry -->|"wraps storage"| node_cacher
node_cacher -->|"reads and watches"| node_etcd
node_endpoint -->|"maps failures"| node_errors
node_storageversion -->|"gates writes"| node_versionfilter
node_server -->|"filters requests"| node_versionfilter

click node_server "https://github.com/kubernetes/apiserver/blob/master/pkg/server/genericapiserver.go"
click node_authn "https://github.com/kubernetes/apiserver/blob/master/pkg/authentication/authenticatorfactory/delegating.go"
click node_authz "https://github.com/kubernetes/apiserver/blob/master/pkg/authorization/authorizerfactory/delegating.go"
click node_endpoint "https://github.com/kubernetes/apiserver/blob/master/pkg/endpoints/handlers/rest.go"
click node_discovery "https://github.com/kubernetes/apiserver/blob/master/pkg/endpoints/discovery/root.go"
click node_registry "https://github.com/kubernetes/apiserver/blob/master/pkg/registry/generic/registry/store.go"
click node_admission "https://github.com/kubernetes/apiserver/blob/master/pkg/admission/chain.go"
click node_policy "https://github.com/kubernetes/apiserver/blob/master/pkg/admission/plugin/policy/generic/policy_dispatcher.go"
click node_webhooks "https://github.com/kubernetes/apiserver/blob/master/pkg/admission/plugin/webhook/generic/webhook.go"
click node_audit "https://github.com/kubernetes/apiserver/blob/master/pkg/audit/evaluator.go"
click node_apf "https://github.com/kubernetes/apiserver/blob/master/pkg/util/flowcontrol/apf_controller.go"
click node_storagefactory "https://github.com/kubernetes/apiserver/blob/master/pkg/server/storage/storage_factory.go"
click node_codec "https://github.com/kubernetes/apiserver/blob/master/pkg/server/storage/storage_codec.go"
click node_cacher "https://github.com/kubernetes/apiserver/blob/master/pkg/registry/generic/registry/storage_factory.go"
click node_errors "https://github.com/kubernetes/apiserver/blob/master/pkg/storage/errors/storage.go"
click node_storageversion "https://github.com/kubernetes/apiserver/blob/master/pkg/storageversion/manager.go"
click node_versionfilter "https://github.com/kubernetes/apiserver/blob/master/pkg/endpoints/filters/storageversion.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_server,node_versionfilter,node_client toneBlue
class node_authn,node_authz,node_audit,node_apf,node_etcd toneAmber
class node_endpoint,node_discovery,node_registry,node_webhooksvc,node_response toneMint
class node_storagefactory,node_codec,node_cacher,node_errors,node_storageversion toneRose
class node_admission,node_policy,node_webhooks toneIndigo
```

## Components

### Request Processing

- [Generic API Server](https://github.com/kubernetes/apiserver/blob/master/pkg/server/genericapiserver.go): `pkg/server/genericapiserver.go`
- [Version Filter](https://github.com/kubernetes/apiserver/blob/master/pkg/endpoints/filters/storageversion.go): `pkg/endpoints/filters/storageversion.go`

### Security Controls

- [Authentication Factory](https://github.com/kubernetes/apiserver/blob/master/pkg/authentication/authenticatorfactory/delegating.go): `pkg/authentication/authenticatorfactory/delegating.go`
- [Authorization Factory](https://github.com/kubernetes/apiserver/blob/master/pkg/authorization/authorizerfactory/delegating.go): `pkg/authorization/authorizerfactory/delegating.go`
- [Audit Evaluation](https://github.com/kubernetes/apiserver/blob/master/pkg/audit/evaluator.go): `pkg/audit/evaluator.go`
- [Priority Fairness](https://github.com/kubernetes/apiserver/blob/master/pkg/util/flowcontrol/apf_controller.go): `pkg/util/flowcontrol/apf_controller.go`

### API Surface

- [API Handlers](https://github.com/kubernetes/apiserver/blob/master/pkg/endpoints/handlers/rest.go): `pkg/endpoints/handlers/rest.go`
- [API Discovery](https://github.com/kubernetes/apiserver/blob/master/pkg/endpoints/discovery/root.go): `pkg/endpoints/discovery/root.go`
- [Resource Registry](https://github.com/kubernetes/apiserver/blob/master/pkg/registry/generic/registry/store.go): `pkg/registry/generic/registry/store.go`

### Persistence Layer

- [Storage Factory](https://github.com/kubernetes/apiserver/blob/master/pkg/server/storage/storage_factory.go): `pkg/server/storage/storage_factory.go`
- [Storage Codec](https://github.com/kubernetes/apiserver/blob/master/pkg/server/storage/storage_codec.go): `pkg/server/storage/storage_codec.go`
- [Watch Cache](https://github.com/kubernetes/apiserver/blob/master/pkg/registry/generic/registry/storage_factory.go): `pkg/registry/generic/registry/storage_factory.go`
- [Storage Errors](https://github.com/kubernetes/apiserver/blob/master/pkg/storage/errors/storage.go): `pkg/storage/errors/storage.go`
- [Storage Versions](https://github.com/kubernetes/apiserver/blob/master/pkg/storageversion/manager.go): `pkg/storageversion/manager.go`

### Extensibility

- [Admission Chain](https://github.com/kubernetes/apiserver/blob/master/pkg/admission/chain.go): `pkg/admission/chain.go`
- [Policy Admission](https://github.com/kubernetes/apiserver/blob/master/pkg/admission/plugin/policy/generic/policy_dispatcher.go): `pkg/admission/plugin/policy/generic/policy_dispatcher.go`
- [Webhook Dispatchers](https://github.com/kubernetes/apiserver/blob/master/pkg/admission/plugin/webhook/generic/webhook.go): `pkg/admission/plugin/webhook/generic/webhook.go`

### Other components

- **Kubernetes Client**
- **Webhook Services**
- **etcd Storage**
- **API Response**

## Connections

- Kubernetes Client → Generic API Server: sends request
- Generic API Server → Authentication Factory: authenticates
- Generic API Server → Authorization Factory: authorizes
- Generic API Server → Admission Chain: admits request
- Generic API Server → API Handlers: dispatches request
- Generic API Server → Audit Evaluation: records audit
- Generic API Server → Priority Fairness: queues request
- API Handlers → Resource Registry: uses storage
- API Handlers → API Response: writes result
- Generic API Server → API Discovery: serves discovery
- Admission Chain → Policy Admission: dispatches policy
- Admission Chain → Webhook Dispatchers: dispatches webhooks
- Webhook Dispatchers → Webhook Services: calls webhook
- Resource Registry → Storage Factory: creates storage
- Storage Factory → Storage Codec: configures codec
- Storage Factory → etcd Storage: opens backend
- Resource Registry → Watch Cache: wraps storage
- Watch Cache → etcd Storage: reads and watches
- API Handlers → Storage Errors: maps failures
- Storage Versions → Version Filter: gates writes
- Generic API Server → Version Filter: filters requests
