Skip to content

Kubernetes 本地集群安裝教學

Kubernetes 本地集群安裝教學是指開發者為了在本地環境進行開發與測試，利用工具建立單機 Kubernetes 集群的過程。^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md]

建立本地集群可以模擬生產環境，讓開發者在沒有雲端資源的情況下驗證應用程式與部署配置。^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md] 由於 Kubernetes 更新速度極快（約每三個月一次小版本更新），API 變動頻繁，因此建立一個穩定且版本明確的本地環境對於學習與開發至關重要^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md]。

安裝方式：Docker Desktop

市面上有多種工具可以快速建立本地 Kubernetes 集群，其中 Docker Desktop 是最便捷的選擇之一，它內建了 Kubernetes 功能，允許開發者啟用一個單節點的本地集群^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md]。

1. 安裝 Docker Desktop

在 macOS 上，首先需要從官方網站下載 Docker Desktop 的安裝檔案（.dmg）^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md]。安裝過程非常簡單，只需將下載的圖示拖曳至 Application 資料夾即可^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md]。

完成安裝後，啟動 Docker.app，看到初始介面即代表 Docker Desktop 已成功運行^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md]。

2. 啟用 Kubernetes

Docker Desktop 安裝完成後，預設並未開啟 Kubernetes。開發者需要手動啟用此功能^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md]。

  1. 進入設定：點擊 Docker Desktop 圖示右上角的小齒輾圖示（Settings）^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md]。
  2. 啟用服務：在設定選單中找到 Kubernetes 選項，勾選 Enable Kubernetes^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md]。
  3. 套用並重啟：點擊 Apply & Restart 按鈕^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md]。

系統將會開始下載並安裝運行 Kubernetes 所需的容器映像檔，這個過程可能需要花費幾分鐘時間^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md]。

3. 驗證安裝狀態

安裝完成後，可以透過 Docker Desktop 的圖形介面（GUI）確認 Kubernetes 的狀態。正常情況下，Kubernetes 服務旁邊的燈號應為綠燈，且左側列表中會出現 Kubernetes 相關的容器正在運行^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md]。

為了確保指令列工具（CLI）運作正常，可以使用 kubectl 指令來驗證集群連線^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md]。

查看集群資訊

輸入以下指令以確認是否已成功連接到集群^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md]：

[kubectl cluster-info](<./kubectl-cluster-info.md>)

查看節點狀態

檢查本地集群的節點是否準備就緒^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md]：

[kubectl](<./kubectl.md>) get nodes

查看版本資訊

確認安裝的 Kubernetes 版本，以確保與目標環境相容^[400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md]：

[kubectl](<./kubectl.md>) version --short

相關概念

  • [[Kubernetes 本地開發工作流]]：了解如何利用本地集群進行應用程式的開發與部署。
  • Kubernetes：Kubernetes 的核心概念與架構。
  • Container：容器化技術的基礎。
  • [[Docker]]：Docker 的基礎使用與映像檔管理。

Sources

  • 400-devops__06-Kubernetes__k8s-ithelp__Day4__README.md