下面是一份詳細的說明文檔，介紹該腳本的功能、用法及各部分的含義，供您參考和使用：

---

Kind 集群管理腳本說明文檔

此腳本主要用于管理 Kind（Kubernetes IN Docker）集群，提供創建、刪除、導出 kubeconfig、加載鏡像、切換集群、檢查狀態以及展示/列出預定義模板等功能。以下將詳細介紹腳本中各個部分的配置、命令及功能。

---

1. 配置項

腳本開頭定義了一些全局變量，用于配置運行時的參數：

• KUBECONFIG_PATH
  指定導出的 kubeconfig 文件存放位置，此處默認為當前目錄 ("./")。
• WITH_METRICS
  布爾值，表示是否在集群創建完成后自動部署 metrics-server。默認值為 false；如果設為 true，集群啟動后會應用對應的 metrics-server 配置。
• WITH_INGRESS
  布爾值，用于決定是否在創建集群時安裝 Ingress-Nginx 控制器。默認為 false；如果設為 true，集群啟動后會應用 Ingress-Nginx 配置。
• LOAD_IMAGE
  預留用于判斷是否需要加載 Docker 鏡像，目前腳本中由專門的 load-image 命令來處理該功能。
• DEFAULT_IMAGE
  如果未手動提供鏡像參數，則使用該默認鏡像（例如：kindest/node:v1.24.3）。
• checkmark & crossmark
  用于在輸出中顯示勾選（?）或叉（?），方便用戶直觀了解各項檢查的結果。
• TEMPLATES_DIR
  指定存放模板配置文件的目錄（例如：cluster-demo-setting 目錄）。
• DEFAULT_TEMPLATE
  默認的模板名字，如 ingress-cluster-demo，可用于預設集群配置。

---

2. 幫助信息

函數 usage() 提供了腳本的使用幫助信息。調用該函數時會輸出所有支持的命令及參數說明，包括：

• create：創建一個新的 Kind 集群
• delete：刪除指定的 Kind 集群
• export-kubeconfig：導出某個集群的 kubeconfig 文件
• load-image：將指定的 Docker 鏡像加載進 Kind 集群
• status：查看集群的狀態
• list：列出所有現有的 Kind 集群
• use：切換到指定的 Kind 集群
• cluster-demo-setting：列出或展示模板設置，子命令有 list 和 show
• help：輸出幫助信息

---

3. 命令工具檢查

在腳本初始化部分，會檢查以下兩個命令是否已安裝：

• kind
• kubectl

如果其中任一命令不存在，則腳本會輸出錯誤提示并退出。

---

4. 核心功能函數

4.1. run_command()

• 功能：打印調試信息（包括執行的命令及其結果），并調用 eval 來執行命令。
• 用途：便于跟蹤腳本執行過程中調用的系統命令和查看輸出結果。

4.2. load_template()

• 功能：加載指定名稱的模板配置。模板文件存放于 $TEMPLATES_DIR 目錄下，文件名格式為 templateName.yaml。
• 用途：用于在創建集群時加載特定的 Kind 配置文件。加載后內容會輸出，可用于調試或直接保存至集群配置文件中。

4.3. create_cluster()

• 功能：創建一個新的 Kind 集群，支持通過命令行參數指定鏡像和模板配置。
• 參數說明：
  • 第一個參數為集群名稱。
  • 選項 --image <image>：指定使用的鏡像（例如：--image kindest/node:v1.24.3）。
  • 選項 --config <template>：指定加載的模板配置文件名稱（模板文件位于 $TEMPLATES_DIR 下）。
  • 可選的 --default 參數用于直接使用默認鏡像。
• 操作流程：
  1. 解析命令行參數并提取集群名稱、鏡像和模板信息；
  2. 若指定模板，則調用 load_template() 加載配置，并保存至本地（文件名形如 cluster-name-kind-config.yaml）；
  3. 根據參數調用 kind create cluster 指令創建集群；
  4. 如果啟用了 WITH_METRICS 或 WITH_INGRESS，則自動安裝 metrics-server 或 Ingress-Nginx。

4.4. use_cluster()

• 功能：切換當前的 kubectl 上下文至指定的 Kind 集群。
• 實現：調用 kubectl config use-context kind-<cluster-name>。

4.5. export_kubeconfig()

• 功能：導出指定集群的 kubeconfig 到一個文件中，方便用戶直接使用。
• 實現：調用 kind get kubeconfig 并重定向輸出到文件（文件名為 <cluster-name>-kubeconfig）。

4.6. load_image()

• 功能：將本地的 Docker 鏡像加載到指定的 Kind 集群中。
• 實現：調用 kind load docker-image "<image-tag>" --name "<cluster-name>" 命令。

4.7. health_check()

• 功能：對集群進行健康檢查，檢測的組件包括：
  • 節點是否正常（通過 kubectl get nodes 檢查）；
  • metrics-server 是否正常運行；
  • Ingress controller 是否正常運行；
  • Demo 應用是否已經部署；
  • Ingress 路由是否配置成功。
• 輸出：每個檢查項均會打印出結果，用勾或叉來表示狀態。

4.8. cluster_demo_setting()

• 功能：用于處理與集群模板設置相關的命令：
  • 子命令 list：列出所有模板名稱，即 $TEMPLATES_DIR 目錄中所有以 .yaml 為后綴的文件；
  • 子命令 show <template-name>：顯示指定模板的詳細內容。

---

5. 命令行參數及分支邏輯

腳本通過 case "$1" in ... esac 結構，根據傳入的第一個命令來選擇不同的操作。常見的分支及說明如下：

• create
  調用 create_cluster 函數。要求必須指定集群名稱，并可附帶鏡像和模板參數。
• list
  列出所有已有的 Kind 集群，并打印當前的 kubeconfig 上下文信息。
• delete
  刪除指定的 Kind 集群，通過 kind delete cluster --name "<cluster-name>" 實現。
• status
  檢查并反饋指定集群是否存在于當前環境中。
• use
  切換當前上下文到指定 Kind 集群。
• load-image
  將本地 Docker 鏡像加載到指定集群中，此處需要提供集群名稱和鏡像標簽。
• export-kubeconfig
  導出指定集群的 kubeconfig 文件。
• health-check
  對集群的運行狀態進行綜合檢查，輸出各組件的健康狀態。
• cluster-demo-setting
  處理模板相關命令，支持：
  • list：列出所有模板
  • show <template-name>：顯示指定模板內容
• 其他（help 或未知命令）
  當命令為空或不匹配預定分支時，調用 usage() 輸出幫助信息。

---

6. 使用示例

6.1. 創建集群示例

假設要創建名為 demo-cluster 的集群，使用自定義鏡像和模板：

./script.sh create demo-cluster --image kindest/node:v1.24.3 --config ingress-cluster-demo

執行后腳本會：

• 加載 cluster-demo-setting/ingress-cluster-demo.yaml 文件，
• 生成集群配置文件，
• 調用 kind create cluster 創建集群，并根據配置安裝 metrics-server 和 ingress-nginx（如果全局變量開啟）。

6.2. 刪除集群示例

./script.sh delete demo-cluster

6.3. 切換集群上下文示例

./script.sh use demo-cluster

6.4. 導出 kubeconfig 示例

./script.sh export-kubeconfig demo-cluster

6.5. 加載鏡像示例

./script.sh load-image demo-cluster my-custom-image:latest

6.6. 查看健康檢查結果

./script.sh health-check

6.7. 查看模板列表和內容

• 列出所有模板：

  ./script.sh cluster-demo-setting list
  

• 查看某個模板內容：

  ./script.sh cluster-demo-setting show ingress-cluster-demo
  

---

7. 調試信息

每次調用命令都會通過 run_command() 打印出調試信息（命令及其執行結果），這有利于故障排查和驗證腳本執行的正確性。

---

8. 總結

本腳本整合了多種常用的 Kind 集群管理操作，通過封裝命令行參數，用戶可以方便地創建、刪除、管理以及調試 Kind 集群。同時還提供了加載模板配置、檢查健康狀態等實用功能。建議在使用前確認已安裝 kind 和 kubectl，并根據需要調整全局配置變量（如開啟 metrics-server 或 ingress 安裝）。

希望這份說明文檔能夠幫助您快速了解和使用該腳本。如有疑問或需要進一步定制，歡迎進一步探討。