{
 "byKey": {
  "cover": [
   {"say": "大家好,歡迎回到 Kubernetes 入門到實戰。這一章,我們要認識 Kubernetes 最小的部署單位 Pod,學會用 YAML 做宣告式管理,最後再看標籤和選擇器怎麼把物件串在一起。", "item": 0}
  ],
  "Pod:Kubernetes 最小的部署單位#1": [
   {"say": "先來想一個問題。在 Docker 的世界,我們操作的單位是容器。那為什麼到了 Kubernetes,最小的部署單位變成 Pod 呢?", "item": 0},
   {"say": "一個 Pod 裡面,包含一個或多個緊密合作的容器,它們有三個特性。", "item": 0},
   {"say": "第一,它們共用同一個網路命名空間,也就是同一個 I P,彼此可以用 localhost 互相連線。不過也因為這樣,它們不能同時監聽同一個埠。", "item": 1},
   {"say": "第二,它們可以共用儲存卷,英文叫 volume,例如同一個 empty Dir。", "item": 2},
   {"say": "第三,它們會一起被排程到同一台節點,一起啟動,也一起終止。", "item": 3},
   {"say": "絕大多數的情況,一個 Pod 只放一個應用容器。只有兩個容器必須緊緊綁在一起,例如主程式加上收集日誌的 sidecar,才會放在同一個 Pod。千萬不要為了省事,把前端和資料庫放進同一個 Pod,因為這樣它們就沒辦法各自擴縮了。", "item": 3}
  ],
  "Pod:Kubernetes 最小的部署單位#2": [
   {"say": "接下來這個觀念很重要,Pod 是用完即丟的。", "item": 0},
   {"say": "這是新手最容易誤解的地方。Pod 不是一台會被修好的伺服器。它被刪除,或是所在的節點故障之後,不會在原地復活。", "item": 1},
   {"say": "如果它是由控制器管理的,例如下一章要學的 Deployment,控制器會建立一個全新的 Pod,有新的名稱,也有新的 I P。", "item": 1},
   {"say": "如果是你自己直接建立的,我們叫它裸 Pod,節點壞掉之後,就不會有人幫你重建。所以正式環境幾乎不會直接建立裸 Pod,而是透過 Deployment、StatefulSet、Job 這些控制器。", "item": 1},
   {"say": "不過這一章,我們還是先用裸 Pod 來學基本概念,因為它是所有工作負載的基礎。", "item": 2}
  ],
  "Pod:Kubernetes 最小的部署單位#3": [
   {"say": "我們來看一份最簡單的 Pod YAML。完整的內容在後面一頁,這裡先講重點。", "item": 0},
   {"say": "這個 Pod 的名字叫 web,裡面只有一個容器,容器的名字叫 engine X,用的是 engine X unprivileged 這個映像。選它是為了讓容器用非 root 的身分執行。", "item": 1},
   {"say": "容器監聽的是八零八零號埠,因為一般使用者不能綁定一零二四以下的埠。另外,container Port 這個欄位只是文件性質的宣告,告訴看的人容器監聽哪個埠,就算不寫,容器還是連得到。", "item": 2},
   {"say": "再來是所有 Kubernetes 物件共同的四個頂層欄位。第一個是 A P I Version,表示這個物件屬於哪個 A P I 版本。Pod 屬於核心群組,寫 V 一就可以了。", "item": 3},
   {"say": "第二個是 kind,也就是物件的種類,這裡是 Pod。", "item": 4},
   {"say": "第三個是 metadata,放的是名稱、命名空間、標籤和註解。", "item": 5}
  ],
  "Pod:Kubernetes 最小的部署單位#4": [
   {"say": "還有第四個欄位。", "item": 0},
   {"say": "就是 spec,它描述的是你想要的狀態,也就是期望狀態。物件建立之後,系統還會自己加上一個 status 欄位,記錄實際的狀態。那是系統填的,你不需要寫。", "item": 1}
  ],
  "Pod:Kubernetes 最小的部署單位#5": [
   {"say": "我們對照畫面上的 YAML,再看一次這個骨架。", "item": 0},
   {"say": "第一行是 A P I Version,寫 V 一。", "item": 1},
   {"say": "第二行 kind,寫 Pod。", "item": 2},
   {"say": "metadata 底下,有名稱 web,還有一個標籤,app 冒號 web。", "item": 3},
   {"say": "spec 底下則是容器的清單,寫了容器的名稱、映像,還有埠號。以後不管寫哪一種物件,都是這四個部分。", "item": 4}
  ],
  "Pod:Kubernetes 最小的部署單位#6": [
   {"say": "Pod 建立之後,會經過不同的階段。Pod 的 phase 欄位,有這幾種值。", "item": 0},
   {"say": "Pending,表示已經被接受了,但是容器還沒有全部啟動,可能還在等排程,或是還在拉映像。", "item": 1},
   {"say": "Running,表示至少有一個容器正在執行。", "item": 2},
   {"say": "Succeeded,表示所有容器都成功結束,結束碼是零,而且不會再重啟,這在 Job 裡很常見。", "item": 3},
   {"say": "Failed,表示所有容器都已經結束,而且至少有一個是失敗的。", "item": 4},
   {"say": "Unknown,通常是和節點失去聯絡,拿不到狀態。", "item": 5},
   {"say": "要注意的是,用 get pods 看到的 STATUS 欄位會更細,像是 Container Creating、Crash Loop Back Off、Image Pull Back Off。這些不是 phase,而是從容器的狀態推導出來的顯示文字。", "item": 5}
  ],
  "Pod:Kubernetes 最小的部署單位#7": [
   {"say": "最後看重啟策略,欄位叫 restart Policy。", "item": 0},
   {"say": "它的預設值是 Always,意思是容器只要結束,不管成功還是失敗,kubelet 都會把它重啟。也可以設成 On Failure 或是 Never,常用在一次性的任務。", "item": 1},
   {"say": "另外,重啟會有指數退避的延遲,越等越久,最多大約五分鐘。這就是 Crash Loop Back Off 這個狀態的由來。", "item": 1}
  ],
  "YAML 宣告式管理:apply、diff 與 dry-run#1": [
   {"say": "好,接下來進入第二個單元,用 YAML 做宣告式管理。Kubernetes 有兩種操作風格。", "item": 0},
   {"say": "第一種是命令式,像 kube control 的 run、create、delete、scale,一個指令做一件事,適合快速實驗。", "item": 1},
   {"say": "第二種是宣告式,把期望狀態寫成 YAML 檔,再用 apply 減號 F 套用。檔案可以放進 Git 做版本控制、給同事審查、重複套用。這是正式環境的做法,也是大家常說的 GitOps 的基礎。", "item": 2},
   {"say": "我們把上一個單元的 YAML,存成 web pod 點 yaml 這個檔案,等一下就用它來練習。", "item": 3},
   {"say": "同一份檔案重複 apply 是安全的,這個特性叫做冪等。內容沒變,就顯示 unchanged。內容有變,就會更新,顯示 configured。", "item": 4},
   {"say": "另外,一個檔案裡面,可以用單獨一行的三個減號,分隔好幾個物件。", "item": 5}
  ],
  "YAML 宣告式管理:apply、diff 與 dry-run#2": [
   {"say": "我們實際操作一次。", "item": 0},
   {"say": "輸入 kube control apply 減號 F,後面接檔名。", "item": 1},
   {"say": "回應是 pod web created,表示 Pod 建立好了。", "item": 2},
   {"say": "同樣的指令,再執行一次。", "item": 3},
   {"say": "這次回應的是 unchanged,因為內容沒有改變,什麼事都不會發生。", "item": 4},
   {"say": "減號 F 後面也可以接一個目錄,像這裡的 manifests 資料夾,就會把整個目錄裡的檔案一次套用。", "item": 5}
  ],
  "YAML 宣告式管理:apply、diff 與 dry-run#3": [
   {"say": "那要刪除的時候呢?", "item": 0},
   {"say": "用同一份檔案就可以了。把 apply 換成 delete,一樣是減號 F 接檔名,檔案裡描述的物件就會被刪掉。", "item": 1}
  ],
  "YAML 宣告式管理:apply、diff 與 dry-run#4": [
   {"say": "在正式套用之前,最好先預覽一下。有兩個工具可以用,diff 和 dry run。", "item": 0},
   {"say": "diff 會顯示套用之後,和叢集現況有什麼差異。有差異的時候,它的結束碼會是一,這是正常的,不是出錯。", "item": 1},
   {"say": "dry run 設成 server 的時候,會由 A P I server 實際驗證,但是不會儲存,所以能抓到欄位寫錯,或是被准入控制拒絕的問題。如果設成 client,就只會在本機檢查。", "item": 2}
  ],
  "YAML 宣告式管理:apply、diff 與 dry-run#5": [
   {"say": "指令長這個樣子。", "item": 0},
   {"say": "第一行是 kube control diff,減號 F 接檔名。", "item": 1},
   {"say": "第二行是在 apply 的後面,多加兩個減號 dry run 等於 server。養成先預覽再套用的習慣,可以少掉很多意外。", "item": 2}
  ],
  "YAML 宣告式管理:apply、diff 與 dry-run#6": [
   {"say": "dry run 還有一個很實用的用法,就是幫你產生 YAML 範本。", "item": 0},
   {"say": "我們不必每次都從空白的檔案開始寫。", "item": 1},
   {"say": "執行之後,會得到一份包含 A P I Version、kind、metadata、spec 的範本,再用編輯器補上標籤、資源限制這些欄位就好。", "item": 2},
   {"say": "畫面上這一行的做法是,用 kube control run,指定映像和埠號,加上 dry run 等於 client,再用減號 O yaml 輸出,最後導向到檔案裡。", "item": 3},
   {"say": "產生出來的檔案,可能會有 creation Timestamp 是 null,還有空的 status,這兩個都可以刪掉。", "item": 3}
  ],
  "YAML 宣告式管理:apply、diff 與 dry-run#7": [
   {"say": "這裡要提醒一件事,Pod 的欄位大部分是不能改的。", "item": 0},
   {"say": "Pod 建立之後,spec 裡多數的欄位都不能修改。可以更新的只有少數,例如容器的映像。", "item": 1},
   {"say": "如果真的要改,就得刪掉再重建。或者改用 Deployment,由它建立新的 Pod 來取代舊的。這也是正式環境用 Deployment 來管理的原因。", "item": 2},
   {"say": "如果你改了別的欄位再 apply,就會看到畫面上這種錯誤訊息,說這個 Pod 是 invalid,spec 是 Forbidden,意思是不允許更動這些欄位。", "item": 3}
  ],
  "標籤、選擇器與註解#1": [
   {"say": "第三個單元,我們來談標籤。為什麼標籤這麼重要呢?", "item": 0},
   {"say": "因為在 Kubernetes 裡,物件和物件之間,幾乎都不是用名稱來互相指認,而是用標籤,也就是 label,加上選擇器,也就是 selector。", "item": 1},
   {"say": "Deployment 靠它找到自己的 Pod,Service 靠它決定把流量送給哪些 Pod。標籤寫錯,是 Service 連不到最常見的原因之一。", "item": 1}
  ],
  "標籤、選擇器與註解#2": [
   {"say": "那標籤到底是什麼?", "item": 0},
   {"say": "標籤是附加在物件 metadata 上面的鍵值對,用來做分類。", "item": 1},
   {"say": "像畫面上的例子,app 是 shop,tier 是 frontend,env 是 dev。一看就知道,這是商店應用的前端,在開發環境。", "item": 2},
   {"say": "規則是這樣的。鍵和值都是字串。值最長六十三個字元,只能用英文、數字、減號、底線和句點,而且開頭和結尾必須是英文或數字。鍵的前面可以再帶一個前綴。", "item": 3},
   {"say": "標籤要寫在 metadata 底下的 labels 裡面。官方也有建議一組通用的標籤,像是應用的名稱、實例和版本。團隊內部把命名統一,以後篩選起來會容易很多。", "item": 4}
  ],
  "標籤、選擇器與註解#3": [
   {"say": "有了標籤,就可以用它來篩選。選擇器有兩種寫法。", "item": 0},
   {"say": "第一種是等值式,就是比較等於或不等於。", "item": 1},
   {"say": "第二種是集合式,用 in、not in 和 exists,判斷值是不是在某個集合裡面,或是有沒有這個鍵。實際的指令,我們看下一頁。", "item": 2}
  ],
  "標籤、選擇器與註解#4": [
   {"say": "先看怎麼把標籤顯示出來。", "item": 0},
   {"say": "在 get pods 後面,加上兩個減號 show labels。", "item": 1},
   {"say": "輸出的最右邊,就會多一個 LABELS 欄位。", "item": 2},
   {"say": "可以看到 web 這個 Pod 有三個標籤,app 是 web,env 是 dev,tier 是 frontend。", "item": 3}
  ],
  "標籤、選擇器與註解#5": [
   {"say": "接著用小寫的減號 L 來篩選。", "item": 0},
   {"say": "第一個,只列出 app 等於 web 的 Pod。", "item": 1},
   {"say": "第二個,用逗號隔開兩個條件。逗號是而且的意思,所以是 app 等於 web,而且 env 等於 dev。", "item": 2},
   {"say": "第三個是集合式的寫法,env 是 dev 或 test 其中一個都算。", "item": 3},
   {"say": "第四個是不等於,列出 tier 不是 frontend 的 Pod。", "item": 4}
  ],
  "標籤、選擇器與註解#6": [
   {"say": "還有兩個用法。", "item": 0},
   {"say": "在鍵的前面加一個驚嘆號,表示沒有這個鍵。這裡就是列出沒有 canary 這個標籤的 Pod。", "item": 1},
   {"say": "另一個是大寫的減號 L,它不是篩選,而是把指定的標籤值變成欄位顯示出來,這裡是 app 和 env。大小寫的意思不一樣,請不要搞混了。", "item": 2}
  ],
  "標籤、選擇器與註解#7": [
   {"say": "最後,標籤也可以即時增加或刪除。", "item": 0},
   {"say": "這在除錯的時候很有用。比如把某個有問題的 Pod 的 app 標籤改掉,它就會脫離 Service 和 Deployment 的管理,留在原地讓你慢慢調查,而 Deployment 會另外補一個新的 Pod。", "item": 1},
   {"say": "用 kube control label pod,後面接 Pod 的名稱和標籤,就能加上新的標籤,這裡是 version 等於 V 一。", "item": 2},
   {"say": "如果要修改已經存在的標籤,後面必須加上兩個減號 overwrite。", "item": 3},
   {"say": "要刪除標籤的話,在鍵的名稱後面加一個減號就可以了。", "item": 4}
  ],
  "closing": [
   {"say": "這一章就到這裡。你已經認識了 Pod,會用 apply、diff 和 dry run 做宣告式管理,也知道標籤和選擇器的用法了。", "item": 0},
   {"say": "接下來,請親手做一次實作練習,再完成章末小測驗,看看自己學會了多少。我們下一章見!", "item": 1, "pause": 1}
  ]
 }
}
