KAI notebook / Kubernetes mainline
把 Kubernetes 寫成好懂又專業的筆記。
KAI K8s之路是我的 Kubernetes 主線筆記：先用生活例子抓直覺，再回到資源邊界和 production 行為。
我不想先背 YAML，也不想把這裡做成雲原生百科。這裡更像一本持續增長的 infra notebook：先把概念變成能理解的畫面，再把它接回 debug、設計與真實環境裡會出事的地方。
- 先記這句
- 每篇都要有一句能記住的核心判斷。
- 生活例子
- 每章都要用一個簡單例子先把直覺搭起來。
- 排查用途
- 最後要說清楚這個模型出事時能怎麼用。
Notebook rules
這個站的筆記怎麼寫
不是課綱，是筆記本
每篇先寫清楚：這個資源切哪個邊界、出事時先看哪裡、下一章會逼出什麼問題。
不是摘要，是 KAI 的判斷
同一個 Kubernetes 概念，要寫出我會怎麼記、怎麼 debug、怎麼把它放回 production 行為。
每章都要有生活例子
先用一個好懂的例子抓直覺，再回到 Pod、controller、traffic、probe 這些專業邊界。
Notebook sections
主線、排查、概念，各自有自己的用法
Mainline notebook
主線筆記
個人筆記感，先講生活例子，再拆概念、建心智模型，把 Kubernetes 寫成好懂但不降級的專業筆記。
Field notes
排查筆記
probe、rollout、GitOps、observability 的現場筆記，保留訊號、排查順序和誤判點。
Concept model
概念模型
把抽象概念變成一個能記住的 mental object，不只背名詞。
Current chapter
先從第一個邊界開始
Chapter 01 ZH + EN
KAI K8s之路 01｜Pod 是什麼？為什麼 Kubernetes 不直接管理 container
從 Kubernetes 最核心的抽象開始：Pod 到底在管什麼，為什麼平台不是直接管理單個 container，而是用 Pod 當最小調度單位。
KAI K8s之路 01｜Pod 是什麼？為什麼 Kubernetes 不直接管理 container
從 Kubernetes 最核心的抽象開始：Pod 到底在管什麼，為什麼平台不是直接管理單個 container，而是用 Pod 當最小調度單位。
EnglishKAI K8s之路 01 — English mirror: What a Kubernetes Pod is, and why it does not manage containers directly
Start with the core Kubernetes abstraction: what a Pod actually manages, and why Kubernetes schedules Pods instead of orchestrating containers directly.
Field notes
支線筆記用來補主線沒說完的現場行為
Concept model
GitOps review checklist before Argo CD syncs production
A compact pre-sync checklist for GitOps changes so an innocent YAML edit does not become surprising production behavior in Kubernetes.
排查筆記
Kubernetes 探針誤判：一次把服務打進重啟循環的 liveness probe 事故
有些事故不是程式壞掉，而是 liveness probe 把本來還能活下來的服務誤判成該重啟。這篇記一個很典型的 production 坑。
Concept model
Kubernetes deployment guardrails: probes, rollout settings, and fast triage
A compact baseline for readiness, liveness, rollout settings, and fast triage before a Kubernetes deployment turns into an outage.
Concept model
Agent observability in production: spans, tool events, and failure memory
Basic logging is not enough for agent systems in production; you need traces, tool-level outcomes, and a short path from failure back to prompt or policy.
Topic map