🧠 The Internal Process Behind “API” in Kubernetes (Made Human-Friendly)

🚀 Scenario: You create a Pod using a YAML file

You write this YAML:

apiVersion: v1
kind: Pod
metadata:
  name: myapp
spec:
  containers:
  - name: app
    image: nginx

What’s really happening?

🔍 Step-by-Step Breakdown

Step Action Behind the Scenes
1️⃣ You run: kubectl apply -f pod.yaml kubectl reads the YAML file
2️⃣ kubectl converts YAML into an API request It forms an HTTP POST request
3️⃣ It sends this request to the Kubernetes API Server The API server is the cluster's control center
4️⃣ API Server checks your YAML matches a known API Object (Pod) This is an "API Object" – basically, a data structure Kubernetes understands
5️⃣ If it’s valid, API Server stores the object in etcd (database) This is how Kubernetes remembers what to run
6️⃣ Then, Scheduler sees there's a new Pod → assigns a node This starts actual container creation
✅ Container runtime runs the Pod Your app is live on a node

🧩 Understanding API Components Now

🔹 API Object:

  • A type of resource you want Kubernetes to manage (like Pod, Service, Deployment)
  • Each one has a schema (rules, properties)
  • Defined in YAML and recognized by the Kubernetes API

🔹 API Request:

  • The actual HTTP message (like POST, GET) sent to the API Server
  • Created automatically by kubectl, Helm, or the dashboard

🔹 API Endpoint:

  • A URL path on the API server like:
    POST /api/v1/namespaces/default/pods

  • Think of this like:
    www.kubernetes-cluster.com/api/v1/...

💬 kubeadm API?

kubeadm’s API isn’t an HTTP one. Instead, it defines config object types like:

  • InitConfiguration
  • ClusterConfiguration

When you write kubeadm-config.yaml, kubeadm reads it → interprets it → and makes the right decisions to initialize or join the cluster.

Same principle, just not over HTTP.

📦 Conclusion

Your YAML → gets converted into → API Object
kubectl → sends it as → API Request
API server → receives it on → API Endpoint
Then cluster starts reacting to it.

🤔 What’s Next?

Click here to learn more about Kubernetes API and how to interact with it in simple way. This is a great resource to learn more about Kubernetes API in-depth.