{
 "byKey": {
  "cover": [
   {"say": "大家好,歡迎回到 Kubernetes 入門到實戰。這一章要談設定的管理。我們會用 ConfigMap 把設定從映像裡拆出來,用 Secret 存放機密資料,再比較環境變數和檔案掛載這兩種注入方式,還有設定更新的做法。", "item": 0}
  ],
  "ConfigMap:把設定從映像分離#1": [
   {"say": "先想一想,為什麼要把設定拆出來?", "item": 0},
   {"say": "同一個映像,應該要能在開發、測試、正式環境裡執行,差別只在設定,像是資料庫位址、日誌等級、功能開關。", "item": 1},
   {"say": "如果把設定打包進映像,每個環境就要一個映像,這就違反了建置一次、到處執行的原則。Kubernetes 的做法,是把設定放進 ConfigMap,等到執行的時候才注入容器。", "item": 1},
   {"say": "ConfigMap 存的是非機密的設定,資料是鍵值對。值可以是簡單的字串,也可以是一整個檔案的內容,大小上限大約是一 M i B。", "item": 2},
   {"say": "至於密碼、金鑰、token 這些機密資料,請用下一個單元的 Secret,不要放進 ConfigMap。", "item": 2}
  ],
  "ConfigMap:把設定從映像分離#2": [
   {"say": "建立 ConfigMap 有兩種方法,命令式和宣告式,實際的畫面在後面三頁。", "item": 0},
   {"say": "命令式用的是 create configmap,有三種來源可以選。from literal 是直接在指令裡寫鍵和值。from file 會用檔名當鍵,檔案內容當值。from env file 則是讀取一行一個鍵值的檔案,每一行變成一個鍵。", "item": 1}
  ],
  "ConfigMap:把設定從映像分離#3": [
   {"say": "先看命令式的做法。", "item": 0},
   {"say": "用 kube control create configmap,名稱叫 app config,後面用兩個 from literal,給它日誌等級和問候語這兩筆設定。", "item": 1},
   {"say": "看到 created,就建立好了。", "item": 2},
   {"say": "第二個例子是用 from file,把一個 engine X 的設定檔,整個放進 ConfigMap 裡。", "item": 3}
  ],
  "ConfigMap:把設定從映像分離#4": [
   {"say": "繼續往下看。", "item": 0},
   {"say": "第三個例子用 from env file,從一個環境變數檔讀進來。", "item": 1},
   {"say": "再來是宣告式的 YAML 寫法。A P I Version 是 V 一。", "item": 2},
   {"say": "kind 是 ConfigMap。", "item": 3},
   {"say": "metadata 裡的名稱,一樣叫 app config。", "item": 4}
  ],
  "ConfigMap:把設定從映像分離#5": [
   {"say": "接著是資料的部分。", "item": 0},
   {"say": "ConfigMap 沒有 spec,資料直接放在 data 底下。要注意,值一律是字串,所以數字和布林值也要加上引號,不然 YAML 會把它當成數字或布林,A P I server 會拒絕。", "item": 1},
   {"say": "範例裡還有一筆是整個檔案的內容,用的是 YAML 的多行文字語法,也就是一個管線符號,它會保留換行。", "item": 1},
   {"say": "建立之後,可以用 get configmap 加上減號 O yaml,看到完整的內容。", "item": 2},
   {"say": "或是用 describe configmap,用比較好讀的方式顯示。", "item": 3}
  ],
  "ConfigMap:把設定從映像分離#6": [
   {"say": "有了 ConfigMap,要怎麼給 Pod 用呢?第一種方式是環境變數。", "item": 0},
   {"say": "這個範例的容器叫 app,用 busybox 映像,啟動之後會把日誌等級這個環境變數印出來。", "item": 1},
   {"say": "第一種寫法是 env,挑選 ConfigMap 裡的單一個鍵。這裡定義一個叫 LOG LEVEL 的環境變數,它的值來自 app config 裡面同名的鍵。用這種寫法,變數也可以改成別的名字。", "item": 2},
   {"say": "第二種寫法是 env From,用 config Map Ref 一次把 ConfigMap 裡所有的鍵,都變成環境變數。", "item": 3},
   {"say": "不過鍵的名稱必須是合法的環境變數名稱,像有句點的那一筆檔案內容,就會被略過。如果 env 和 env From 同時存在,是 env 優先。", "item": 4}
  ],
  "ConfigMap:把設定從映像分離#7": [
   {"say": "第二種方式,是把 ConfigMap 掛載成檔案。", "item": 0},
   {"say": "容器一樣叫 app,啟動之後會把設定檔的內容印出來。", "item": 1},
   {"say": "在容器的 volume Mounts 裡,把一個叫 C F G 的 volume,用唯讀的方式,掛到 E T C 底下的 app 目錄。", "item": 2},
   {"say": "而下面的 volumes,定義了同名的 C F G,來源就是 app config 這個 ConfigMap。", "item": 3},
   {"say": "掛載之後,每一個鍵都會變成那個目錄底下的一個檔案,檔案的內容就是值。", "item": 4},
   {"say": "要小心,掛載會蓋掉掛載點目錄原本的內容,所以不要直接掛到 E T C 這種已經有重要檔案的目錄。如果只想放一個檔案,可以用 sub Path,不過用 sub Path 掛載的檔案不會自動更新。", "item": 4}
  ],
  "Secret:機密資料與它的限制#1": [
   {"say": "第二個單元,我們來認識 Secret。", "item": 0},
   {"say": "Secret 的結構和 ConfigMap 很像,用來存放密碼、A P I token、T L S 私鑰、映像倉庫的憑證這些敏感資料。使用方式也一樣,可以變成環境變數,或是掛載成檔案。", "item": 1},
   {"say": "差別在於,Kubernetes 對 Secret 有一些額外的處理。例如用 get 查詢的時候不會顯示內容。掛載的 Secret 會放在記憶體型的檔案系統,不會寫到節點的磁碟。它只會送到需要它的節點,而且可以用 R B A C 單獨控管。", "item": 1}
  ],
  "Secret:機密資料與它的限制#2": [
   {"say": "接下來是這一章最重要的觀念,base 六十四不是加密。", "item": 0},
   {"say": "Secret 的 data 欄位,內容是 base 六十四編碼。那只是格式轉換,為的是能放二進位的資料,並不是保護。而且 Secret 預設是用沒有加密的形式,存在 E T C D 裡面。所以要注意幾件事。", "item": 0},
   {"say": "第一,不要把含有 Secret 的 YAML 提交到 Git。就算是 base 六十四編碼過的,也等於是明文。", "item": 1},
   {"say": "第二,要限制誰可以 get 和 list Secret,這要靠 R B A C,後面的章節會談。要注意,有 list 權限也能讀到所有內容。而且能建立 Pod 的人,通常也能透過掛載,讀到同一個 namespace 裡的 Secret。", "item": 2},
   {"say": "第三,正式環境應該啟用 E T C D 的靜態加密,託管服務通常都有對應的選項。", "item": 3}
  ],
  "Secret:機密資料與它的限制#3": [
   {"say": "如果你的要求更高,還有別的選擇。", "item": 0},
   {"say": "可以使用外部的機密管理服務,像是 Vault,或是雲端的機密服務,搭配 External Secrets 這一類的工具。也可以用 Sealed Secrets 這種加密方案,加密過的內容可以安全地放進 Git。", "item": 1}
  ],
  "Secret:機密資料與它的限制#4": [
   {"say": "我們用一行指令來證明。", "item": 0},
   {"say": "把一段 base 六十四的字串,用 echo 印出來,再透過管線符號交給 base 六十四指令,加上減號 D 解碼,原本的內容馬上就還原了。任何人都做得到,所以千萬別把它當成加密。", "item": 1}
  ],
  "Secret:機密資料與它的限制#5": [
   {"say": "接著來建立 Secret,指令的畫面在後面,這裡先說明幾個重點。", "item": 0},
   {"say": "範例會用 open S S L 產生隨機的密碼,避免在指令歷史裡留下弱密碼。不過指令本身還是會留在 shell 的歷史紀錄裡,在共用的主機上要小心。也可以改用 from file,從權限設成六零零的檔案讀取。", "item": 1},
   {"say": "Secret 也可以用 YAML 來寫。", "item": 2},
   {"say": "名稱叫 D B secret,類型是 Opaque,也就是一般用途的 Secret。", "item": 3},
   {"say": "裡面有使用者名稱和密碼兩筆資料。密碼的位置請填入你自己的密碼,而且不要提交到 Git。", "item": 4},
   {"say": "這裡用的欄位是 string Data,它允許你直接寫明文字串,A P I server 存進去的時候,會自動轉成 base 六十四放進 data。它只是寫入用的欄位,之後 get 出來只會看到 data。再強調一次,這份檔案含有明文,不要放進版本控制。", "item": 5}
  ],
  "Secret:機密資料與它的限制#6": [
   {"say": "我們一行一行來看。", "item": 0},
   {"say": "用 kube control create secret generic,名稱是 D B secret,用 from literal 給它使用者名稱,密碼則是用 open S S L 隨機產生的。", "item": 1},
   {"say": "看到 created。", "item": 2},
   {"say": "接著用 get secret 查看。", "item": 3},
   {"say": "欄位有名稱、類型、資料筆數和建立時間。", "item": 4},
   {"say": "類型是 Opaque,資料有兩筆。你會發現,這裡並不會把內容顯示出來。", "item": 5}
  ],
  "Secret:機密資料與它的限制#7": [
   {"say": "那要怎麼看內容呢?", "item": 0},
   {"say": "可以用減號 O 搭配 J S O N path,只取出 data 裡的 username,再用管線符號交給 base 六十四解碼。", "item": 1},
   {"say": "結果就是 app user。這也再一次證明,只要有讀取的權限,內容就看得到。", "item": 2},
   {"say": "下面是 YAML 的寫法,A P I Version 是 V 一。", "item": 3},
   {"say": "kind 是 Secret,後面接的就是剛剛說明過的名稱、類型和 string Data。", "item": 4}
  ],
  "環境變數、檔案掛載與設定更新策略#1": [
   {"say": "第三個單元。同一份設定,可以用環境變數,也可以用檔案來提供,那要怎麼選呢?", "item": 0},
   {"say": "簡單的單一值,像是日誌等級、埠號、功能開關,用環境變數就好,簡單直接,大多數的應用程式都支援。", "item": 1},
   {"say": "如果是一整份設定檔,例如 engine X 的設定檔,就掛載成檔案。", "item": 2},
   {"say": "機密資料的話,優先用檔案掛載,並且限制權限。", "item": 3},
   {"say": "如果需要在不重啟的情況下更新設定,也是用掛載檔案,而且要確認應用程式支援重新讀取,例如收到訊號,或是會監看檔案的變化。", "item": 4}
  ],
  "環境變數、檔案掛載與設定更新策略#2": [
   {"say": "有時候,我們想把 ConfigMap 和 Secret 放在同一個目錄,這時可以用 projected volume。", "item": 0},
   {"say": "先定義一個 volume,名字叫 all in one,類型是 projected。", "item": 1},
   {"say": "它的來源有兩個,第一個是 ConfigMap,也就是 app config。", "item": 2},
   {"say": "第二個是 Secret,也就是 D B secret。", "item": 3},
   {"say": "這一段寫在 volumes 底下。這樣一來,容器只要掛一個目錄,就能看到所有的檔案。", "item": 4}
  ],
  "環境變數、檔案掛載與設定更新策略#3": [
   {"say": "另一個技巧,是只掛載需要的鍵。", "item": 0},
   {"say": "volume 一樣叫 C F G,來源是 app config。", "item": 1},
   {"say": "多了一個 items 欄位,用 key 指定要掛載哪一個鍵,再用 path 決定掛進去之後的檔名叫什麼。", "item": 2},
   {"say": "同樣是寫在 volumes 底下。這樣做可以避免把不相干的設定,暴露給容器。", "item": 3}
  ],
  "環境變數、檔案掛載與設定更新策略#4": [
   {"say": "有時候,應用程式需要知道自己的 Pod 名稱,或是所在的 namespace,這時可以用 Downward A P I。", "item": 0},
   {"say": "第一個環境變數是 Pod 的名稱,它的值不是寫死的,而是用 field Ref,從 metadata 的 name 欄位取出來。", "item": 1},
   {"say": "第二個是 Pod 所在的 namespace,同樣從 metadata 裡取得。", "item": 2},
   {"say": "這兩個都寫在容器的 env 底下。它們很適合放進日誌的欄位,方便追蹤訊息是哪一個 Pod 產生的。", "item": 3}
  ],
  "環境變數、檔案掛載與設定更新策略#5": [
   {"say": "再來一個很實際的問題。設定更新之後,要怎麼讓 Deployment 套用呢?", "item": 0},
   {"say": "因為環境變數是在容器啟動的時候才讀取的,所以最直覺的方法,就是把 Pod 重新啟動。", "item": 1},
   {"say": "用 rollout restart,會以滾動的方式換掉所有 Pod,服務不會中斷。", "item": 2},
   {"say": "另一個進階的做法,是不可變的 ConfigMap 加上版本化的名稱。每次設定變更,就建立一個新名稱的 ConfigMap,例如結尾加上 V 二,再修改 Deployment 範本引用的名稱。這樣就會觸發標準的滾動更新,也可以回滾。", "item": 3},
   {"say": "Helm 這類工具,常把 ConfigMap 內容的雜湊值,放進 Pod 範本的註解裡,達到同樣的效果,第八章會再提到。", "item": 3}
  ],
  "環境變數、檔案掛載與設定更新策略#6": [
   {"say": "指令一共三行。", "item": 0},
   {"say": "先 apply 新的 ConfigMap 檔案。", "item": 1},
   {"say": "再對 web 這個 Deployment 執行 rollout restart。", "item": 2},
   {"say": "最後用 rollout status,看著它滾動更新完成。", "item": 3}
  ],
  "環境變數、檔案掛載與設定更新策略#7": [
   {"say": "最後,分享幾個管理設定的好習慣。", "item": 0},
   {"say": "第一,不同環境之間的差異,用不同的 ConfigMap 或不同的 namespace 來處理,而不是用不同的映像。", "item": 1},
   {"say": "第二,設定檔放在 Git,並且經過審查流程。機密資料則要另外管理。", "item": 2},
   {"say": "第三,幫設定定好合理的預設值。如果缺少必要的設定,就讓應用程式啟動失敗,並且清楚報錯,而不是帶著錯誤的設定繼續跑。", "item": 3},
   {"say": "第四,不要在映像或日誌裡印出機密資料。", "item": 4}
  ],
  "closing": [
   {"say": "這一章就到這裡。你已經會用 ConfigMap 和 Secret 管理設定,知道 base 六十四不是加密,也學會讓設定更新套用到 Deployment 了。", "item": 0},
   {"say": "接下來,請親手做一次實作練習,再完成章末小測驗,看看自己學會了多少。我們下一章見!", "item": 1, "pause": 1}
  ]
 }
}
