{
 "byKey": {
  "cover": [
   {"say": "大家好,歡迎回到 Kubernetes 入門到實戰。這一章有三個主題。先用 Namespace 把叢集分區管理,再用 R B A C 做最小權限的存取控制,最後認識 Kubernetes 的套件管理工具 Helm。", "item": 0}
  ],
  "Namespace 與資源配額#1": [
   {"say": "先想一想,為什麼需要命名空間,也就是 Namespace?", "item": 0},
   {"say": "當一個叢集由很多團隊、很多專案,還有開發、測試這些不同的環境共用的時候,所有物件都放在同一個地方,名稱會衝突,也很難分開管理權限和資源。Namespace 就是把叢集切成好幾個邏輯上的區隔。", "item": 0},
   {"say": "第一,同一種資源在不同的 Namespace 裡可以同名,比如每個 Namespace 各自有一個叫 web 的 Deployment。", "item": 1},
   {"say": "第二,可以針對每個 Namespace 設定資源配額,還有權限。", "item": 2},
   {"say": "第三,刪除 Namespace 的時候,裡面所有的物件會一起被刪掉。清理起來很方便,但是也很危險,下手之前請一定要確認。", "item": 3}
  ],
  "Namespace 與資源配額#2": [
   {"say": "叢集一建立,就有四個預設的 Namespace。", "item": 0},
   {"say": "default,是你沒有特別指定的時候,物件會放的地方。", "item": 1},
   {"say": "kube system,放的是 Kubernetes 的系統元件,像是 Core D N S 和 kube proxy,請不要隨意改動。", "item": 2},
   {"say": "kube public,是所有人都可以讀的,包含沒有通過驗證的人,很少用到。", "item": 3},
   {"say": "kube node lease,是給節點回報心跳用的。", "item": 4},
   {"say": "正式的應用,不建議全部放在 default,應該建立有意義的 Namespace,例如用專案名稱加上環境來命名。", "item": 4}
  ],
  "Namespace 與資源配額#3": [
   {"say": "我們實際查一次。", "item": 0},
   {"say": "輸入 kube control get namespaces。", "item": 1},
   {"say": "欄位有名稱、狀態和建立多久。", "item": 2},
   {"say": "第一個是 default。", "item": 3},
   {"say": "第二個是 kube node lease。", "item": 4},
   {"say": "第三個是 kube public。", "item": 5},
   {"say": "第四個是 kube system。四個的狀態都是 Active。", "item": 6}
  ],
  "Namespace 與資源配額#4": [
   {"say": "接著看怎麼操作 Namespace,指令在下一頁,這裡先講重點。", "item": 0},
   {"say": "你可以修改目前 context 的預設 Namespace,之後就不用每個指令都加減號 N。這很方便,但是也容易搞混。", "item": 1},
   {"say": "做高風險的操作之前,請先用 config view 確認目前的 Namespace。你也可以在 YAML 的 metadata 裡指定,或是在指令用減號 N 覆蓋。", "item": 1},
   {"say": "Namespace 也可以用宣告式的方式建立。", "item": 2},
   {"say": "YAML 很短,只要寫名稱,這裡是 shop dev,另外可以加上標籤,標明是哪個團隊的。", "item": 3}
  ],
  "Namespace 與資源配額#5": [
   {"say": "來看指令。", "item": 0},
   {"say": "用 create namespace 建立一個叫 shop dev 的 Namespace。", "item": 1},
   {"say": "查 Pod 的時候加上減號 N,就只看 shop dev 裡面的。", "item": 2},
   {"say": "加上減號大寫 A,則是看所有 Namespace 的。", "item": 3},
   {"say": "最後一行是 config set context,加上 current 和 namespace 兩個參數,把目前 context 的預設 Namespace 改成 shop dev。", "item": 4}
  ],
  "Namespace 與資源配額#6": [
   {"say": "宣告式的寫法是這樣。", "item": 0},
   {"say": "A P I Version 是 V 一。", "item": 1},
   {"say": "kind 是 Namespace。", "item": 2},
   {"say": "metadata 底下寫名稱和標籤,就這麼簡單。", "item": 3}
  ],
  "Namespace 與資源配額#7": [
   {"say": "要注意,不是所有資源都屬於 Namespace。", "item": 0},
   {"say": "Pod、Deployment、Service、ConfigMap、Secret、P V C、Role 這些,是屬於 Namespace 的。而 Node、P V、StorageClass、Namespace 本身,還有 Cluster Role,是屬於叢集層級的。", "item": 1},
   {"say": "記不住沒關係,可以用 A P I resources 這個指令,加上 namespaced 等於 true,列出屬於 Namespace 的資源。", "item": 2},
   {"say": "改成 false,就會列出叢集層級的資源。", "item": 3}
  ],
  "RBAC:最小權限存取控制#1": [
   {"say": "第二個單元,我們來談 R B A C,全名是 Role Based Access Control,也就是以角色為基礎的存取控制。", "item": 0},
   {"say": "請求到達 kube A P I server 的時候,會經過三關。身分驗證,確認你是誰。授權,看你能不能做這件事。還有准入控制,檢查內容合不合規定。R B A C 負責的是第二關。它的原則是預設拒絕、明確授權,沒有被允許的操作,一律是 Forbidden。", "item": 1},
   {"say": "R B A C 有四個物件。Role,定義在某一個 Namespace 裡,可以對哪些資源做哪些動作。", "item": 2},
   {"say": "Cluster Role,作用一樣,但它是叢集層級的,可以涵蓋 nodes 這種叢集範圍的資源,或是所有的 Namespace。", "item": 3},
   {"say": "Role Binding,是把 Role 或 Cluster Role 授予某些主體,效力只限於那個 Namespace。", "item": 4},
   {"say": "Cluster Role Binding,則是把 Cluster Role 授予主體,效力是整個叢集。簡單說,Role 定義能做什麼,Binding 決定給誰。", "item": 5}
  ],
  "RBAC:最小權限存取控制#2": [
   {"say": "我們來看一個 Role 和 Role Binding 的範例,目標是讓一個帳號只能讀取 Pod。", "item": 0},
   {"say": "Role 的規則裡,A P I Groups 寫的是一個空字串。", "item": 1},
   {"say": "授權的對象是一個 Service Account,它是給程式使用的身分,名字叫 viewer。", "item": 2},
   {"say": "空字串指的是核心群組,像 Pod、Service、ConfigMap、Secret 都在這裡。Deployment 則是在 apps 這個群組。", "item": 3},
   {"say": "verbs 是可以做的動作,常見的有 get、list、watch、create、update、patch 和 delete。這個範例只給了 get、list、watch 三個讀取的動作。", "item": 4},
   {"say": "還有一點,Role Binding 裡的 role Ref,建立之後就不能修改了,要換的話只能刪除再重建。", "item": 5}
  ],
  "RBAC:最小權限存取控制#3": [
   {"say": "完整的 YAML 分成三個物件,我們一個一個看。", "item": 0},
   {"say": "第一個物件,A P I Version 是 V 一。", "item": 1},
   {"say": "kind 是 Service Account。", "item": 2},
   {"say": "名稱叫 viewer,放在 shop dev 這個 Namespace。", "item": 3},
   {"say": "接著用三個減號,分隔下一個物件。", "item": 4}
  ],
  "RBAC:最小權限存取控制#4": [
   {"say": "第二個物件是 Role。", "item": 0},
   {"say": "A P I Version 是 R B A C 專屬的群組,寫起來比較長,照著畫面打就可以了。", "item": 1},
   {"say": "kind 是 Role。", "item": 2},
   {"say": "名稱叫 pod reader,同樣在 shop dev 裡。", "item": 3},
   {"say": "rules 底下寫的是,對核心群組裡的 pods,還有 Pod 的日誌,可以做 get、list、watch 這三個動作。", "item": 4}
  ],
  "RBAC:最小權限存取控制#5": [
   {"say": "第三個物件是 Role Binding。", "item": 0},
   {"say": "一樣先用三個減號分隔。", "item": 1},
   {"say": "A P I Version 和 Role 用的是同一個群組。", "item": 2},
   {"say": "kind 是 Role Binding。", "item": 3},
   {"say": "名稱叫 viewer pod reader,一看就知道是把 pod reader 這個角色,綁給 viewer。", "item": 4}
  ],
  "RBAC:最小權限存取控制#6": [
   {"say": "Role Binding 最重要的是這兩段。", "item": 0},
   {"say": "subjects 是主體,也就是要把權限給誰,這裡是 shop dev 裡的 viewer 這個 Service Account。", "item": 1},
   {"say": "role Ref 是要授予哪一個角色,這裡指向剛剛建立的 pod reader。", "item": 2}
  ],
  "RBAC:最小權限存取控制#7": [
   {"say": "其實也可以用指令快速建立,用 create role 和 create rolebinding,效果和剛剛的 YAML 一樣。建立之後,記得要驗證。", "item": 0},
   {"say": "驗證權限用的是 kube control auth can i,還可以加上 as 參數,冒充別的身分來檢查。比如冒充 viewer 問能不能 list pods,答案是 yes。問能不能刪除 Pod,或是讀取 Secret,答案都是 no。", "item": 1},
   {"say": "你也可以直接用這個 Service Account 的身分去執行指令,一樣是加上 as 參數。不過要提醒,冒充這件事本身也需要權限,通常只有叢集管理員才有。", "item": 2}
  ],
  "Helm 入門:套件管理與模板#1": [
   {"say": "第三個單元是 Helm。先想一想為什麼需要它。", "item": 0},
   {"say": "一個真實的應用,通常包含 Deployment、Service、ConfigMap、Ingress 等等好幾個 YAML。部署到開發、預備、正式環境的時候,大部分內容都一樣,只有映像標籤、副本數、網域這些值不同。複製貼上三份 YAML,很難維護。", "item": 0},
   {"say": "Helm 是 Kubernetes 的套件管理器,它提供三樣東西。", "item": 0},
   {"say": "第一是 Chart,把一組 K 八 S 的資源,打包成可以重複使用的套件。", "item": 1},
   {"say": "第二是模板化,把 YAML 裡會變動的地方寫成變數,再由 values 檔案填入。", "item": 2},
   {"say": "第三是 Release,也就是把 Chart 安裝到叢集之後的一個實例。它有名稱,也有版本歷史,可以升級,也可以回滾。", "item": 3},
   {"say": "現在大家用的是 Helm 三,只有 helm 這個用戶端程式,已經沒有舊版那個裝在伺服器端的元件了。", "item": 3}
  ],
  "Helm 入門:套件管理與模板#2": [
   {"say": "我們來看 Chart 的結構。", "item": 0},
   {"say": "一個 Chart 就是一個資料夾。裡面有 Chart 點 yaml,記錄名稱、Chart 的版本和應用的版本。有 values 點 yaml,放預設值。有 templates 資料夾,放模板檔。還有 charts 資料夾,放相依的子 Chart。", "item": 0},
   {"say": "模板的內容其實就是一般的 YAML,像這裡的容器一樣叫 web。只是會變動的地方,改用兩層大括號包起來的變數。", "item": 1}
  ],
  "Helm 入門:套件管理與模板#3": [
   {"say": "看一個簡化過的 Deployment 模板。", "item": 0},
   {"say": "最上面是 Chart 資料夾的結構,就是剛剛說的那幾個檔案和資料夾。", "item": 1},
   {"say": "模板的開頭,A P I Version 是 apps 斜線 V 一。", "item": 2},
   {"say": "kind 是 Deployment。", "item": 3},
   {"say": "到了 metadata,名稱就不是寫死的了,而是用 Release 的名稱,後面再接上 web。所以安裝成不同的 Release,名稱就不會撞在一起。", "item": 4}
  ],
  "Helm 入門:套件管理與模板#4": [
   {"say": "繼續往下看。", "item": 0},
   {"say": "spec 裡的副本數,取自 Values 的 replica Count。映像也是由 Values 裡的倉庫名稱和標籤組合起來的。", "item": 1},
   {"say": "對應的 values 檔裡面,replica Count 寫的是二。", "item": 2},
   {"say": "image 底下則有倉庫名稱和標籤。大括號裡面是 Go 的模板語法,點 Values 是從 values 檔取值,點 Release 則是 Release 的資訊,像是名稱和 Namespace。", "item": 3}
  ],
  "Helm 入門:套件管理與模板#5": [
   {"say": "接著是 Helm 的常用指令,先說明幾個重點,指令在後面兩頁。", "item": 0},
   {"say": "install 後面的第一個名稱,是 Release 的名稱,第二個才是 Chart 的路徑或名稱。", "item": 1},
   {"say": "要調整設定值有兩種方式。兩個減號 set 可以臨時覆蓋某個值。減號 F 則是指定一個值檔案。正式環境建議用檔案,並且納入版本控制。", "item": 2},
   {"say": "dry run 參數和 helm template 指令,都可以在不安裝的情況下預覽結果。先 template 再 install,是個好習慣。", "item": 3},
   {"say": "另外,atomic 參數會讓失敗的升級自動回滾,wait 參數則是等資源都就緒了才算成功。", "item": 4}
  ],
  "Helm 入門:套件管理與模板#6": [
   {"say": "我們一行一行來看。", "item": 0},
   {"say": "helm create,會產生一個範本 Chart,讓你從它開始修改。", "item": 1},
   {"say": "helm lint,用來檢查 Chart 的格式有沒有問題。", "item": 2},
   {"say": "helm template,只把模板渲染成 YAML 印出來,不會真的安裝。", "item": 3},
   {"say": "helm install,把 Chart 安裝成一個叫 demo 的 Release,放在 demo 這個 Namespace。後面的 create namespace 參數,表示 Namespace 不存在的話就順便建立。", "item": 4}
  ],
  "Helm 入門:套件管理與模板#7": [
   {"say": "安裝之後的管理指令。", "item": 0},
   {"say": "helm list,列出這個 Namespace 裡的 Release。", "item": 1},
   {"say": "helm upgrade,用來升級,這裡用 set 把副本數改成三個。", "item": 2},
   {"say": "helm history,查看這個 Release 的版本歷史。", "item": 3},
   {"say": "helm rollback,後面接 Release 名稱和版本號,這裡是退回第一版。", "item": 4},
   {"say": "helm uninstall,則是把整個 Release 移除。另外還有 helm get values,可以查看這個 Release 目前用了哪些自訂的值。", "item": 5}
  ],
  "closing": [
   {"say": "這一章就到這裡。你已經會用 Namespace 分區管理,用 R B A C 給出剛剛好的權限,也學會用 Helm 打包和部署應用了。", "item": 0},
   {"say": "接下來,請親手做一次實作練習,再完成章末小測驗,看看自己學會了多少。我們下一章見!", "item": 1, "pause": 1}
  ]
 }
}
