🤖 धडा 06 — ArgoCD install करा: robot शाळेत राहायला येतो

📍 तुम्ही इथे आहात: 12 पैकी धडा 06 · मागे: lesson-05-gitops-idea · पुढे: lesson-07-first-application

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

धडे 01–05, आणि त्यासोबत: तुमच्या local cluster मध्ये ArgoCD install करणे आणि फेरफटका मारणे — UI, CLI, आणि प्रत्येक हलणारा भाग काय करतो.

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

नेमणुकीचा दिवस! 🎉 केअरटेकर robot 🤖 एका मोठ्या खोक्यात येतो (एकच install manifest). तुम्ही ते खोके शाळेच्या आत उघडता, आणि त्याचे भाग बाहेर येतात:

त्याचे डोळे आणि चेहरा 🖥️ (argocd-server + web UI) — ती खिडकी जिथून तुम्हाला robot ला जे दिसते ते दिसते: हिरव्या खोल्या, पिवळ्या खोल्या, diffs.
त्याचे ग्रंथालय कार्ड 📖 (repo-server) — हा भाग चालत ग्रंथालयात जातो आणि प्लॅन-वही घेऊन येतो (git repos clone करतो).
त्याचे पाय आणि हात 🔄 (application-controller) — हा भाग व्हरांड्यांतून फिरत खोल्यांची वहीशी तुलना करतो आणि फरक दुरुस्त करतो. हाच तो reconcile loop.

नेमणुकीचे महत्त्वाचे तपशील: robot त्याच्या स्वतःच्या खोलीत राहतो (namespace argocd), आणि तो शून्य मतांनी सुरुवात करतो — तुम्ही त्याला प्लॅनचे पहिले पान देईपर्यंत (धडा 07) तो काहीच करत नाही.

🗺️ आकृती

flowchart LR
    you["🧑‍💻 you<br/>one kubectl apply"]
    subgraph cluster["🏫 your cluster"]
        subgraph ns["🚪 namespace: argocd"]
            ui["🖥️ argocd-server<br/>API + web UI"]
            repo["📖 repo-server<br/>clones git repos"]
            ctrl["🔄 application-controller<br/>the reconcile loop"]
        end
    end
    you -->|"1 install manifest"| ns
    you -->|"2 port-forward :8080<br/>login admin"| ui
    ctrl -.->|"3 waits patiently<br/>for its first plan page"| ctrl

❓ काय

ArgoCD हा Kubernetes साठीचा CNCF-graduated GitOps controller आहे — सगळ्यात लोकप्रिय (Flux हे दुसरे मोठे नाव; कल्पना तीच, पण built-in UI नाही).
तो Kubernetes मध्ये नवे resource types जोडतो — त्यातला सगळ्यात महत्त्वाचा Application (धडा 07) — आणि Kubernetes जसे Deployments reconcile करते तसे तो त्यांना reconcile करतो.
UI खरोखरच उत्कृष्ट आहे आणि ArgoCD जिंकण्याचे अर्धे कारण तेच आहे: तुम्हाला app tree (Application → Deployment → ReplicaSet → Pods), sync status, live diffs, आणि history दिसते.

🤔 प्रत्येक cluster मध्ये का install करायचा?

कारण pull-based म्हणजे प्रत्येक cluster स्वतःवर पहारा देतो: त्याचा agent, त्याच्या keys आतच राहतात, वहीकडे पाहण्याची त्याची स्वतःची नजर. (एकच ArgoCD अनेक clusters मध्यवर्तीपणे सांभाळू शकतो — हा देखील योग्य setup आहे, त्याचे फायदे-तोटे आहेत; आधी साधा आकार शिका.)

🔧 कसे + 🧪 करून पाहा

# 1) hire the robot (any local cluster):
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

# 2) wait for its parts to assemble:
kubectl -n argocd get pods -w        # ~1–2 min until all Running; Ctrl+C

# 3) open its face:
kubectl -n argocd port-forward svc/argocd-server 8080:443 &
kubectl -n argocd get secret argocd-initial-admin-secret \
  -o jsonpath='{.data.password}' | base64 -d; echo
# browse https://localhost:8080 → login: admin + that password
# (self-signed cert warning is expected locally — proceed)

# 4) optional but nice — the CLI:
brew install argocd
argocd login localhost:8080 --username admin --insecure

# 5) look around the UI: zero Applications. The robot is hired,
#    bored, and waiting for lesson 07. 🤖💤

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

kubectl -n argocd get pods → सगळे Running: argocd-server, argocd-repo-server, argocd-application-controller-0, आणि redis, dex आणि notifications. https://localhost:8080 वरचा UI admin + initial password स्वीकारतो आणि शून्य Applications दाखवतो.

🧹 साफसफाई

धडे 07–12 साठी ArgoCD install केलेला राहू द्या. नंतर तो पूर्णपणे काढायचा असेल तर: आधी तुमचे Applications delete करा (धडा 07 ची साफसफाई), मग kubectl delete -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml && kubectl delete namespace argocd. Cloud cluster वर यामुळे पैसे लागणारे काहीच थांबत नाही — cluster स्वतः नष्ट होईपर्यंत nodes आणि load balancers चे bill येत राहते.

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

port-forward background मध्ये चालू ठेवणे (jobs, kill %1) आणि पुढच्या वेळी :8080 व्यस्त का आहे याचे आश्चर्य वाटणे
admin password बदलणे आणि तो हरवणे — argocd-initial-admin-secret पहिल्या login नंतर delete करण्यासाठीच असतो
चुकून खऱ्या cluster मध्ये install करणे — आधी kubectl config current-context पाहा

🏭 प्रत्यक्ष वापरात हे का महत्त्वाचे आहे: खऱ्या installs मध्ये Helm chart किंवा operator वापरतात, admin user ऐवजी SSO, HA mode (sharded controllers, redis HA), आणि ArgoCD स्वतःलाही ArgoCD कडूनच सांभाळले जाते (app-of-apps, धडा 11). एका file चे install फक्त शिकण्यासाठी आहे.

⏭️ पुढे

Robot ला प्लॅनचे पहिले पान द्या: हाच repo deploy करणारे Application.

git checkout lesson-07-first-application

🤖 Lesson 06 — Install ArgoCD: the robot moves into the school

📍 You are here: Lesson 06 of 12 · Previous: lesson-05-gitops-idea · Next: lesson-07-first-application

📦 What's in this branch

Lessons 01–05, plus: installing ArgoCD into your local cluster and taking the tour — UI, CLI, and what each moving part does.

🧒 Explain like I'm 5

Hiring day! 🎉 The caretaker robot 🤖 arrives in one big box (a single install manifest). You open the box inside the school, and out come its parts:

Its eyes and face 🖥️ (argocd-server + web UI) — the window where YOU see what the robot sees: green rooms, yellow rooms, diffs.
Its library card 📖 (repo-server) — the part that walks to the library and fetches the plan book (clones git repos).
Its legs and hands 🔄 (application-controller) — the part that walks the halls comparing rooms to the book and fixing differences. This is the reconcile loop itself.

Important hiring details: the robot lives in its own room (namespace argocd), and it starts with zero opinions — it does nothing until you hand it its first plan page (lesson 07).

🗺️ Diagram

flowchart LR
    you["🧑‍💻 you<br/>one kubectl apply"]
    subgraph cluster["🏫 your cluster"]
        subgraph ns["🚪 namespace: argocd"]
            ui["🖥️ argocd-server<br/>API + web UI"]
            repo["📖 repo-server<br/>clones git repos"]
            ctrl["🔄 application-controller<br/>the reconcile loop"]
        end
    end
    you -->|"1 install manifest"| ns
    you -->|"2 port-forward :8080<br/>login admin"| ui
    ctrl -.->|"3 waits patiently<br/>for its first plan page"| ctrl

❓ What

ArgoCD is a CNCF-graduated GitOps controller for Kubernetes — the most popular one (Flux is the other big name; same idea, no built-in UI).
It extends Kubernetes with new resource types — most importantly Application (lesson 07) — and reconciles them like Kubernetes reconciles Deployments.
The UI is genuinely excellent and half the reason ArgoCD won: you see the app tree (Application → Deployment → ReplicaSet → Pods), sync status, live diffs, and history.

🤔 Why install it per cluster?

Because pull-based means each cluster guards itself: its agent, its keys staying inside, its view of the book. (One ArgoCD can also manage many clusters centrally — a valid setup with trade-offs; learn the simple shape first.)

🔧 How + 🧪 Try it

# 1) hire the robot (any local cluster):
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

# 2) wait for its parts to assemble:
kubectl -n argocd get pods -w        # ~1–2 min until all Running; Ctrl+C

# 3) open its face:
kubectl -n argocd port-forward svc/argocd-server 8080:443 &
kubectl -n argocd get secret argocd-initial-admin-secret \
  -o jsonpath='{.data.password}' | base64 -d; echo
# browse https://localhost:8080 → login: admin + that password
# (self-signed cert warning is expected locally — proceed)

# 4) optional but nice — the CLI:
brew install argocd
argocd login localhost:8080 --username admin --insecure

# 5) look around the UI: zero Applications. The robot is hired,
#    bored, and waiting for lesson 07. 🤖💤

✅ Verify — what you should see

kubectl -n argocd get pods → everything Running: argocd-server, argocd-repo-server, argocd-application-controller-0, plus redis, dex and notifications. The UI at https://localhost:8080 accepts admin + the initial password and shows zero Applications.

🧹 Clean up

Keep ArgoCD installed for lessons 07–12. To remove it completely later: delete your Applications first (lesson 07's clean-up), then kubectl delete -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml && kubectl delete namespace argocd. On a cloud cluster this stops nothing that costs money — nodes and load balancers bill until the cluster itself is destroyed.

⚠️ Common mistakes

leaving the port-forward running in the background (jobs, kill %1) and wondering why :8080 is busy next time
rotating the admin password and losing it — argocd-initial-admin-secret is meant to be deleted after the first login
installing into a real cluster by accident — kubectl config current-context first

🏭 Why this matters in production: real installs use the Helm chart or the operator, SSO instead of the admin user, HA mode (sharded controllers, redis HA), and keep ArgoCD itself managed by ArgoCD (app-of-apps, lesson 11). The one-file install is for learning.

⏭️ Next

Hand the robot its first plan page: the Application that deploys this very repo.

git checkout lesson-07-first-application

← Previousgitops idea Next →first application

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