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

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

🎒 धडा 01 — हाताने deploy: तुम्हीच deploy system आहात

📍 तुम्ही इथे आहात: 12 पैकी धडा 01 · पुढे: lesson-02-drift-problem

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

संपूर्ण कोर्सची सुरुवात: demo app प्रत्येकजण जसा सुरुवात करतो तसा deploy करणे — हाताने, kubectl वापरून, तुमच्या laptop वरून. ते चालते! आणि हा धडा संपेपर्यंत तुम्हाला नेमके दिसेल की ते असेच का राहू शकत नाही. खऱ्या files:

k8s/ — demo app: namespace + deployment (2 pods) + service

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

तुम्हाला गृहपाठ जमा करायचा आहे. म्हणून तुम्ही तो स्वतः शाळेत घेऊन जाता 🎒 — आत जाता, शिक्षिकेच्या टेबलावर ठेवता, झाले. अगदी ठीक!

आता कल्पना करा की हे प्रत्येक विषयासाठी, रोज, संपूर्ण वर्गासाठी करावे लागते, कारण कसे कोण जाणे तुम्हीच गृहपाठ पोहोचवणारे मूल बनला आहात:

तुम्ही आजारी पडलात? 🤒 काहीच पोहोचत नाही.
तुम्ही एक वही विसरलात? शिक्षिका ओरडेपर्यंत कोणाच्या लक्षात येत नाही.
तुमचा मित्रही काही गृहपाठ, वेगळ्या पद्धतीने, पोहोचवतो? आता काय जमा झाले याबद्दल दोन लोकांच्या आठवणी जुळत नाहीत.
शिक्षिका विचारते "हे कधी जमा झाले, आणि कोणी केले?" — तुमचे उत्तर म्हणजे फक्त खांदे उडवणे. 🤷

हाताने पोहोचवणे चुकीचे नाही — त्यातूनच तुम्ही रस्ता शिकता. पण शेवटी हा रस्ता तुमच्याशिवाय चालायला हवा.

🗺️ आकृती

flowchart LR
    you["🧑‍💻 your laptop<br/>YAML + kubeconfig 🔑"]
    cluster["🏫 cluster<br/>🪑🪑 hello-school pods"]
    later["📅 one week later<br/>❓ which version is live?<br/>❓ who changed what?<br/>😱 only your memory knows"]
    you -->|"1 kubectl apply -f k8s/"| cluster
    cluster -.->|"2 works today! 🎉"| later

❓ काय

kubectl apply -f तुमचे local YAML cluster च्या API server ला पाठवते — हा एक manual, push-style deploy आहे, ज्यात "pipeline" म्हणजे तुमची बोटे.
Deploy ची "नोंद" म्हणजे तुमची shell history. Rollback चा आराखडा म्हणजे तुमची आठवण.
शिकण्यासाठी आणि प्रयोगांसाठी हे 100% ठीक आहे — आणि प्रत्येकाने अशीच सुरुवात करायला हवी, म्हणजे पुढचे automation जादू वाटणार नाही.

🤔 का (हा धडा का आहे)

ArgoCD पासूनच सुरुवात करून तुम्हाला ArgoCD ची किंमत कळणार नाही — तुम्ही फक्त एखादा विधी पाळत राहाल. हा कोर्स तुम्हाला प्रत्येक उपाय भेटण्याआधी त्याची समस्या अनुभवायला लावतो: धडा 02 मूक मारेकरी (drift) दाखवतो, धडा 03 पोहोचवणे automate करतो, धडा 04 दाखवतो की अजूनही काय तुटलेले आहे, आणि भाग 2 ते नीट दुरुस्त करतो.

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

Demo app मुद्दाम अगदी छोटे ठेवले आहे — nginxdemos/hello:plain-text चालवणारे एक Deployment (ते त्याच्या pod च्या नावाने उत्तर देते, म्हणजे कोणत्या pod ने उत्तर दिले ते तुम्हाला प्रत्यक्ष दिसते), एक Service, एक namespace. कुठेही placeholders नाहीत — k8s/ मधले सगळे कोणत्याही local cluster वर जसेच्या तसे apply होते.

🧪 करून पाहा

# any local cluster: Docker Desktop's Kubernetes, minikube start, or kind
kubectl apply -f k8s/
kubectl -n gitops-school get pods          # 2 pods

# see WHICH pod answers (run it a few times — the name changes!):
kubectl -n gitops-school run t --rm -it --image=curlimages/curl --restart=Never \
  -- curl -s http://hello-school

# now the uncomfortable questions:
kubectl -n gitops-school get deploy hello-school -o jsonpath='{.spec.template.spec.containers[0].image}'
# ...is that what YOU think is deployed? what would your teammate say?
history | grep "kubectl apply" | tail -3   # ← this is your entire audit trail 😬

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

kubectl -n gitops-school get deploy,svc,pods

→ hello-school 2/2 READY आहे, एक ClusterIP Service, दोन Running pods. मग kubectl -n gitops-school port-forward deploy/hello-school 8080:80 चालवा आणि curl localhost:8080 pod च्या नावासह hello page छापते.

🧹 साफसफाई

अजून काहीच काढायचे नाही — धडे 02–04 हेच deployment पुन्हा वापरतात. इथेच थांबताय? kubectl delete namespace gitops-school.

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

चुकीच्या cluster वर apply करणे — आधी kubectl config current-context पाहा; संपूर्ण कोर्स local cluster गृहीत धरतो
-n gitops-school विसरणे आणि काहीच चालू नाही असा निष्कर्ष काढणे
हा धडा "चुकीची पद्धत" मानणे — पुढचा प्रत्येक धडा ज्याच्याशी तुलना करून मोजला जातो तो हा पाया आहे

🏭 प्रत्यक्ष वापरात हे का महत्त्वाचे आहे: हाताने deploy अजूनही होतात — incidents च्या वेळी, रस्ता माहीत असलेल्या एकाच व्यक्तीकडून. पुढचा प्रत्येक धडा त्या व्यक्तीची गरज संपवण्यासाठी आहे; तोपर्यंत निदान तो रस्ता runbook म्हणून लिहून ठेवा.

⏭️ पुढे

App चालू राहू द्या — धडा 02 त्याची थोडी मोडतोड करणार आहे, हाताने चालवलेल्या clusters चा मूक मारेकरी दाखवण्यासाठी: drift.

git checkout lesson-02-drift-problem

🎒 Lesson 01 — Deploy by hand: you ARE the deploy system

📍 You are here: Lesson 01 of 12 · Next: lesson-02-drift-problem

📦 What's in this branch

The starting point of the whole course: deploying the demo app the way everyone starts — by hand, with kubectl, from your laptop. It works! And by the end of this lesson you'll see exactly why it can't stay this way. Real files:

k8s/ — the demo app: namespace + deployment (2 pods) + service

🧒 Explain like I'm 5

You have homework to hand in. So you carry it to school yourself 🎒 — walk in, put it on the teacher's desk, done. Perfectly fine!

Now imagine doing that for every subject, every day, for the whole class, because somehow you became the homework-delivery kid:

You're sick? 🤒 Nothing gets delivered.
You forget one notebook? Nobody notices until the teacher shouts.
Your friend also delivers some homework, differently? Now two people's memories disagree about what was handed in.
Teacher asks "when was this handed in, and by whom?" — your answer is a shrug. 🤷

Hand-delivery isn't wrong — it's how you learn the route. But the route must eventually run without you.

🗺️ Diagram

flowchart LR
    you["🧑‍💻 your laptop<br/>YAML + kubeconfig 🔑"]
    cluster["🏫 cluster<br/>🪑🪑 hello-school pods"]
    later["📅 one week later<br/>❓ which version is live?<br/>❓ who changed what?<br/>😱 only your memory knows"]
    you -->|"1 kubectl apply -f k8s/"| cluster
    cluster -.->|"2 works today! 🎉"| later

❓ What

kubectl apply -f sends your local YAML to the cluster's API server — a manual, push-style deploy where the "pipeline" is your fingers.
The deploy "record" is your shell history. The rollback plan is your memory.
This is 100% fine for learning and experiments — and how everyone should start, so the automation later isn't magic.

🤔 Why (this lesson exists)

You can't appreciate ArgoCD by starting with ArgoCD — you'd just be following ceremony. This course makes you feel each problem before meeting its fix: lesson 02 shows the silent killer (drift), lesson 03 automates the delivery, lesson 04 shows what's still broken, and Part 2 fixes it properly.

🔧 How (in this repo)

The demo app is deliberately tiny — one Deployment running nginxdemos/hello:plain-text (it answers with its pod name, so you can SEE which pod replied), one Service, one namespace. No placeholders — everything in k8s/ applies as-is on any local cluster.

🧪 Try it

# any local cluster: Docker Desktop's Kubernetes, minikube start, or kind
kubectl apply -f k8s/
kubectl -n gitops-school get pods          # 2 pods

# see WHICH pod answers (run it a few times — the name changes!):
kubectl -n gitops-school run t --rm -it --image=curlimages/curl --restart=Never \
  -- curl -s http://hello-school

# now the uncomfortable questions:
kubectl -n gitops-school get deploy hello-school -o jsonpath='{.spec.template.spec.containers[0].image}'
# ...is that what YOU think is deployed? what would your teammate say?
history | grep "kubectl apply" | tail -3   # ← this is your entire audit trail 😬

✅ Verify — what you should see

kubectl -n gitops-school get deploy,svc,pods

→ hello-school is 2/2 READY, one ClusterIP Service, two Running pods. Then kubectl -n gitops-school port-forward deploy/hello-school 8080:80 and curl localhost:8080 prints the hello page with the pod's name in it.

🧹 Clean up

Nothing to remove yet — lessons 02–04 reuse this deployment. Stopping here? kubectl delete namespace gitops-school.

⚠️ Common mistakes

applying to the wrong cluster — kubectl config current-context first; the whole course assumes a local cluster
forgetting -n gitops-school and concluding nothing is running
treating this lesson as "the wrong way" — it is the baseline every later lesson is measured against

🏭 Why this matters in production: hand deploys still happen — during incidents, by the one person who knows the route. Every later lesson exists to make that person unnecessary; until then, at least keep the route written down as a runbook.

⏭️ Next

Leave the app running — lesson 02 is going to vandalize it a little, to show you the silent killer of hand-run clusters: drift.

git checkout lesson-02-drift-problem

← Course homeall lessons Next →drift problem

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