{
 "byKey": {
  "cover": [
   {"say": "大家好,歡迎回到 Kubernetes 入門到實戰。上一章我們把應用部署起來了,這一章要讓它可以被連線。我們會學 Service 的原理和各種類型,再用 Ingress 處理 H T T P 的路由和 T L S 憑證。", "item": 0}
  ],
  "Service:穩定的內部入口#1": [
   {"say": "我們先從一個問題開始,Pod 的 I P 是不穩定的。", "item": 0},
   {"say": "每個 Pod 都有自己的 I P,可是 Pod 隨時可能被重建,像是滾動更新、節點故障,或是擴縮,I P 就會跟著變。前端要連後端,不可能去記一堆會變的 I P。", "item": 1},
   {"say": "Service 解決的就是這個問題。它提供一個穩定的虛擬 I P,叫做 Cluster I P,還有一個穩定的 D N S 名稱,並且把流量負載平衡到一群 Pod 上。這群 Pod 必須符合標籤選擇器,而且是就緒的。", "item": 1}
  ],
  "Service:穩定的內部入口#2": [
   {"say": "那 Service 是怎麼運作的呢?分成四個步驟。", "item": 0},
   {"say": "第一,Service 透過 selector,找到帶有指定標籤的 Pod。", "item": 1},
   {"say": "第二,控制器會持續維護這些 Pod 的位址清單,記錄在一個叫 Endpoint Slice 的物件裡。", "item": 2},
   {"say": "第三,每個節點上的 kube proxy 會設定網路規則,讓送到 Service 的 Cluster I P 和埠號的封包,被轉送到其中一個 Pod。", "item": 3},
   {"say": "第四,只有通過就緒檢查,也就是 Ready 的 Pod,才會出現在清單裡。還沒準備好的 Pod,不會收到流量。", "item": 4}
  ],
  "Service:穩定的內部入口#3": [
   {"say": "來看 Service 的 YAML,這裡有三個很容易搞混的埠。", "item": 0},
   {"say": "在 ports 底下,我們幫這個埠取了一個名字,叫 H T T P。", "item": 1},
   {"say": "第一個是 port,它是 Service 自己在叢集裡面開放的埠。", "item": 2},
   {"say": "第二個是 target Port,它是 Pod 裡的容器實際監聽的埠。不寫的話,預設和 port 一樣,也可以填容器埠的名稱。", "item": 3},
   {"say": "第三個是 node Port,只有 Node Port 類型的 Service 才有,是在節點上開放的埠。", "item": 4},
   {"say": "以這個例子來說,別人連 web 這個 Service 的八十號埠,封包會被送到 Pod 的八零八零號埠。另外,type 沒有寫的時候,預設是 Cluster I P,只能在叢集內部存取。", "item": 4}
  ],
  "Service:穩定的內部入口#4": [
   {"say": "對照畫面上的 YAML 看一次。", "item": 0},
   {"say": "A P I Version 是 V 一。", "item": 1},
   {"say": "kind 是 Service。", "item": 2},
   {"say": "metadata 裡,名稱叫 web。", "item": 3},
   {"say": "spec 裡面,selector 寫的是 app 冒號 web,所以它會找到上一章 Deployment 建立的那些 Pod。下面的 ports,就是剛剛說的八十號埠對應到八零八零號埠,通訊協定是 T C P。", "item": 4}
  ],
  "Service:穩定的內部入口#5": [
   {"say": "建立之後,我們要驗證 Service 有沒有正常運作,基本的查詢指令在後面兩頁。", "item": 0},
   {"say": "這裡先講怎麼實際連連看。可以在叢集裡開一個臨時的 Pod,用 busybox 映像裡的 W get 去連 web 這個名稱,如果看到 engine X 的歡迎頁面,就表示通了。", "item": 0},
   {"say": "指令裡的兩個減號 R M,會讓這個 Pod 結束之後自動刪除。如果想從自己的電腦臨時測試,可以用 port forward,把本機的八零八零號埠轉到 Service 的八十號埠,再用瀏覽器打開 localhost 的八零八零號埠。", "item": 1}
  ],
  "Service:穩定的內部入口#6": [
   {"say": "我們一行一行來看。", "item": 0},
   {"say": "先用 apply 減號 F 套用 Service 的檔案。", "item": 1},
   {"say": "看到 service web created。", "item": 2},
   {"say": "接著用 get S V C web 查看,S V C 就是 services 的縮寫。", "item": 3},
   {"say": "欄位有名稱、類型、Cluster I P、外部 I P、埠號,還有建立的時間。", "item": 4}
  ],
  "Service:穩定的內部入口#7": [
   {"say": "來看查到的結果。", "item": 0},
   {"say": "類型是 Cluster I P,系統分配了一個叢集內部的虛擬 I P。外部 I P 是 none,埠是八十號,走 T C P。", "item": 1},
   {"say": "第二個指令是查 Endpoint Slice,用減號 L 篩選屬於 web 這個 Service 的那幾筆,可以看到後端 Pod 的位址。", "item": 2},
   {"say": "第三個是 describe S V C web。輸出裡有一行 Endpoints,會列出目前後端 Pod 的 I P 和埠。", "item": 3},
   {"say": "如果這一行是 none,代表 selector 沒有比對到任何就緒的 Pod。這是 Service 連不到的時候,第一個要檢查的地方,請一定要記起來。", "item": 3}
  ],
  "NodePort、LoadBalancer 與 Service 類型#1": [
   {"say": "第二個單元,我們來看 Service 有哪些類型。spec 裡的 type 欄位,決定 Service 要怎麼對外。", "item": 0},
   {"say": "第一種是 Cluster I P,也是預設值,只有叢集內部連得到。大多數的服務,像是資料庫、內部的 A P I,都用這一種。", "item": 1},
   {"say": "第二種是 Node Port。它會在每一個節點上開一個固定的埠,預設範圍是三萬到三二七六七,外部可以用節點的 I P 加上這個埠連進來。它同時也包含 Cluster I P 的功能。", "item": 2},
   {"say": "第三種是 Load Balancer。它會向雲端供應商要一個外部的負載平衡器,取得對外的 I P。它包含了 Node Port 和 Cluster I P 的功能。", "item": 3}
  ],
  "NodePort、LoadBalancer 與 Service 類型#2": [
   {"say": "還有兩種比較特別的。", "item": 0},
   {"say": "External Name,是把 Service 的名稱,對應到一個外部的 D N S 名稱,它不做代理,只是一筆別名紀錄。", "item": 1},
   {"say": "Headless,寫法是把 cluster I P 設成 None。它不會配置虛擬 I P,D N S 會直接回傳每一個 Pod 的 I P。StatefulSet 很常用它,我們第六章會再看到。", "item": 2}
  ],
  "NodePort、LoadBalancer 與 Service 類型#3": [
   {"say": "我們來看一個 Node Port 的範例。", "item": 0},
   {"say": "Service 的埠一樣是八十號,轉到容器的八零八零號埠,另外多指定了節點埠三零零八零。", "item": 1},
   {"say": "node Port 如果不寫,系統會自動分配。固定的節點埠,容易和別的 Service 衝突,而且每個節點都開了埠,攻擊面比較大,所以正式環境比較少直接使用。", "item": 1},
   {"say": "練習的時候要注意,在 minikube 可以用 minikube service 指令取得可以連線的網址。在 kind 裡,節點其實是 Docker 容器,直接連節點 I P,在某些作業系統上不通,建議改用 port forward。", "item": 1}
  ],
  "NodePort、LoadBalancer 與 Service 類型#4": [
   {"say": "YAML 的寫法是這樣。", "item": 0},
   {"say": "A P I Version 一樣是 V 一。", "item": 1},
   {"say": "kind 是 Service。", "item": 2},
   {"say": "名稱叫 web N P。", "item": 3},
   {"say": "spec 裡多了一行 type,寫 Node Port,selector 一樣是 app 冒號 web,ports 裡則多了一個 node Port 欄位。", "item": 4}
  ],
  "NodePort、LoadBalancer 與 Service 類型#5": [
   {"say": "建立之後查看一下。", "item": 0},
   {"say": "輸入 get S V C,後面接這個 Service 的名稱。", "item": 1},
   {"say": "欄位和前面一樣。", "item": 2},
   {"say": "類型變成 Node Port。請看埠號那一欄,八十冒號三零零八零,意思是 Service 的八十號埠,對應到節點的三零零八零號埠。", "item": 3}
  ],
  "NodePort、LoadBalancer 與 Service 類型#6": [
   {"say": "接著是 Load Balancer 類型。", "item": 0},
   {"say": "在雲端託管的叢集上,過幾分鐘,外部 I P 就會從 pending 變成真正的位址。可是在本機叢集,如果沒有額外的元件,它會一直停在 pending,這是正常的,不是你設定錯了。minikube 可以另外執行 minikube tunnel 來模擬。", "item": 1},
   {"say": "寫法就是在 spec 裡,把 type 設成 Load Balancer。", "item": 2},
   {"say": "不過雲端的負載平衡器通常是按量計費,一個 Service 就要一個,服務一多,成本會很高。所以 H T T P 的服務,多半改用下一個單元的 Ingress 來共用入口。", "item": 2}
  ],
  "NodePort、LoadBalancer 與 Service 類型#7": [
   {"say": "一個 Service 也可以開好幾個埠。", "item": 0},
   {"say": "第一個埠叫 H T T P,對外是八十號埠。它的 target Port 寫的不是數字,而是 web,對應到容器 ports 裡面名字叫 web 的那個埠。", "item": 1},
   {"say": "第二個埠叫 metrics,用的是九一零零號埠。", "item": 2},
   {"say": "規則是,有多個埠的時候,每一個埠都必須有名字。而用命名埠的好處是,以後容器的埠號改了,Service 不用跟著改。", "item": 3}
  ],
  "Ingress:HTTP 路由與 TLS#1": [
   {"say": "第三個單元是 Ingress。為什麼有了 Service,還需要 Ingress 呢?", "item": 0},
   {"say": "如果每一個網站都配一個 Load Balancer,成本高,又很難管理。", "item": 1},
   {"say": "Ingress 提供的是第七層,也就是 H T T P 和 H T T P S 的路由。只要一個對外的入口,就能依照網域名稱和網址路徑,把請求分到不同的 Service,還可以集中處理 T L S 憑證。", "item": 1}
  ],
  "Ingress:HTTP 路由與 TLS#2": [
   {"say": "這裡是很多人卡關的地方,要分清楚 Ingress 和 Ingress Controller。", "item": 0},
   {"say": "Ingress 只是一份路由規則的物件,它自己不會處理流量。真正處理流量的是 Ingress Controller,例如 ingress engine X、Traefik、H A Proxy,需要另外安裝。沒有 controller,建立 Ingress 不會有任何作用。", "item": 0},
   {"say": "controller 之間是用 Ingress Class 來區分的,Ingress 裡用 ingress Class Name 這個欄位,指定要由哪一個 controller 來處理。", "item": 0},
   {"say": "本機練習的話,minikube 只要啟用 ingress 這個 addon 就可以了。", "item": 1},
   {"say": "如果用 kind,要依照 kind 官方文件的 Ingress 章節,在建立叢集的時候加上埠對應和節點標籤,再安裝 ingress controller。", "item": 2},
   {"say": "補充一點,Ingress 的 A P I 目前已經凍結,不會再加新功能,社群推動的後繼者是 Gateway A P I。不過學會入口、規則、後端這些概念之後,要轉換過去並不困難。", "item": 2}
  ],
  "Ingress:HTTP 路由與 TLS#3": [
   {"say": "來看 Ingress 的 YAML。", "item": 0},
   {"say": "規則裡先指定 host,也就是網域名稱,這裡是 shop 點 example 點 test。", "item": 1},
   {"say": "第一條路徑是斜線,也就是根路徑,會送到 web 這個 Service 的八十號埠。", "item": 2},
   {"say": "第二條路徑是斜線 A P I,會送到 A P I 這個 Service 的八零八零號埠。", "item": 3},
   {"say": "說明幾個重點。A P I Version 要寫 networking 點 K 八 S 點 I O 斜線 V 一。舊的 beta 版本已經移除了,網路上的舊教學如果還在用,套用就會失敗。", "item": 4},
   {"say": "path Type 是必填的。Prefix 是依照路徑的前綴來比對,以斜線分段。Exact 是要完全相符。還有一種是交給 controller 自己決定。", "item": 5}
  ],
  "Ingress:HTTP 路由與 TLS#4": [
   {"say": "還有三點補充。", "item": 0},
   {"say": "後端 Service 的埠,可以用數字,也可以用名稱來指定。", "item": 1},
   {"say": "如果同時有好幾條規則符合,通常是最長的路徑優先。", "item": 2},
   {"say": "同一個 host 底下可以有好幾個路徑,一份 Ingress 裡也可以有好幾個 host。", "item": 3}
  ],
  "Ingress:HTTP 路由與 TLS#5": [
   {"say": "對照 YAML 的骨架再看一次。", "item": 0},
   {"say": "A P I Version 是剛剛說的 networking 那一組。", "item": 1},
   {"say": "kind 是 Ingress。", "item": 2},
   {"say": "名稱叫 shop。", "item": 3},
   {"say": "spec 裡,先用 ingress Class Name 指定由 engine X 這個 controller 處理,下面的 rules,就是剛剛看的 host 和兩條路徑。", "item": 4}
  ],
  "Ingress:HTTP 路由與 TLS#6": [
   {"say": "建立好之後,我們來測試。", "item": 0},
   {"say": "這裡有個小技巧,用 curl 的減號大寫 H 指定 Host 標頭,就不用去修改本機的 hosts 檔案。", "item": 1},
   {"say": "先用 get ingress 查看。", "item": 2},
   {"say": "欄位有名稱、類別、主機、位址和埠。", "item": 3},
   {"say": "可以看到 shop 這筆規則,位址已經有值了。如果位址欄位是空的,代表 controller 還沒有回報位址,可以稍等一下,或是檢查 controller 的 Pod 狀態。", "item": 4},
   {"say": "最後用 curl 帶上 Host 標頭,連到那個位址,就能看到網站的回應了。", "item": 5}
  ],
  "Ingress:HTTP 路由與 TLS#7": [
   {"say": "最後來看怎麼加上 T L S,也就是 H T T P S。", "item": 0},
   {"say": "在 spec 底下加一段 T L S 設定,先列出 hosts。", "item": 1},
   {"say": "也就是要套用憑證的網域,這裡一樣是 shop 點 example 點 test。", "item": 2},
   {"say": "再用 secret Name 指向一個 T L S 類型的 Secret,裡面放的是憑證和私鑰。", "item": 3},
   {"say": "測試的時候,可以用 open S S L 建立一張三十天的自簽憑證,會產生一個憑證檔和一個私鑰檔。", "item": 4},
   {"say": "再用 kube control create secret T L S,把這兩個檔案做成 Secret。正式環境通常會搭配 cert manager 這類工具,自動申請和更新憑證。", "item": 5},
   {"say": "安全提醒,私鑰檔不要提交到 Git,測試用的金鑰檔用完也請記得刪除。", "item": 5}
  ],
  "closing": [
   {"say": "這一章就到這裡。你已經知道怎麼用 Service 提供穩定的入口,分得出各種 Service 類型,也會用 Ingress 做路由和 T L S 了。", "item": 0},
   {"say": "接下來,請親手做一次實作練習,再完成章末小測驗,看看自己學會了多少。我們下一章見!", "item": 1, "pause": 1}
  ]
 }
}
