動機

「在看文件時，絕對不要跳過 introduction」是我在學生時期就聽過大神講過的建議，但發現最近自己越來越長在找解答時，會很不自覺的直接去看程式碼區段，然後直接貼上試試看結果，成功了也不知道為什麼成功，知識就無法累積下來。
因此想藉由這個機會，好好的看看 k8s 豐富的文件裡面藏著哪些有趣的東西，學習起來。

本系列文章適合對象

由於此系列文章預計是會由我的角度去解讀文件，因此先介紹一下我的背景：

• 約 k8s 1.20 入坑，緩慢學習接觸了 2 年多
• DevOps 工程師，k8s 系統管理員
• 若以證書來看我的技能樹：
  • (k8s) CKA, CKAD 兩張證書
  • (Networking) 上過 CCNA 的網路課
  • (Linux) RHCSA
• k8s 總是在玩 deployment, service 的最常見好用的物件，比較少有深度的配置

大致以上！

預計目標

https://kubernetes.io/docs/home/

打開 k8s 文件，可以看到左邊的大目錄大約分層如下：

1. Getting Started：描述如何準備一座 k8s cluster，以及建議的相關配置
2. Concepts：各式各樣的主題，解釋其中的概念
   1. 包含 cluster 架構、containers、Workloads、儲存、policies 等等
3. Tasks：更細緻的說明各式各樣的主題，以及提供一些簡短的步驟設定
   1. 包含 APP 環境變數配置，secret 管理，TLS 憑證等
4. Tutorials：教學文件，包含基礎，APP 配置，安全性等等，
5. Reference：主要是所有 API 的參考文件，以及 k8s 元件的配置等等，也有許多不是由 kube-apiserver 提供的 (config APIs)
6. Contribute：貢獻方式與準則等等，可透過更新、翻譯文件，或者參與某個 SIG (special interest groups) 團體來貢獻。
   因為 k8s 是開源軟體，所以知道如何貢獻也是很重要的資訊！

光是瀏覽一下上方的資訊就發現裡面真的很多平時不會用到但有趣的功能 (汗

依照上面的排列，會用以下幾個主題來延伸：

1. 5d - 如何安裝
2. 10d - 各組件 or 整座 cluster 可通用的配置
3. 10d - workload 相關的配置，HA，網路排查
4. 5d - 彈性調整

以上是暫時的目錄，等到後續完賽後會再完善此目錄

結語

要從各式各樣的文件找到有用的資訊整理出來感覺不太容易，但希望我可以努力完成挑戰囉！