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

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

🪑↩️ धडा 09 — Self-heal: खुर्च्या वहीत लिहिल्याप्रमाणे परत जागेवर

📍 तुम्ही इथे आहात: 12 पैकी धडा 09 · मागील: lesson-08-sync-policies · पुढील: lesson-10-rollback-history

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

धडे 01–08, आणि त्यासोबत धडा 02 च्या वेदनेचे फळ: ArgoCD drift काही सेकंदांत ओळखून उलटवतो हे पाहणे — आणि मग बदल करण्याची योग्य पद्धत शिकणे (वही बदला!).

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

धडा 02 आठवतो? एका मुलाने खुर्च्या हलवल्या, तीन महिने कोणाच्याच लक्षात आले नाही, आणि एके दिवशी एका "reset" ने नोंद न केलेली प्रत्येक दुरुस्ती नष्ट केली. 😱

तीच शाळा, नवा केअरटेकर. एक मूल 15:00 ला खुर्च्या हलवते…

15:00:30 — robot ची फेरी त्या खोलीपर्यंत पोहोचते. वही म्हणते पुढे 2 खुर्च्या; खोलीत 5 आहेत. पिवळा फलक लगेच लागतो. 🟡
15:00:31 — selfHeal चालू आहे, म्हणून robot फक्त कळवत नाही — तो खुर्च्या परत जागेवर लावतो. खोली वहीशी जुळते. झाले. ↩️
मूल पुन्हा प्रयत्न करते. निकाल तोच. मूल खरा धडा शिकते: 🧑‍🎓 "मला 5 खुर्च्या हव्या असतील, तर ते वहीत लिहून घ्यावे लागेल" — एक git commit, review होऊन merge झालेला. मग robot आनंदाने 5 खुर्च्या लावतो, आणि वही खरी राहते.

Drift ला बंदी आली नाही — तो टिकवून ठेवणे अशक्य झाले. हाच नियम आणि reconcile loop यांतला फरक आहे.

🗺️ आकृती

flowchart LR
    hand["😈 you, by hand<br/>kubectl scale --replicas=5"]
    drift["🏫 cluster: 5 pods<br/>book says 2 → OutOfSync 🟡"]
    argo["🤖 ArgoCD selfHeal<br/>re-applies the book"]
    fixed["✅ back to 2 pods<br/>the book wins"]
    right["🧑‍🎓 the RIGHT way:<br/>edit git → PR → merge<br/>robot scales up happily"]
    hand -->|"1"| drift -->|"2 noticed in seconds"| argo -->|"3"| fixed
    fixed -.->|"4 want 5 for real?"| right

❓ काय

ArgoCD आपली तुलना सुमारे दर 3 मिनिटांनी refresh करतो (आणि webhooks/UI refresh वर लगेच), आणि selfHeal सापडलेला drift लगेच उलटवतो.
Drift म्हणून काय गणले जाते: render केलेल्या git state पासून live मधला कोणताही फरक — scale बदल, बदललेले env vars, delete केलेले resources (prune चे क्षेत्र), जोडलेली labels…
योग्य अपवाद आहेत: जर replicas एखाद्या HPA च्या ताब्यात असेल (k8s course, धडा 09!), तर ArgoCD ला ते एकच field ignore करायला सांगा (spec.ignoreDifferences) — नाहीतर robot आणि HPA मध्ये रस्सीखेच होईल. सर्वसाधारण नियम कायम आहे: माणसांच्या मालकीचे fields git मध्ये राहतात.

🤔 हे सर्वात जबरदस्त feature का आहे

धडा 04, खड्डा #1 — "दोन deploys दरम्यान खोलीवर कोणी लक्ष ठेवत नाही" — आता सरळ खोटे ठरते: काहीतरी प्रत्येक खोलीवर, दर काही मिनिटांनी, कायम लक्ष ठेवते, आणि त्याची "बरोबर" ची कल्पना म्हणजे review झालेली, version असलेली वही. Incidents "तीन महिन्यांचे रहस्यमय बदल" पासून आकुंचन पावून "ArgoCD ने 15:00:30 ला दाखवलेला diff" इतके होतात.

✅ खड्डा 1 बुजला. Drift एका refresh मध्ये (~3 मिनिटे, किंवा webhook सह काही सेकंद) ओळखला जातो आणि selfHeal सह उलटवला जातो — खोली आता गुपचूप वहीशी असहमत राहू शकत नाही.

🔧 कसे (नवीन काहीच configure करायचे नाही!)

हे तुमच्याकडे आधीच आहे: argocd/application.yaml मधले selfHeal: true (धडा 08). हा धडा केवळ प्रात्यक्षिक आहे.

🧪 करून पाहा — robot शी भांडण उकरून काढा

# round 1: FIGHT!
kubectl -n gitops-school scale deployment hello-school --replicas=5
kubectl -n gitops-school get pods -w
# ...watch the extra pods appear — and then get terminated within moments. Ctrl+C.

# round 2: sneakier — edit an env-ish detail:
kubectl -n gitops-school patch deployment hello-school --type merge \
  -p '{"spec":{"template":{"metadata":{"labels":{"hacked":"true"}}}}}'
kubectl -n gitops-school get deploy hello-school -o jsonpath='{.spec.template.metadata.labels}'
# wait ~a moment, check again: the label is GONE. The book wins. 🤖

# round 3: do it RIGHT — on your own fork:
#   edit k8s/deployment.yaml → replicas: 3 → commit & push
#   (point your Application's repoURL at your fork first)
# → within ~3 min: 3 pods, no fight, and git shows who wanted 3 and why. 🎉

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

Round 1: kubectl -n gitops-school get pods -w मध्ये तीन जास्तीचे pods दिसतात आणि मग काही क्षणांत Terminating होतात (webhook नसेल तर काही मिनिटांपर्यंत). Round 2: दुसऱ्या तपासणीत hacked label गेलेले असते. kubectl -n argocd get application hello-school कधीच OutOfSync वर टिकून राहत नाही. Round 3 (तुमचा fork): 3 pods, आणि git log दाखवतो की ते कोणाला हवे होते.

🧹 स्वच्छता

काहीही काढायचे नाही — robot ने तुमच्या मागे आधीच साफसफाई केली आहे. Round 3 तुमच्या fork च्या git history मध्ये राहतो, आणि मुद्दा तोच आहे.

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

revert ला 2–3 मिनिटे लागली म्हणून selfHeal बिघडला आहे असा निष्कर्ष काढणे — तो refresh interval आहे; webhook ने ते काही सेकंदांवर येते
HPA शी भांडणे: replicas एखाद्या autoscaler च्या ताब्यात असेल, तर ते field ignore करा (spec.ignoreDifferences) किंवा manifest मधून replicas काढून टाका
selfHeal आहे म्हणून PRs review करणे थांबवणे — वही जिंकते, म्हणून चुकीची वहीसुद्धा जिंकते

🏭 प्रत्यक्ष वापरात हे का महत्त्वाचे: selfHeal "कोणीतरी prod हाताने बदलले" याला रहस्याऐवजी timestamp असलेला diff बनवतो. हाताचे बदल दुर्मीळ करणाऱ्या RBAC (Kubernetes school L17) सोबत ते वापरा, आणि वारंवार होणाऱ्या OutOfSync → Synced उलटापालटीवर alert लावा — त्याचा अर्थ कोणीतरी robot शी भांडत आहे.

⏭️ पुढे

जर वही नेहमी जिंकते… तर वहीत काळात मागे जाणे म्हणजे rollback च असला पाहिजे. तसेच आहे — आणि ते अप्रतिम आहे.

git checkout lesson-10-rollback-history

🪑↩️ Lesson 09 — Self-heal: the chairs go back where the book says

📍 You are here: Lesson 09 of 12 · Previous: lesson-08-sync-policies · Next: lesson-10-rollback-history

📦 What's in this branch

Lessons 01–08, plus the payoff for lesson 02's pain: watching ArgoCD detect and revert drift in seconds — then learning the correct way to make changes (edit the book!).

🧒 Explain like I'm 5

Remember lesson 02? A kid moved the chairs, nobody noticed for three months, and one day a "reset" destroyed every unrecorded fix. 😱

Same school, new caretaker. A kid moves the chairs at 15:00…

15:00:30 — the robot's hall-walk reaches the room. Book says 2 chairs at the front; room has 5. Yellow sign goes up instantly. 🟡
15:00:31 — selfHeal is on, so the robot doesn't just report — it moves the chairs back. Room matches book. Done. ↩️
The kid tries again. Same result. The kid learns the real lesson: 🧑‍🎓 "if I want 5 chairs, I have to get it written into the book" — a git commit, reviewed and merged. Then the robot happily builds 5 chairs, and the book stays true.

Drift didn't become forbidden — it became impossible to sustain. That's the difference between a rule and a reconcile loop.

🗺️ Diagram

flowchart LR
    hand["😈 you, by hand<br/>kubectl scale --replicas=5"]
    drift["🏫 cluster: 5 pods<br/>book says 2 → OutOfSync 🟡"]
    argo["🤖 ArgoCD selfHeal<br/>re-applies the book"]
    fixed["✅ back to 2 pods<br/>the book wins"]
    right["🧑‍🎓 the RIGHT way:<br/>edit git → PR → merge<br/>robot scales up happily"]
    hand -->|"1"| drift -->|"2 noticed in seconds"| argo -->|"3"| fixed
    fixed -.->|"4 want 5 for real?"| right

❓ What

ArgoCD refreshes its comparison about every 3 minutes (plus instantly on webhooks/UI refresh), and selfHeal reverts detected drift right away.
What counts as drift: any live difference from rendered git state — scale changes, edited env vars, deleted resources (prune territory), added labels…
Legitimate exceptions exist: if an HPA owns replicas (k8s course, lesson 09!), you tell ArgoCD to ignore that one field (spec.ignoreDifferences) — otherwise robot and HPA would tug-of-war. The general rule stands: fields humans own live in git.

🤔 Why this is the killer feature

Lesson 04, gap #1 — "nobody watches the room between deploys" — is now simply false: something watches every room, every few minutes, forever, and its idea of "correct" is the reviewed, versioned book. Incidents shrink from "three months of mystery edits" to "the diff ArgoCD showed at 15:00:30".

✅ Gap 1 closed. Drift is detected within one refresh (~3 minutes, or seconds with a webhook) and, with selfHeal, reverted — the room can no longer quietly disagree with the book.

🔧 How (nothing new to configure!)

You already have it: selfHeal: true in argocd/application.yaml (lesson 08). This lesson is pure demonstration.

🧪 Try it — pick a fight with the robot

# round 1: FIGHT!
kubectl -n gitops-school scale deployment hello-school --replicas=5
kubectl -n gitops-school get pods -w
# ...watch the extra pods appear — and then get terminated within moments. Ctrl+C.

# round 2: sneakier — edit an env-ish detail:
kubectl -n gitops-school patch deployment hello-school --type merge \
  -p '{"spec":{"template":{"metadata":{"labels":{"hacked":"true"}}}}}'
kubectl -n gitops-school get deploy hello-school -o jsonpath='{.spec.template.metadata.labels}'
# wait ~a moment, check again: the label is GONE. The book wins. 🤖

# round 3: do it RIGHT — on your own fork:
#   edit k8s/deployment.yaml → replicas: 3 → commit & push
#   (point your Application's repoURL at your fork first)
# → within ~3 min: 3 pods, no fight, and git shows who wanted 3 and why. 🎉

✅ Verify — what you should see

Round 1: kubectl -n gitops-school get pods -w shows three extra pods appear and then go Terminating within moments (up to a few minutes without a webhook). Round 2: the hacked label is gone on the second check. kubectl -n argocd get application hello-school never stays OutOfSync. Round 3 (your fork): 3 pods, and git log shows who wanted them.

🧹 Clean up

Nothing to remove — the robot already cleaned up after you. Round 3 lives in your fork's git history, which is the point.

⚠️ Common mistakes

concluding selfHeal is broken because the revert took 2–3 minutes — that is the refresh interval; a webhook makes it seconds
fighting the HPA: if replicas is owned by an autoscaler, ignore that field (spec.ignoreDifferences) or drop replicas from the manifest
using selfHeal as a reason to stop reviewing PRs — the book wins, so a bad book wins too

🏭 Why this matters in production: selfHeal turns "somebody changed prod by hand" from a mystery into a diff with a timestamp. Pair it with RBAC (Kubernetes school L17) that makes hand edits rare, and alert on repeated OutOfSync → Synced flips — they mean someone is fighting the robot.

⏭️ Next

If the book always wins… then going back in time in the book must be a rollback. It is — and it's glorious.

git checkout lesson-10-rollback-history

← Previoussync policies Next →rollback history

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