# karthi2305/kubernetes architecture

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

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

## Overview

This repository is a Kubernetes learning and configuration POC, not an orchestration runtime. Its main workflow is an operator applying an example manifest with kubectl, which communicates with the cluster API; the examples cover workload creation and operational capabilities. The architecture below combines that documented workflow with the README’s control-plane/worker-node overview. Manifest nodes represent examples, not code that directly invokes Kubernetes components; relationships among individual examples are omitted because no source excerpts establish them.

Main entry points: [`docs/01-architecture.md`](https://github.com/karthi2305/kubernetes/blob/main/docs/01-architecture.md) (API server), [`manifests/01-pod/pod.yaml`](https://github.com/karthi2305/kubernetes/blob/main/manifests/01-pod/pod.yaml) (Pod example)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cluster["Cluster architecture"]
  node_api["API server<br/>[01-architecture.md]"]
  node_etcd[("etcd<br/>[01-architecture.md]")]
  node_scheduler["Scheduler<br/>[01-architecture.md]"]
  node_controller["Controller manager<br/>[01-architecture.md]"]
  node_worker["Worker node<br/>[01-architecture.md]"]
  node_microk8s["MicroK8s setup<br/>[setup.md]"]
end

subgraph group_workloads["Workload examples"]
  node_pod["Pod example<br/>[pod.yaml]"]
  node_deployment["Deployment example<br/>[deployment.yaml]"]
  node_statefulset["StatefulSet example<br/>[statefulset.yaml]"]
  node_daemonset["DaemonSet example<br/>[daemonset.yaml]"]
  node_cronjob["CronJob example<br/>[cronjob.yaml]"]
end

subgraph group_networking["Networking and storage"]
  node_service["Service examples<br/>[services.yaml]"]
  node_storage["Storage examples<br/>[storage.yaml]"]
  node_ingress["Ingress example<br/>[ingress.yaml]"]
end

subgraph group_operations["Operations and security"]
  node_config["Config and secrets"]
  node_rbac["RBAC example<br/>[rbac.yaml]"]
  node_scheduling["Scheduling example<br/>[scheduling.yaml]"]
  node_hpa["Autoscaling example<br/>[hpa.yaml]"]
  node_networkpolicy["Network policy"]
  node_probes["Health probes"]
  node_helm["Helm overview<br/>[09-helm.md]"]
end

node_operator(("Operator"))
node_kubectl["kubectl"]

node_operator -->|"applies manifests"| node_kubectl
node_kubectl -->|"communicates with"| node_api
node_api -->|"stores state"| node_etcd
node_api -->|"coordinates scheduling"| node_scheduler
node_api -->|"coordinates control"| node_controller
node_worker -->|"runs workloads"| node_pod

click node_api "https://github.com/karthi2305/kubernetes/blob/main/docs/01-architecture.md"
click node_etcd "https://github.com/karthi2305/kubernetes/blob/main/docs/01-architecture.md"
click node_scheduler "https://github.com/karthi2305/kubernetes/blob/main/docs/01-architecture.md"
click node_controller "https://github.com/karthi2305/kubernetes/blob/main/docs/01-architecture.md"
click node_worker "https://github.com/karthi2305/kubernetes/blob/main/docs/01-architecture.md"
click node_pod "https://github.com/karthi2305/kubernetes/blob/main/manifests/01-pod/pod.yaml"
click node_deployment "https://github.com/karthi2305/kubernetes/blob/main/manifests/02-deployment/deployment.yaml"
click node_statefulset "https://github.com/karthi2305/kubernetes/blob/main/manifests/03-statefulset/statefulset.yaml"
click node_daemonset "https://github.com/karthi2305/kubernetes/blob/main/manifests/04-daemonset/daemonset.yaml"
click node_cronjob "https://github.com/karthi2305/kubernetes/blob/main/manifests/05-cronjob/cronjob.yaml"
click node_service "https://github.com/karthi2305/kubernetes/blob/main/manifests/06-services/services.yaml"
click node_storage "https://github.com/karthi2305/kubernetes/blob/main/manifests/07-storage/storage.yaml"
click node_ingress "https://github.com/karthi2305/kubernetes/blob/main/manifests/08-ingress/ingress.yaml"
click node_config "https://github.com/karthi2305/kubernetes/blob/main/manifests/09-configmap-secret/configmap-secret.yaml"
click node_rbac "https://github.com/karthi2305/kubernetes/blob/main/manifests/10-rbac/rbac.yaml"
click node_scheduling "https://github.com/karthi2305/kubernetes/blob/main/manifests/11-scheduling/scheduling.yaml"
click node_hpa "https://github.com/karthi2305/kubernetes/blob/main/manifests/12-hpa/hpa.yaml"
click node_networkpolicy "https://github.com/karthi2305/kubernetes/blob/main/manifests/13-network-policy/network-policy.yaml"
click node_probes "https://github.com/karthi2305/kubernetes/blob/main/manifests/14-probes/deployment-with-probes.yaml"
click node_microk8s "https://github.com/karthi2305/kubernetes/blob/main/microk8s/setup.md"
click node_helm "https://github.com/karthi2305/kubernetes/blob/main/docs/09-helm.md"

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_api,node_etcd,node_scheduler,node_controller,node_worker,node_microk8s toneBlue
class node_pod,node_deployment,node_statefulset,node_daemonset,node_cronjob toneAmber
class node_service,node_storage,node_ingress toneMint
class node_config,node_rbac,node_scheduling,node_hpa,node_networkpolicy,node_probes,node_helm toneRose
class node_operator,node_kubectl toneIndigo
```

## Components

### Cluster architecture

- [API server](https://github.com/karthi2305/kubernetes/blob/main/docs/01-architecture.md): `docs/01-architecture.md`
- [etcd](https://github.com/karthi2305/kubernetes/blob/main/docs/01-architecture.md): `docs/01-architecture.md`
- [Scheduler](https://github.com/karthi2305/kubernetes/blob/main/docs/01-architecture.md): `docs/01-architecture.md`
- [Controller manager](https://github.com/karthi2305/kubernetes/blob/main/docs/01-architecture.md): `docs/01-architecture.md`
- [Worker node](https://github.com/karthi2305/kubernetes/blob/main/docs/01-architecture.md): `docs/01-architecture.md`
- [MicroK8s setup](https://github.com/karthi2305/kubernetes/blob/main/microk8s/setup.md): `microk8s/setup.md`

### Workload examples

- [Pod example](https://github.com/karthi2305/kubernetes/blob/main/manifests/01-pod/pod.yaml): `manifests/01-pod/pod.yaml`
- [Deployment example](https://github.com/karthi2305/kubernetes/blob/main/manifests/02-deployment/deployment.yaml): `manifests/02-deployment/deployment.yaml`
- [StatefulSet example](https://github.com/karthi2305/kubernetes/blob/main/manifests/03-statefulset/statefulset.yaml): `manifests/03-statefulset/statefulset.yaml`
- [DaemonSet example](https://github.com/karthi2305/kubernetes/blob/main/manifests/04-daemonset/daemonset.yaml): `manifests/04-daemonset/daemonset.yaml`
- [CronJob example](https://github.com/karthi2305/kubernetes/blob/main/manifests/05-cronjob/cronjob.yaml): `manifests/05-cronjob/cronjob.yaml`

### Networking and storage

- [Service examples](https://github.com/karthi2305/kubernetes/blob/main/manifests/06-services/services.yaml): `manifests/06-services/services.yaml`
- [Storage examples](https://github.com/karthi2305/kubernetes/blob/main/manifests/07-storage/storage.yaml): `manifests/07-storage/storage.yaml`
- [Ingress example](https://github.com/karthi2305/kubernetes/blob/main/manifests/08-ingress/ingress.yaml): `manifests/08-ingress/ingress.yaml`

### Operations and security

- [Config and secrets](https://github.com/karthi2305/kubernetes/blob/main/manifests/09-configmap-secret/configmap-secret.yaml): `manifests/09-configmap-secret/configmap-secret.yaml`
- [RBAC example](https://github.com/karthi2305/kubernetes/blob/main/manifests/10-rbac/rbac.yaml): `manifests/10-rbac/rbac.yaml`
- [Scheduling example](https://github.com/karthi2305/kubernetes/blob/main/manifests/11-scheduling/scheduling.yaml): `manifests/11-scheduling/scheduling.yaml`
- [Autoscaling example](https://github.com/karthi2305/kubernetes/blob/main/manifests/12-hpa/hpa.yaml): `manifests/12-hpa/hpa.yaml`
- [Network policy](https://github.com/karthi2305/kubernetes/blob/main/manifests/13-network-policy/network-policy.yaml): `manifests/13-network-policy/network-policy.yaml`
- [Health probes](https://github.com/karthi2305/kubernetes/blob/main/manifests/14-probes/deployment-with-probes.yaml): `manifests/14-probes/deployment-with-probes.yaml`
- [Helm overview](https://github.com/karthi2305/kubernetes/blob/main/docs/09-helm.md): `docs/09-helm.md`

### Other components

- **Operator**
- **kubectl**

## Connections

- Operator → kubectl: applies manifests (evidence: `README.md`)
- kubectl → API server: communicates with (evidence: `README.md`)
- API server → etcd: stores state (evidence: `README.md`)
- API server → Scheduler: coordinates scheduling (evidence: `README.md`)
- API server → Controller manager: coordinates control (evidence: `README.md`)
- Worker node → Pod example: runs workloads (evidence: `README.md`)
