今日目標

• 理解 Minikube 的運作原理與優勢。
• 完成本地環境前置需求安裝（Docker 與 Minikube CLI）。
• 成功啟動第一個單節點 Kubernetes 集群並驗證運行狀態。

為什麼選擇 Minikube？

在正式學習 Kubernetes 的各種物件與指令前，我們需要一個可以自由測試的實驗環境。

在生產環境中，Kubernetes 通常是由多台伺服器組成的跨機器集群。然而，在個人電腦上記錄與學習時，維護多台虛擬機往往會佔用過多的 CPU 與記憶體資源。

Minikube 是 Kubernetes 官方維護的輕量化工具。它的核心原理是在本地透過容器（Docker）或虛擬機，將 Control Plane 與 Worker Node 的所有元件打包在單個節點中。這讓我們能在個人電腦上，用極低的資源成本完整體驗 Kubernetes 的核心功能。

前置環境準備

在安裝 Minikube 之前，電腦需要先具備以下基礎環境：

1. Docker Desktop：作為 Minikube 的底層驅動引擎（Driver）。
2. Minikube CLI：用於建立與管理本地 K8s 集群的命令列工具。
3. kubectl：Kubernetes 的官方命令列工具，用於發送指令給集群。

安裝步驟簡介

• macOS (使用 Homebrew)：

  brew install minikube
  brew install kubernetes-cli

• Windows (使用 Chocolatey)：

choco install minikube
choco install kubernetes-cli

安裝完成後，請確保 Docker Desktop 已正常啟動。

實戰操作：啟動與驗證集群

1. 啟動 Minikube 集群

打開終端機（Terminal），執行以下指令啟動集群：

minikube start --driver=docker

這個指令會自動下載所需的 Kubernetes 映像檔，並在 Docker 中啟動一個單節點環境。

2. 檢查集群狀態

集群啟動完成後，可以使用以下指令確認 Minikube 的運行狀態：

minikube status

預期會看到 host, kubelet, apiserver 等元件均顯示為 Running。

3. 驗證 kubectl 連線

確認 kubectl 是否已自動綁定到 Minikube 集群：

kubectl get nodes

若配置正確，終端機將列出名為 minikube 的節點，且狀態顯示為 Ready。

踩坑紀錄與 Troubleshooting

• Issue: Driver 權限不足或 Docker 未啟動

• 現象：執行 minikube start 時提示 Exiting due to DRVR_DOCKER_NOT_RUNNING。

• 解法：確認 Docker Desktop 是否已經開啟並正常運作。若在 Linux 環境，需確認當前使用者已加入 docker 群組。

• Issue: 網路下載逾時

• 現象：首次啟動時下載 Kubernetes 映像檔速度過慢或失敗。

• 解法：可加上 --image-mirror-country='cn' 或確認本地網路代理設定。

本日小結

今天我們成功在本地使用 Minikube 建立了第一個單節點 Kubernetes 集群，並透過 kubectl 驗證了連線。有了這個穩定的實驗環境，後續我們就能開始嘗試各種部署與操作。

明天 Day 05，我們將學習如何使用 Kubernetes 的官方 CLI 工具：「與 K8s 對話：kubectl 常用指令與指令式（Imperative）操作」！