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

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

🚪 धडा 05 — Namespaces: वेगवेगळ्या वर्गखोल्या

📍 तुम्ही इथे आहात: 13 पैकी धडा 05 · मागचा: lesson-04-services · पुढचा: lesson-06-configmaps-secrets

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

धडे 01–04, आणि: Namespace — अनेक teams आणि projects एकच cluster वाटून घेतात तेव्हा तो नीटनेटका कसा राहतो. खरी file:

k8s/namespace.yaml — 6 ओळींची file, जिच्या आत बाकी सगळे राहते

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

शाळेच्या इमारतीत अनेक वर्गखोल्या 🚪 असतात. 3A आणि 3B दोन्ही वर्गांत "ऐश्वर्या" नावाची मुलगी असू शकते — काही हरकत नाही! 3A च्या आत तुम्ही फक्त "ऐश्वर्या" म्हणता आणि सगळ्यांना कळते तुम्हाला कोण हवी आहे. दुसऱ्या खोलीतून तुम्ही म्हणाल "3B मधली ऐश्वर्या".

प्रत्येक खोलीचा स्वतःचा सूचना-फलक, स्वतःचे साहित्याचे कपाट असते, आणि शिक्षिका खोलीचे नियम ठरवू शकतात ("3A मध्ये जास्तीत जास्त 30 मुले").

Namespace म्हणजे Kubernetes इमारतीतली एक वर्गखोली:

दोन teams कडे api नावाची service असू शकते — वेगवेगळ्या खोल्यांमध्ये.
खोली delete केली की तिच्यातले सगळे फेकले जाते — एकाच झटक्यात स्वच्छ.
मुख्याध्यापिका प्रत्येक खोलीवर मर्यादा घालू शकतात: "या project ला जास्तीत जास्त 10 CPUs."

आपल्या खोलीचे नाव school आहे, आणि या repo मधला प्रत्येक object तिच्यातच राहतो.

🗺️ आकृती

flowchart TB
    subgraph cluster["🏫 One Kubernetes cluster - the building"]
        subgraph ns1["🚪 namespace: school - our room"]
            d1["Deployment school-api"]
            d2["Deployment school-analytics"]
            s1["Service school-api"]
            cm["ConfigMap + Secret"]
        end
        subgraph ns2["🚪 namespace: kube-system - the school office"]
            dns["CoreDNS, metrics-server..."]
        end
        subgraph ns3["🚪 namespace: default"]
            x["experiments end up here<br/>if you forget -n 😅"]
        end
    end

❓ काय

Namespace म्हणजे एका cluster चा नाव दिलेला भाग. बहुतेक objects ची नावे namespace च्या आत अद्वितीय असावी लागतात, संपूर्ण cluster मध्ये नाही.
आधीपासून असलेल्या खोल्या: default (तुम्ही निवडले नाही तर गोष्टी इथे येतात), kube-system (Kubernetes ची स्वतःची यंत्रणा — शाळेचे कार्यालय).
Namespaces वर quotas (प्रत्येक खोलीला जास्तीत जास्त CPU/RAM) आणि प्रवेशाचे नियम (धडा 13 RBAC ला स्पर्श करतो: "खोली A मध्ये फक्त team A येऊ शकते") लावता येतात.
DNS पण जोडलेले आहे: खोलीच्या आत school-api चालते; दुसऱ्या खोलीतून तुम्ही पूर्ण नाव म्हणता — school-api.school.svc.cluster.local ("3B मधली ऐश्वर्या").

🤔 का

एक cluster महाग असतो (लक्षात ठेवा: nodes आधीच EKS ≈ $73/month!) — म्हणून teams clusters वाटून घेतात. खोल्या नसतील तर नावे आपसात भिडतील, दुसऱ्यांच्या गोष्टी चुकून delete होतील, आणि "staging सगळा CPU खाऊ शकत नाही" असे सांगायला मार्ग नसेल. Namespaces जास्त clusters न घेता वेगळेपणा देतात. ते नुकसानाची स्वच्छ सीमा (blast radius) पण आहेत: kubectl delete namespace school या project मधले सगळे काढते, आणि फक्त याच project मधले.

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

k8s/namespace.yaml छोटी आहे पण ती सर्वात आधी apply करावी लागते (खोलीत बाक ठेवण्याआधी खोली असायला हवी):

apiVersion: v1
kind: Namespace
metadata:
  name: school

मग बाकी प्रत्येक manifest metadata.namespace: school ने स्वतःला या खोलीशी जोडते, आणि प्रत्येक kubectl command ला -n school लागते — म्हणूनच तुम्हाला हे या धड्यांमध्ये सतत दिसते.

🧪 करून पाहा

kubectl apply -f k8s/namespace.yaml
kubectl get namespaces                       # school, default, kube-system...

kubectl -n school get all                    # our room's contents
kubectl -n kube-system get pods              # peek into the school office 👀

# Same name, two rooms — totally legal:
kubectl create namespace room-b
kubectl -n room-b create deployment api --image=nginx
kubectl -n school get deploy; kubectl -n room-b get deploy

# Clean sweep of the experiment room:
kubectl delete namespace room-b

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

kubectl get ns · kubectl config set-context --current --namespace=school

🔗 यावर आधारित: 🪪 AWS L02 (groups: दुसऱ्या account शिवाय वेगळेपणा)

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

kubectl get all -n school फक्त school चे objects दाखवते; kubectl get all (default) त्यातला एकही दाखवत नाही.

🧹 साफसफाई

kubectl delete namespace school संपूर्ण खोली काढून टाकते — तिच्यातल्या सगळ्यासह

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

-n विसरणे आणि गोष्टी default मध्ये तयार करणे
शत्रुत्व असलेल्या tenants साठी namespaces ला पक्की security सीमा समजणे (त्या तशा नाहीत)

⏭️ पुढे

आपल्या pods ना settings (port numbers) आणि secrets (database passwords) लागतात — आणि ते image मध्येच भाजून टाकणे म्हणजे जेवणाचा मेनू डब्यातच laminate करण्यासारखे. आता येतात ConfigMaps आणि Secrets.

git checkout lesson-06-configmaps-secrets

🚪 Lesson 05 — Namespaces: separate classrooms

📍 You are here: Lesson 05 of 13 · Previous: lesson-04-services · Next: lesson-06-configmaps-secrets

📦 What's in this branch

Lessons 01–04, plus: the Namespace — how one cluster stays tidy when many teams and projects share it. Real file:

k8s/namespace.yaml — the 6-line file everything else lives inside

🧒 Explain like I'm 5

A school building has many classrooms 🚪. Class 3A and Class 3B can BOTH have a kid named "Aishwarya" — no problem! Inside 3A, you just say "Aishwarya" and everyone knows who you mean. From another room you'd say "Aishwarya from 3B".

Each room also has its own notice board, its own supplies cupboard, and the teacher can set room rules ("3A gets at most 30 kids").

A Namespace is a classroom inside the Kubernetes building:

Two teams can both have a service called api — in different rooms.
Deleting a room throws away everything in it — one clean sweep.
The principal can put limits per room: "this project gets max 10 CPUs."

Our room is called school, and every object in this repo lives in it.

🗺️ Diagram

flowchart TB
    subgraph cluster["🏫 One Kubernetes cluster - the building"]
        subgraph ns1["🚪 namespace: school - our room"]
            d1["Deployment school-api"]
            d2["Deployment school-analytics"]
            s1["Service school-api"]
            cm["ConfigMap + Secret"]
        end
        subgraph ns2["🚪 namespace: kube-system - the school office"]
            dns["CoreDNS, metrics-server..."]
        end
        subgraph ns3["🚪 namespace: default"]
            x["experiments end up here<br/>if you forget -n 😅"]
        end
    end

❓ What

A Namespace is a named partition of one cluster. Names of most objects must be unique within a namespace, not across the cluster.
Built-in rooms: default (where things land if you don't choose), kube-system (Kubernetes' own machinery — the school office).
Namespaces can carry quotas (max CPU/RAM per room) and access rules (lesson 13 touches RBAC: "only team A may enter room A").
DNS ties in: school-api works inside the room; from another room you say the full name — school-api.school.svc.cluster.local ("Aishwarya from 3B").

🤔 Why

One cluster is expensive (remember: EKS ≈ $73/month before nodes!) — so teams share clusters. Without rooms you'd get name collisions, accidental deletions of other people's stuff, and no way to say "staging may not eat all the CPU". Namespaces give isolation-without-more-clusters. They're also a clean blast radius: kubectl delete namespace school removes everything in this project, and only this project.

🔧 How (in this repo)

k8s/namespace.yaml is tiny but must be applied first (a room must exist before you put desks in it):

apiVersion: v1
kind: Namespace
metadata:
  name: school

Then every other manifest pins itself to the room with metadata.namespace: school, and every kubectl command needs -n school — that's why you keep seeing it in these lessons.

🧪 Try it

kubectl apply -f k8s/namespace.yaml
kubectl get namespaces                       # school, default, kube-system...

kubectl -n school get all                    # our room's contents
kubectl -n kube-system get pods              # peek into the school office 👀

# Same name, two rooms — totally legal:
kubectl create namespace room-b
kubectl -n room-b create deployment api --image=nginx
kubectl -n school get deploy; kubectl -n room-b get deploy

# Clean sweep of the experiment room:
kubectl delete namespace room-b

🔧 kubectl for this lesson

kubectl get ns · kubectl config set-context --current --namespace=school

🔗 Builds on: 🪪 AWS L02 (groups: separation without a second account)

✅ Verify — what you should see

kubectl get all -n school shows only the school's objects; kubectl get all (default) shows none of them.

🧹 Clean up

kubectl delete namespace school removes the whole room — everything in it

⚠️ Common mistakes

forgetting -n and creating things in default
treating namespaces as a hard security boundary for hostile tenants (they are not)

⏭️ Next

Our pods need settings (port numbers) and secrets (database passwords) — and baking those into the image would be like laminating the lunch menu into the lunchbox. Enter ConfigMaps & Secrets.

git checkout lesson-06-configmaps-secrets

← Previousservices Next →configmaps secrets

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