{
 "byKey": {
  "cover": [
   {"say": "大家好,歡迎回到 Kubernetes 入門到實戰。這一章要談儲存。我們會先弄清楚 Volume、P V 和 P V C 的關係,再看 StorageClass 怎麼自動佈建磁碟,最後認識給有狀態應用使用的 StatefulSet。", "item": 0}
  ],
  "Volume、PV 與 PVC 的關係#1": [
   {"say": "先來想一個問題,為什麼容器需要額外的儲存設計?", "item": 0},
   {"say": "因為容器的檔案系統是暫時的。容器一重啟,寫在容器裡面的檔案就不見了。Pod 被重建的話,資料更是不會留下來。", "item": 1},
   {"say": "對無狀態的網頁服務來說,這沒什麼問題。可是對資料庫、使用者上傳的檔案、佇列來說,這就是災難了。所以 Kubernetes 用 Volume 這個機制,把資料的生命週期,和容器的生命週期分開。", "item": 1}
  ],
  "Volume、PV 與 PVC 的關係#2": [
   {"say": "我們先認識幾種常見的 Volume。", "item": 0},
   {"say": "第一種是 empty Dir。它是 Pod 建立的時候產生的空目錄,Pod 裡的容器可以共用。容器崩潰重啟,資料還在,可是 Pod 被刪除,資料就一起刪掉了。它適合放暫存檔、快取,或是讓容器之間交換檔案。", "item": 1},
   {"say": "第二種是 ConfigMap 和 Secret,把設定或機密資料用檔案的方式掛載進來,這是上一章學過的。", "item": 2},
   {"say": "第三種是 host Path,掛載節點上的目錄。資料會綁在特定的節點上,而且等於讓容器可以存取節點的檔案系統,有安全風險。它只適合單節點的實驗,或是系統級的元件,一般的應用請避免使用。", "item": 3},
   {"say": "第四種是 persistent Volume Claim,用來引用持久化的儲存,這就是這一章的重點。", "item": 4}
  ],
  "Volume、PV 與 PVC 的關係#3": [
   {"say": "Kubernetes 把儲存從哪裡來,和應用要多少儲存,拆成兩個角色,一個是提供者,一個是使用者。", "item": 0},
   {"say": "Persistent Volume,簡稱 P V,是叢集層級的資源,代表一塊實際的儲存,像是雲端磁碟、N F S,或是本機磁碟。它通常是由管理員,或是自動佈建器建立的。", "item": 1},
   {"say": "Persistent Volume Claim,簡稱 P V C,是應用申請儲存的請求單,上面寫著我要多大、要什麼存取模式。它是屬於某一個 namespace 的。", "item": 2},
   {"say": "Pod 只需要引用 P V C,不必知道底層是哪一種磁碟,系統會把 P V C 綁定到一個符合條件的 P V。這就像客人點餐,不用管廚房怎麼做菜。", "item": 2}
  ],
  "Volume、PV 與 PVC 的關係#4": [
   {"say": "我們來看一個 P V C 的範例,還有 Pod 要怎麼使用它。", "item": 0},
   {"say": "P V C 這邊,存取模式寫的是 Read Write Once,並且申請一 G 的空間。存取模式的意思,等一下會說明。", "item": 1},
   {"say": "Pod 這邊,容器叫 app,啟動的時候會把現在的時間,寫進資料目錄底下的一個紀錄檔。", "item": 2},
   {"say": "容器把一個叫 data 的 volume,掛載到斜線 data 這個目錄。", "item": 3},
   {"say": "而 volumes 底下的 data,來源就是剛剛那張 P V C。Pod 和 P V C 就是這樣接起來的。", "item": 4},
   {"say": "範例裡還有一個很常見的設定,F S Group。它會把掛載進來的磁碟的群組擁有者,設成指定的群組,讓非 root 的容器也能寫入。漏掉它的話,常常會看到 Permission denied 的錯誤。", "item": 4}
  ],
  "Volume、PV 與 PVC 的關係#5": [
   {"say": "對照 P V C 的 YAML 看一次。", "item": 0},
   {"say": "A P I Version 是 V 一。", "item": 1},
   {"say": "kind 是 Persistent Volume Claim。", "item": 2},
   {"say": "名稱叫 data P V C。", "item": 3},
   {"say": "spec 裡只有兩件事,存取模式,還有要求的儲存容量。是不是很像一張申請單呢?", "item": 4}
  ],
  "Volume、PV 與 PVC 的關係#6": [
   {"say": "再看使用它的 Pod。", "item": 0},
   {"say": "A P I Version 一樣是 V 一。", "item": 1},
   {"say": "kind 是 Pod。", "item": 2},
   {"say": "名稱叫 writer。", "item": 3},
   {"say": "spec 裡除了容器和 volumes,還設定了用非 root 的使用者執行,以及剛剛說的 F S Group。", "item": 4},
   {"say": "另外,它把終止的寬限時間縮短成五秒,是為了練習的時候刪除 Pod 比較快。因為用 S H 當主行程,不會處理終止訊號,預設要等三十秒才會被強制結束。", "item": 4}
  ],
  "Volume、PV 與 PVC 的關係#7": [
   {"say": "接著說明存取模式,一共有四種。", "item": 0},
   {"say": "Read Write Once,縮寫是 R W O,表示可以被單一個節點用讀寫的方式掛載。同一個節點上的多個 Pod,還是可以共用。", "item": 1},
   {"say": "Read Only Many,縮寫是 R O X,可以被多個節點用唯讀的方式掛載。", "item": 2},
   {"say": "Read Write Many,縮寫是 R W X,可以被多個節點用讀寫的方式掛載,不過需要底層的儲存支援,例如 N F S,或是部分的檔案儲存服務。", "item": 3},
   {"say": "Read Write Once Pod,縮寫是 R W O P,只能被單一個 Pod 讀寫掛載,從 Kubernetes 一點二九版開始穩定。", "item": 4},
   {"say": "雲端的區塊磁碟,多半只支援 R W O。如果你想讓多個副本共享同一個可以寫入的目錄,要先確認儲存類型有沒有支援 R W X。", "item": 4}
  ],
  "StorageClass 與動態佈建#1": [
   {"say": "第二個單元,來談 StorageClass 和動態佈建。先看手動建立 P V 有什麼痛點。", "item": 0},
   {"say": "早期的做法,是管理員先建立好很多 P V,使用者再來申請 P V C。這樣很沒有彈性,比如你只申請五 G,可是只有十 G 的 P V,多出來的就浪費了。", "item": 1},
   {"say": "現在標準的做法是動態佈建。使用者建立 P V C,系統就依照 StorageClass,自動向底層的儲存要一塊大小剛好的磁碟,並且建立對應的 P V。", "item": 1}
  ],
  "StorageClass 與動態佈建#2": [
   {"say": "那 StorageClass 是什麼呢?它描述的是一種儲存的等級和建立方式,例如快速的 S S D 磁碟,或是比較便宜的傳統硬碟。它有四個重要的欄位。", "item": 0},
   {"say": "provisioner,是負責建立磁碟的驅動程式。", "item": 1},
   {"say": "reclaim Policy,是這個類別動態建立出來的 P V 的回收策略,沒有指定的話是 Delete。", "item": 2},
   {"say": "allow Volume Expansion,表示之後能不能擴充 P V C 的容量。只能擴大,不能縮小。", "item": 3},
   {"say": "volume Binding Mode 有兩種。Immediate 是 P V C 一建立就馬上佈建。Wait For First Consumer 則是等 Pod 排程之後,才在 Pod 所在的位置佈建,可以避免磁碟和 Pod 不在同一個區域。", "item": 4}
  ],
  "StorageClass 與動態佈建#3": [
   {"say": "來看 YAML 的寫法。", "item": 0},
   {"say": "A P I Version 是 storage 點 K 八 S 點 I O 斜線 V 一。", "item": 1},
   {"say": "kind 是 StorageClass。", "item": 2},
   {"say": "名稱取做 fast。", "item": 3},
   {"say": "provisioner 這裡寫的只是示意用的名稱,實際的值要看你的環境。雲端有各自的 C S I 驅動,本機叢集則是內建一個簡易的佈建器。", "item": 4},
   {"say": "回收策略設成 Retain,也就是保留。", "item": 5}
  ],
  "StorageClass 與動態佈建#4": [
   {"say": "還有最後兩行。", "item": 0},
   {"say": "允許擴充容量,設成 true。", "item": 1},
   {"say": "綁定模式用的是 Wait For First Consumer,等第一個使用它的 Pod 出現才佈建。", "item": 2}
  ],
  "StorageClass 與動態佈建#5": [
   {"say": "接著看怎麼查看和使用 StorageClass。", "item": 0},
   {"say": "等一下的輸出是以 kind 為例。minikube 預設的類別同樣叫 standard,不過佈建器和綁定模式不一樣,請以你自己環境的輸出為準。", "item": 1},
   {"say": "名稱後面標示 default 的類別,會用在沒有指定 storage Class Name 的 P V C 上。", "item": 2},
   {"say": "如果要用特定的類別,就在 P V C 的 spec 裡寫上 storage Class Name,例如 fast。要特別注意,如果寫成空字串,意思是明確要求不使用動態佈建,只能綁定到沒有類別的現成 P V。", "item": 3}
  ],
  "StorageClass 與動態佈建#6": [
   {"say": "實際查一次。", "item": 0},
   {"say": "輸入 kube control get storageclass。", "item": 1},
   {"say": "欄位有名稱、佈建器、回收策略、綁定模式,還有是否允許擴充。", "item": 2},
   {"say": "可以看到一個叫 standard 的類別,後面標著 default。它的回收策略是 Delete,綁定模式是 Wait For First Consumer,而且不允許擴充。", "item": 3}
  ],
  "StorageClass 與動態佈建#7": [
   {"say": "使用特定類別的寫法在這裡。", "item": 0},
   {"say": "在 P V C 的 spec 底下,加上一行 storage Class Name,填入類別的名稱就可以了。", "item": 1}
  ],
  "StatefulSet:有狀態應用的穩定身分#1": [
   {"say": "第三個單元,我們來看 StatefulSet。先想一想,Deployment 為什麼不適合拿來跑資料庫?", "item": 0},
   {"say": "因為 Deployment 管理的 Pod 是可以互換、沒有身分的。名稱是隨機的,I P 會變,所有副本共用同一份 Pod 範本,連 P V C 也是同一個。可是資料庫叢集、訊息佇列這類應用,需要三件事。", "item": 0},
   {"say": "第一,穩定的網路身分,每個成員有固定的名稱,例如 D B 零、D B 一。", "item": 1},
   {"say": "第二,穩定的儲存,每個成員有自己專屬的磁碟,重建之後還是掛回同一個。", "item": 2},
   {"say": "第三,有順序的啟動和終止,例如要先啟動主節點。StatefulSet 就是為了這些需求設計的。", "item": 3}
  ],
  "StatefulSet:有狀態應用的穩定身分#2": [
   {"say": "我們來看 StatefulSet 的特性。", "item": 0},
   {"say": "Pod 的名稱是固定的,由名稱加上序號組成,像 app 零、app 一、app 二。", "item": 1},
   {"say": "預設會依照順序建立,從零號開始,前一個 Ready 之後才建立下一個。刪除的時候則是反過來的順序。", "item": 2},
   {"say": "它用 volume Claim Templates,幫每個 Pod 自動建立專屬的 P V C,名稱是範本名稱加上 Pod 的名稱,例如 data app 零。", "item": 3},
   {"say": "它需要搭配一個 Headless Service,也就是 cluster I P 設成 None 的 Service,提供穩定的 D N S 名稱,這樣每一個 Pod 都有自己專屬的網域名稱可以連。", "item": 4},
   {"say": "最後,Pod 被重建之後,會保留同樣的名稱,並且重新掛回原本的 P V C。", "item": 5}
  ],
  "StatefulSet:有狀態應用的穩定身分#3": [
   {"say": "來看一個完整的範例,它包含一個 Headless Service 和一個 StatefulSet。", "item": 0},
   {"say": "Service 這邊,開了一個叫 T C P 的埠,埠號是八零八零。", "item": 1},
   {"say": "StatefulSet 這邊,容器叫 app。它啟動的時候,會把自己的主機名稱和啟動時間,寫進資料目錄裡的歷史紀錄檔。", "item": 2},
   {"say": "容器把叫 data 的 volume,掛載到斜線 data 目錄。", "item": 3},
   {"say": "而這個 data 不是寫在 volumes 裡,而是寫在 volume Claim Templates 的 metadata 裡。每個 Pod 都會依照這個範本,拿到一張自己的 P V C,容量是一百 M i B。", "item": 4}
  ],
  "StatefulSet:有狀態應用的穩定身分#4": [
   {"say": "先看 Service 的部分。", "item": 0},
   {"say": "A P I Version 是 V 一。", "item": 1},
   {"say": "kind 是 Service。", "item": 2},
   {"say": "名稱叫 app。", "item": 3},
   {"say": "spec 裡最關鍵的,就是把 cluster I P 設成 None,這樣它就是一個 Headless Service。selector 則是選到標籤為 app 的 Pod。", "item": 4}
  ],
  "StatefulSet:有狀態應用的穩定身分#5": [
   {"say": "再看 StatefulSet 的部分。", "item": 0},
   {"say": "中間先用三個減號,把兩個物件分開。", "item": 1},
   {"say": "A P I Version 是 apps 斜線 V 一。", "item": 2},
   {"say": "kind 是 StatefulSet。", "item": 3},
   {"say": "名稱一樣叫 app。", "item": 4},
   {"say": "spec 裡的 service Name,要填剛剛那個 Headless Service 的名稱。副本數是三個,下面再接 selector、Pod 範本,還有 volume Claim Templates。", "item": 5}
  ],
  "StatefulSet:有狀態應用的穩定身分#6": [
   {"say": "套用之後,我們來觀察結果。", "item": 0},
   {"say": "用 get pods,加上減號 L 篩選這個應用的標籤。", "item": 1},
   {"say": "欄位和平常一樣。", "item": 2},
   {"say": "第一個是 app 零,已經執行四十秒。", "item": 3},
   {"say": "第二個是 app 一,執行三十秒。", "item": 4},
   {"say": "第三個是 app 二,執行二十秒。從時間就看得出來,它們是按照順序,一個一個建立的。", "item": 5}
  ],
  "StatefulSet:有狀態應用的穩定身分#7": [
   {"say": "再看 P V C。", "item": 0},
   {"say": "輸入 kube control get P V C。", "item": 1},
   {"say": "欄位有名稱、狀態、對應的 volume、容量、存取模式和 StorageClass。", "item": 2},
   {"say": "可以看到每個 Pod 都有一張專屬的 P V C,狀態是 Bound,也就是已經綁定了。", "item": 3},
   {"say": "如果這時候把 app 一這個 Pod 刪掉,控制器會建立一個同名的新 Pod,並且掛回原本那張 P V C。歷史紀錄檔裡,會看到之前的紀錄,加上新增的一行。這就是穩定身分加上專屬儲存。", "item": 3}
  ],
  "closing": [
   {"say": "這一章就到這裡。你已經弄懂 P V 和 P V C 的分工,知道 StorageClass 怎麼動態佈建,也認識了 StatefulSet 的穩定身分和專屬儲存。", "item": 0},
   {"say": "接下來,請親手做一次實作練習,再完成章末小測驗,看看自己學會了多少。我們下一章見!", "item": 1, "pause": 1}
  ]
 }
}
