🖼️ See the drawing + lab 🏠 Course home 🌿 Branch on GitHub ✏️ View source

🖼️ आकृती आणि labThe drawing + lab पूर्ण पानावर उघडा ↗Open full page ↗

🪑 धडा 02 — Pods: शाळेतला एक बाक

📍 तुम्ही इथे आहात: 13 पैकी धडा 02 · मागचा: lesson-01-containers · पुढचा: lesson-03-deployments

📦 या ब्रँचमध्ये काय आहे

धडा 01 मधले सगळे, आणि हा धडा: Pod — Kubernetes चालवत असलेली सर्वात लहान गोष्ट. या धड्यात वापरलेल्या खऱ्या files:

k8s/deployment.yaml — त्यातला template: भाग पाहा — तोच pod चा आराखडा आहे

🧒 5 वर्षांच्या मुलाला समजावल्यासारखे

शाळेत तुम्ही कधीच हवेत तरंगत नाही — तुम्ही बाकावर 🪑 बसता. बाक तुम्हाला जागा देतो: तुमची खुर्ची, तुमच्या नावाची पाटी, तुमची छोटी फळी. कधी कधी दोन जिवलग मैत्रिणी एकाच दुहेरी बाकावर बसतात आणि लगेच एकमेकींच्या कानात कुजबुजू शकतात.

Pod म्हणजे तुमच्या container साठीचा बाक. Kubernetes कधीच container थेट चालवत नाही — तो आधी त्याला नेहमी एक बाक देतो. त्या बाकाकडे असते:

एक पत्ता (स्वतःचा IP) — बाकावरच्या नावाच्या पाटीसारखा,
सामायिक साठवण — बाकाखालची फळी,
कधी कधी मदतनीस container साठी जागा — दुहेरी बाक वाटून घेणारी मैत्रीण (याला "sidecar" म्हणतात).

आणि आता महत्त्वाचा भाग: बाक बदलता येतात. तुमचा बाक तुटला तर शाळा तो दुरुस्त करत नाही — तो फेकून देते आणि तुम्हाला नव्या नावाच्या पाटीसह नवा बाक देते. Pods पण तसेच आहेत: ते cattle आहेत, pets नाहीत. ते येतात आणि जातात; कोणी रडत नाही.

🗺️ आकृती

flowchart TB
    subgraph pod["🪑 Pod - one desk, IP 10.0.4.7"]
        direction LR
        c1["📦 main container<br/>school-api"]
        c2["📦 optional sidecar<br/>e.g. log collector"]
        v["🗄️ shared shelf<br/>volume"]
        c1 --- v
        c2 --- v
    end
    net["🌐 Cluster network"] -->|"talks to the desk,<br/>not the kid"| pod

❓ काय

Pod = एक किंवा अधिक containers जे नेहमी एकाच machine वर एकत्र राहतात, एक IP address आणि गरज असल्यास volumes वाटून घेतात.
99% pods मध्ये एकच container असतो (आपल्या pods मध्येही). अनेक containers असलेले pods जवळच्या मदतनीसांसाठी (sidecars) असतात, संपूर्ण app एकाच pod मध्ये कोंबण्यासाठी नाहीत.
Pods क्षणभंगुर (ephemeral) असतात: ते बनतात, मरतात, आणि त्यांच्या जागी येणाऱ्यांना नवे नाव आणि नवा IP मिळतो. कधीच pod च्या IP कडे थेट बोट दाखवू नका (धडा 04 हे सोडवतो).

🤔 का

Containers थेट का चालवू नयेत? कारण कोणत्याही container ला IP, storage, health-checking आणि machine वर जागा देण्यासाठी Kubernetes ला एक समान आवरण हवे. Pod हेच ते आवरण — प्रत्येक program ज्यावर बसतो तो ठरलेला बाक, ज्यामुळे शाळा Node.js app आणि Python app अगदी एकाच पद्धतीने सांभाळू शकते.

🔧 कसे (या repo मध्ये)

आपण कधीच स्वतंत्र Pod file लिहित नाही — आणि हाच एक खरा धडा आहे: k8s/deployment.yaml मध्ये template: खालचा भाग हाच pod चा आराखडा आहे:

template:              # ← the pod blueprint ("desk design")
  metadata:
    labels:
      app: school-api  # ← sticker on the desk (lesson 03 explains why)
  spec:
    containers:
      - name: school-api
        image: IMAGE_PLACEHOLDER
        ports:
          - containerPort: 3000

Deployment (धडा 03) या design वरून बाक तयार करतो.

🧪 करून पाहा

कोणत्याही local cluster सोबत (Docker Desktop मधले built-in Kubernetes, minikube start, किंवा kind create cluster):

# Run a single throwaway pod by hand — the ONLY time you'll do this manually:
kubectl run hello --image=nginx --restart=Never

kubectl get pods -o wide     # see its IP and which node it sits on
kubectl describe pod hello   # the pod's full report card
kubectl delete pod hello     # throw the desk away — and notice:
kubectl get pods             # ...nothing brings it back. That's lesson 03's job.

🔧 या धड्यासाठी kubectl

kubectl get pods · kubectl describe pod · kubectl logs · kubectl exec -it POD -- sh

🔗 यावर आधारित: 🪪 AWS L07 (node म्हणजे भाड्याने घेतलेला बाक)

✅ तपासा — तुम्हाला काय दिसायला हवे

kubectl get pods -n school मध्ये Running 1/1 दिसते; kubectl get pod POD -o wide त्याचा IP दाखवते.

🧹 साफसफाई

kubectl delete pod POD — एकटा (controller शिवायचा) pod पुन्हा तयार होत नाही (ते धडा 03 चे काम आहे)

⚠️ नेहमीच्या चुका

pod जागच्या जागी edit करणे — बदला, कधीच दुरुस्त करू नका
delete केल्यानंतर एकटा pod परत येईल अशी अपेक्षा ठेवणे — फक्त controller च तो पुन्हा तयार करतो

⏭️ पुढे

मरणारा एकटा pod मेलेलाच राहतो. योग्य संख्येने बाक नेहमी जिवंत कोण ठेवतो? Deployment — कडक वर्ग-प्रमुख.

git checkout lesson-03-deployments

🪑 Lesson 02 — Pods: one school desk

📍 You are here: Lesson 02 of 13 · Previous: lesson-01-containers · Next: lesson-03-deployments

📦 What's in this branch

Everything from lesson 01, plus this lesson: the Pod — the smallest thing Kubernetes ever runs. Real files this lesson uses:

k8s/deployment.yaml — look at the template: part — that's a pod blueprint

🧒 Explain like I'm 5

In school, you never just float in the air — you sit at a desk 🪑. The desk gives you a place: your chair, your name tag, your little shelf. Sometimes two best friends share one double desk and can whisper to each other instantly.

A Pod is a desk for your container. Kubernetes never runs a container directly — it always gives it a desk first. The desk has:

one address (its own IP) — like the desk's name tag,
shared storage — the shelf under the desk,
room for a helper container sometimes — the friend sharing the double desk (people call this a "sidecar").

And here's the important part: desks are replaceable. If your desk breaks, the school doesn't repair it — it throws it away and gives you a new desk with a new name tag. Pods are the same: they are cattle, not pets. They come and go; nobody cries.

🗺️ Diagram

flowchart TB
    subgraph pod["🪑 Pod - one desk, IP 10.0.4.7"]
        direction LR
        c1["📦 main container<br/>school-api"]
        c2["📦 optional sidecar<br/>e.g. log collector"]
        v["🗄️ shared shelf<br/>volume"]
        c1 --- v
        c2 --- v
    end
    net["🌐 Cluster network"] -->|"talks to the desk,<br/>not the kid"| pod

❓ What

A Pod = one or more containers that always live together on the same machine, sharing one IP address and optional volumes.
99% of pods hold one container (ours do). Multi-container pods are for tight helpers (sidecars), not for stacking your whole app in one pod.
Pods are ephemeral: they get created, they die, replacements get a new name and a new IP. Never point at a pod's IP directly (lesson 04 fixes this).

🤔 Why

Why not run containers directly? Because Kubernetes needs one common wrapper to give any container an IP, storage, health-checking and a place on a machine. The Pod is that wrapper — the standard desk every program sits at, so the school can manage a Node.js app and a Python app the exact same way.

🔧 How (in this repo)

We never write a standalone Pod file — and that's a real lesson in itself: in k8s/deployment.yaml the section under template: is the pod blueprint:

template:              # ← the pod blueprint ("desk design")
  metadata:
    labels:
      app: school-api  # ← sticker on the desk (lesson 03 explains why)
  spec:
    containers:
      - name: school-api
        image: IMAGE_PLACEHOLDER
        ports:
          - containerPort: 3000

The Deployment (lesson 03) stamps out desks from this design.

🧪 Try it

With any local cluster (Docker Desktop's built-in Kubernetes, minikube start, or kind create cluster):

# Run a single throwaway pod by hand — the ONLY time you'll do this manually:
kubectl run hello --image=nginx --restart=Never

kubectl get pods -o wide     # see its IP and which node it sits on
kubectl describe pod hello   # the pod's full report card
kubectl delete pod hello     # throw the desk away — and notice:
kubectl get pods             # ...nothing brings it back. That's lesson 03's job.

🔧 kubectl for this lesson

kubectl get pods · kubectl describe pod · kubectl logs · kubectl exec -it POD -- sh

🔗 Builds on: 🪪 AWS L07 (a node is a rented desk)

✅ Verify — what you should see

kubectl get pods -n school shows Running 1/1; kubectl get pod POD -o wide shows its IP.

🧹 Clean up

kubectl delete pod POD — a bare pod is NOT recreated (that's lesson 03's job)

⚠️ Common mistakes

editing a pod in place — replace, never repair
expecting a bare pod to come back after deletion — only a controller recreates it

⏭️ Next

A lone pod that dies stays dead. Who keeps the right number of desks alive at all times? The Deployment — the strict class monitor.

git checkout lesson-03-deployments

← Previouscontainers Next →deployments

This page is the lesson's README from the lesson-02-pods branch, shown here so the whole School stays on one site. Code files open on GitHub at the same branch.