{
 "byKey": {
  "cover": [
   {"say": "大家好,歡迎回到 Kubernetes 入門到實戰。這一章的主角是 Deployment。我們會學怎麼用它管理副本、擴縮、做滾動更新和回滾,最後再認識其他幾種工作負載控制器。", "item": 0}
  ],
  "ReplicaSet 與 Deployment#1": [
   {"say": "先想一個問題,為什麼不直接用 Pod 就好了呢?", "item": 0},
   {"say": "上一章說過,裸 Pod 壞了就沒了。我們需要一個看守者,持續確認符合條件的 Pod 數量,等於我要求的數量,少了就補,多了就刪。這就是 ReplicaSet 的工作。", "item": 1},
   {"say": "而 Deployment 又在 ReplicaSet 的上面,多了版本更新和回滾的能力。實務上,你幾乎只會直接建立 Deployment。", "item": 1},
   {"say": "我們來看這三者的關係。", "item": 2},
   {"say": "Deployment 管理多個 ReplicaSet,每一個版本對應一個。", "item": 3},
   {"say": "ReplicaSet 管理多個 Pod,負責維持副本的數量。", "item": 4},
   {"say": "而 Pod,就是真正執行容器的地方。一層管一層,這樣記就很清楚了。", "item": 5}
  ],
  "ReplicaSet 與 Deployment#2": [
   {"say": "接著來看 Deployment 的 YAML,完整的內容在後面,這裡先看重點欄位。", "item": 0},
   {"say": "裡面的容器和上一章一樣,名字叫 engine X。", "item": 1},
   {"say": "監聽的也是八零八零號埠。另外,範本裡還加了一些安全設定,例如要求用非 root 的身分執行、不允許提升權限。", "item": 2},
   {"say": "第一個重點,A P I Version 要寫 apps 斜線 V 一,不是單純的 V 一。", "item": 3},
   {"say": "第二個是 spec 底下的 replicas,也就是想要的副本數,這裡是三個。如果不寫,預設是一個。", "item": 4},
   {"say": "第三個是 selector 底下的 match Labels,這是 Deployment 用來認領 Pod 的條件。", "item": 5}
  ],
  "ReplicaSet 與 Deployment#3": [
   {"say": "還有兩個重點。", "item": 0},
   {"say": "spec 底下的 template,是 Pod 的範本。它的內容,就是上一章學的 Pod 規格,包含 metadata 裡的標籤,還有 spec。", "item": 1},
   {"say": "然後是最關鍵的規則。selector 的 match Labels,必須比對得到 template 裡面的標籤,不然就會出現 selector does not match template labels 這個錯誤。另外,selector 在建立之後是不能修改的。", "item": 2}
  ],
  "ReplicaSet 與 Deployment#4": [
   {"say": "我們對照畫面上的 YAML 看一次。", "item": 0},
   {"say": "A P I Version 是 apps 斜線 V 一。", "item": 1},
   {"say": "kind 是 Deployment。", "item": 2},
   {"say": "metadata 裡面,名稱是 web,標籤是 app 冒號 web。", "item": 3},
   {"say": "spec 裡面有三個部分,副本數三個、selector,還有 Pod 的範本。請注意 selector 和範本裡的標籤,寫的都是 app 冒號 web,兩邊是對得起來的。", "item": 4}
  ],
  "ReplicaSet 與 Deployment#5": [
   {"say": "寫好之後,我們把它建立起來,觀察一下結果,指令在後面兩頁。", "item": 0},
   {"say": "這裡先說明 Pod 的名稱。它是由三段組成的,Deployment 的名稱,加上 ReplicaSet 的雜湊,再加上隨機的字尾。你實際看到的雜湊,會和畫面上不一樣。", "item": 1}
  ],
  "ReplicaSet 與 Deployment#6": [
   {"say": "我們一行一行來看。", "item": 0},
   {"say": "先用 apply 減號 F,套用 Deployment 的 YAML 檔。", "item": 1},
   {"say": "看到 created,表示建立成功。", "item": 2},
   {"say": "接著用 get deployment web 查看它。", "item": 3},
   {"say": "欄位的意思是這樣的。READY 是就緒的數量和期望的數量。UP TO DATE 是已經更新到最新範本的副本數。AVAILABLE 是可以對外服務的副本數。", "item": 4},
   {"say": "這裡看到三分之三,三個副本全部就緒。", "item": 5},
   {"say": "再來,用 get 同時查 R S 和 pods,R S 就是 ReplicaSet 的縮寫,並且用減號 L 篩選 app 等於 web 的標籤。", "item": 6}
  ],
  "ReplicaSet 與 Deployment#7": [
   {"say": "結果分成兩段。", "item": 0},
   {"say": "第一段是 ReplicaSet,欄位有期望數量、目前數量,還有就緒數量。", "item": 1},
   {"say": "可以看到,Deployment 自動幫我們建立了一個 ReplicaSet,三個數字都是三。", "item": 2},
   {"say": "第二段是 Pod 的清單。會有三個 Pod,狀態都是 Running,名稱的前面,都帶著同一個 ReplicaSet 的雜湊。", "item": 3}
  ],
  "擴縮、滾動更新與回滾#1": [
   {"say": "好,第二個單元,先來學擴縮,英文是 scale。", "item": 0},
   {"say": "流量增加的時候,我們可以把副本數調大。", "item": 1},
   {"say": "用 scale 指令是命令式的做法,適合臨時調整。長期來說,應該去修改 YAML 裡的 replicas 再 apply,讓 Git 裡的內容和叢集一致,不然下一次 apply,數字又會被蓋回去。", "item": 2},
   {"say": "也可以自動擴縮。Horizontal Pod Autoscaler,簡稱 H P A,可以依照 C P U 這類指標,自動調整副本數。", "item": 3},
   {"say": "不過它需要叢集裝有 metrics server,而且容器必須設定 C P U 的 requests,這個第七章會講,不然 H P A 沒辦法計算使用率。本機叢集預設不一定有 metrics server,這裡先了解概念就可以了。", "item": 4}
  ],
  "擴縮、滾動更新與回滾#2": [
   {"say": "來看手動擴縮的指令。", "item": 0},
   {"say": "kube control scale deployment web,後面用兩個減號 replicas,把副本數指定成五個。", "item": 1},
   {"say": "回應 scaled,表示調整好了。", "item": 2},
   {"say": "再用 get deployment web 確認一下。", "item": 3},
   {"say": "欄位和剛剛一樣。", "item": 4},
   {"say": "READY 已經變成五分之五,五個副本都上線了。", "item": 5}
  ],
  "擴縮、滾動更新與回滾#3": [
   {"say": "再看自動擴縮的指令。", "item": 0},
   {"say": "用 kube control autoscale,指定最少兩個、最多六個副本,並且把 C P U 使用率的目標設在百分之七十。超過了就加副本,降下來就減少。", "item": 1}
  ],
  "擴縮、滾動更新與回滾#4": [
   {"say": "接下來是這一章的重頭戲,滾動更新。", "item": 0},
   {"say": "Deployment 的 template 只要一改變,最常見的就是改映像,就會觸發一次 rollout。它會建立新的 ReplicaSet,逐步增加新的 Pod,同時減少舊的 Pod。", "item": 1},
   {"say": "用 set image 更新的時候,格式是容器名稱等於新映像。這裡的 engine X,指的是 YAML 裡 containers 的 name,不是映像的名稱。", "item": 2},
   {"say": "宣告式的做法,則是直接修改 YAML 裡的 image 再 apply,結果一樣,而且會保留在版本控制裡。", "item": 2},
   {"say": "要注意,只改 replicas 是不會觸發 rollout 的,因為副本數不屬於 Pod 範本。", "item": 3}
  ],
  "擴縮、滾動更新與回滾#5": [
   {"say": "實際做一次。", "item": 0},
   {"say": "用 set image,把 web 這個 Deployment 裡的 engine X 容器,換成一點二七版的映像。", "item": 1},
   {"say": "回應 image updated。", "item": 2},
   {"say": "接著用 rollout status 觀察更新的進度。", "item": 3},
   {"say": "它會告訴你,正在等待 rollout 完成,五個新副本裡已經更新了兩個。", "item": 4}
  ],
  "擴縮、滾動更新與回滾#6": [
   {"say": "繼續看下去。", "item": 0},
   {"say": "接著顯示,還有一個舊的副本正在等待終止。", "item": 1},
   {"say": "最後出現 successfully rolled out,就代表整個更新完成了,過程中服務沒有中斷。", "item": 2}
  ],
  "擴縮、滾動更新與回滾#7": [
   {"say": "更新之後如果發現有問題,可以查看歷史,然後回滾。", "item": 0},
   {"say": "用 rollout history 可以列出每一個版本。rollout undo 會退回上一版,也可以用 to revision 指定要退回哪一個版本。", "item": 0},
   {"say": "歷史清單裡的 CHANGE CAUSE 欄位預設是空的,可以用 annotate 加上註解來補充說明,例如寫上升級到哪一版。", "item": 1},
   {"say": "Deployment 預設會保留十個舊版本的 ReplicaSet,這個數字可以用 revision History Limit 調整。所謂回滾,其實就是讓舊的 ReplicaSet 再度成為主要版本。", "item": 2}
  ],
  "更新策略參數與其他工作負載#1": [
   {"say": "第三個單元,我們來看怎麼控制更新的步調。Deployment 預設的更新策略叫 Rolling Update,有兩個關鍵參數。", "item": 0},
   {"say": "第一個是 max Surge,意思是更新過程中,最多可以超出期望副本數幾個。預設是百分之二十五,可以寫整數,也可以寫百分比。", "item": 1},
   {"say": "第二個是 max Unavailable,意思是更新過程中,最多允許幾個副本不可用,預設也是百分之二十五。", "item": 2},
   {"say": "看畫面上的設定,四個副本,max Surge 是一,max Unavailable 是零。意思是一次只多開一個新的 Pod,而且任何時刻,可用的 Pod 都不會變少。流程就是先開一個新的,等它就緒,再刪一個舊的,一直重複到全部換完。", "item": 3},
   {"say": "代價是更新比較慢,而且叢集要有一份額外的資源。如果資源吃緊,可以反過來,max Surge 設零,max Unavailable 設一,先刪再補,不過容量會短暫減少。這兩個參數不能同時是零。", "item": 3},
   {"say": "另外還有一個 min Ready Seconds,表示新的 Pod 就緒之後,要再穩定幾秒才算可用,可以避免剛啟動就崩潰的版本,被誤判成更新成功。", "item": 3}
  ],
  "更新策略參數與其他工作負載#2": [
   {"say": "另一種策略叫 Recreate。", "item": 0},
   {"say": "它會先把舊的 Pod 全部終止,再建立新的 Pod。所以會有一段停機時間,不過它適合不能同時存在兩個版本的應用,例如只能有單一寫入者的資料檔案。", "item": 1},
   {"say": "寫法很簡單,在 strategy 底下,把 type 設成 Recreate 就可以了。", "item": 2}
  ],
  "更新策略參數與其他工作負載#3": [
   {"say": "這裡要特別提醒,就緒和更新之間的關係。", "item": 0},
   {"say": "滾動更新要不要繼續往下推進,是看新的 Pod 有沒有就緒,也就是 Ready。", "item": 1},
   {"say": "如果沒有設定就緒探針,Kubernetes 只要看到容器啟動,就認為它就緒了,即使應用其實還沒準備好。所以第七章的探針非常重要,沒有探針的滾動更新,保護力是打折的。", "item": 1}
  ],
  "更新策略參數與其他工作負載#4": [
   {"say": "除了 Deployment,還有幾個常用的工作負載控制器,我們也認識一下。", "item": 0},
   {"say": "DaemonSet,會在每一個節點上各跑一個 Pod,適合用來收集日誌,或是當監控的代理程式。", "item": 1},
   {"say": "Job,用來執行一次性的任務,一直到成功完成為止。", "item": 2},
   {"say": "CronJob,會依照排程,定時建立 Job。", "item": 3},
   {"say": "StatefulSet,是給有狀態的應用用的,我們第六章再介紹。", "item": 4},
   {"say": "後面會看一個 Job 的範例,裡面的容器叫 hello,用 busybox 映像印出一行字。", "item": 5}
  ],
  "更新策略參數與其他工作負載#5": [
   {"say": "另外還有一個 CronJob 的範例。", "item": 0},
   {"say": "它的容器叫 task,會印出現在的時間。排程用的是標準的 cron 五欄格式,分別是分、時、日、月、週,範例設定的是每天凌晨兩點執行。", "item": 1},
   {"say": "排程的時間,是依照 kube controller manager 所在的時區來解讀,除非你另外設定 time Zone 欄位。範例還把 concurrency Policy 設成 Forbid,表示上一次還沒跑完,就跳過這一次,避免任務重疊。", "item": 1}
  ],
  "更新策略參數與其他工作負載#6": [
   {"say": "我們來看 Job 的 YAML。", "item": 0},
   {"say": "A P I Version 是 batch 斜線 V 一。", "item": 1},
   {"say": "kind 是 Job。", "item": 2},
   {"say": "metadata 裡,名稱叫 say hello。", "item": 3},
   {"say": "spec 裡有幾個要注意的地方。Job 的 Pod 範本,restart Policy 只能是 Never 或 On Failure,不能用預設的 Always。", "item": 4},
   {"say": "backoff Limit 是失敗之後重試的次數,這裡是三次。另外還有一個設定,讓完成的 Job 和它的 Pod,在三百秒之後自動清除。", "item": 4}
  ],
  "更新策略參數與其他工作負載#7": [
   {"say": "最後看怎麼執行。", "item": 0},
   {"say": "一樣用 apply 減號 F 套用 Job 的檔案。", "item": 1},
   {"say": "用 get jobs 查看 Job 有沒有完成。", "item": 2},
   {"say": "再用 logs 接 job 斜線 say hello,就能看到它印出來的內容。", "item": 3},
   {"say": "下面是 CronJob 的 YAML,A P I Version 同樣是 batch 斜線 V 一。", "item": 4},
   {"say": "kind 則是 CronJob。如果想馬上測試,不想等到排程時間,可以用 create job 加上 from 參數,從這個 CronJob 手動觸發一次。", "item": 5}
  ],
  "closing": [
   {"say": "這一章就到這裡。你已經會用 Deployment 管理副本、做擴縮、滾動更新和回滾,也認識了 Job 和 CronJob 這些控制器。", "item": 0},
   {"say": "接下來,請親手做一次實作練習,再完成章末小測驗,看看自己學會了多少。我們下一章見!", "item": 1, "pause": 1}
  ]
 }
}
