# 进入防止 kind-tool.sh 的目录
$ cd kt-dir/
# 用 alias 给个别名，更便于使用
$ alias kt="./kind-tool.sh"
# 创建单节点集群，此种默认采用最新版本镜像
$ kt create single-node-cluster
# 指定 k8s 镜像版本
$ kt create single-node-cluster --image kindest/node:v1.24.5
# 采用 默认版本（目前配置为 kindest/node:v1.24.3 ）—— k8s 1.24.3 版本
$ kt create single-node-cluster --default
# 查看目前配置的多节点集群模板
$ kt cds list
🔍 Listing all available templates:
- 3node-demo
- ingress-cluster-demo
# 创建 3 节点的集群
$ kt create 3-node-cluster --image kindest/node:v1.24.3 --config 3node-demo
# 查看当前所有集群
$ kt list
# 删除集群
$ kt delete 3-node-cluster
# 加载指定镜像到指定集群
$ kt load 3-node-cluster busybox:latest
# 查看帮助信息
$ kt -h
Usage: ./kind-tool.sh [command] [options]
Commands:
create <cluster-name> [--image <image>] [--config <template>] [--default] Create a new Kind cluster
sub-args:
--image <image> Create a cluster using the image you specified
--config <template> Template is used to configure the architecture of the cluster (multi node or port exposure)
--default Create a cluster using the default image version (k8s 1.24.3)
delete <cluster-name> Delete the Kind cluster
export-kubeconfig <cluster-name> Export Kubeconfig for cluster, Short command(ek)
load-image <cluster-name> <image> Load Docker image into Kind cluster, Short command(load)
status <cluster-name> Get cluster status
list List all existing Kind clusters
use <cluster-name> Switch to the specified Kind cluster
cluster-demo-setting <subcommand> [options] Short command(cds for cluster-demo-setting)
subcommands:
list List all supported templates
show <template-name> Show the content of a specific template
help Display this help message
脚本
#!/bin/bash
# 配置
KUBECONFIG_PATH="./"
WITH_METRICS=false
WITH_INGRESS=false
LOAD_IMAGE=false
DEFAULT_IMAGE="kindest/node:v1.24.3" # 默认镜像
# 显示勾选或叉
checkmark="✅"
crossmark="❌"
# 模板配置
TEMPLATES_DIR="cluster-demo-setting"
DEFAULT_TEMPLATE="ingress-cluster-demo"
# 打印帮助信息
usage() {
echo "Usage: $0 [command] [options]"
echo "Commands:"
echo " create <cluster-name> [--image <image>] [--config <template>] [--default] Create a new Kind cluster"
echo " sub-args:"
echo " --image <image> Create a cluster using the image you specified "
echo " --config <template> Template is used to configure the architecture of the cluster (multi node or port exposure)"
echo " --default Create a cluster using the default image version (k8s 1.24.3)"
echo " delete <cluster-name> Delete the Kind cluster"
echo " export-kubeconfig <cluster-name> Export Kubeconfig for cluster, Short command(ek)"
echo " load-image <cluster-name> <image> Load Docker image into Kind cluster, Short command(load)"
echo " status <cluster-name> Get cluster status"
echo " list List all existing Kind clusters"
echo " use <cluster-name> Switch to the specified Kind cluster"
echo " cluster-demo-setting <subcommand> [options] Short command(cds for cluster-demo-setting)"
echo " subcommands:"
echo " list List all supported templates"
echo " show <template-name> Show the content of a specific template"
echo " help Display this help message"
exit 1
}
# 检查是否安装 kind 和 kubectl
command -v kind &>/dev/null || { echo "Kind is not installed!"; exit 1; }
command -v kubectl &>/dev/null || { echo "kubectl is not installed!"; exit 1; }
# 打印命令并执行
run_command() {
echo "-------- Command Info -------"
echo "Executing: $1"
echo "<-------- Command Result ------->"
eval "$1"
echo " "
}
# 加载指定模板配置
load_template() {
TEMPLATE_NAME=$1
TEMPLATE_FILE="$TEMPLATES_DIR/$TEMPLATE_NAME.yaml"
if [ ! -f "$TEMPLATE_FILE" ]; then
echo "Error: Template '$TEMPLATE_NAME' not found!"
exit 1
fi
echo "#Using template '$TEMPLATE_NAME' from $TEMPLATE_FILE..."
cat "$TEMPLATE_FILE"
echo
}
# 创建集群
create_cluster() {
CLUSTER_NAME=$1
IMAGE=
TEMPLATE=
shift # 移除第一个参数（集群名称）
# 解析命令行参数
while [[ "$#" -gt 0 ]]; do
case $1 in
--image) IMAGE="$2"; shift 2 ;;
--config) TEMPLATE="$2"; shift 2 ;;
--default) IMAGE=$DEFAULT_IMAGE; shift ;;
*) echo "Unknown parameter: $1"; usage ;;
esac
done
echo "🚀 Creating Kind cluster: $CLUSTER_NAME with image: $IMAGE and template: $TEMPLATE..."
# 加载模板
if [ -n "$TEMPLATE" ]; then
load_template "$TEMPLATE" > "$CLUSTER_NAME-kind-config.yaml"
CONFIG="--config $(pwd)/$CLUSTER_NAME-kind-config.yaml"
fi
# 打印并执行创建集群命令
if [ -n "$CONFIG" ] && [ -n "$IMAGE" ]; then
run_command "kind create cluster --name \"$CLUSTER_NAME\" --image \"$IMAGE\" $CONFIG"
elif [ -n "$CONFIG" ]; then
run_command "kind create cluster --name \"$CLUSTER_NAME\" $CONFIG"
elif [ -n "$IMAGE" ]; then
run_command "kind create cluster --name \"$CLUSTER_NAME\" --image \"$IMAGE\""
else
run_command "kind create cluster --name \"$CLUSTER_NAME\""
fi
# 如果需要安装 metrics-server
if $WITH_METRICS; then
echo "📊 Installing metrics-server..."
run_command "kubectl apply -f https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/components.yaml"
fi
# 如果需要安装 ingress-nginx
if $WITH_INGRESS; then
echo "🌐 Installing ingress-nginx..."
run_command "kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/main/deploy/static/provider/cloud/deploy.yaml"
fi
echo "✅ Cluster created successfully!"
}
# 切换集群
use_cluster() {
CLUSTER_NAME=$1
echo "🔄 Switching to Kind cluster: $CLUSTER_NAME..."
run_command "kubectl config use-context kind-$CLUSTER_NAME"
echo "✅ Switched to $CLUSTER_NAME."
}
# 导出 kubeconfig 文件
export_kubeconfig() {
CLUSTER_NAME=$1
echo "📤 Exporting kubeconfig to $KUBECONFIG_PATH..."
# 打印并执行导出 kubeconfig 命令
KUBECONFIG_FILE="./$CLUSTER_NAME-kubeconfig"
run_command "kind get kubeconfig --name \"$CLUSTER_NAME\" > \"$KUBECONFIG_FILE\""
echo "✅ Kubeconfig exported!"
}
# 加载 Docker 镜像到 Kind 集群
load_image() {
CLUSTER_NAME=$1
IMAGE_TAG=$2
echo "💾 Loading Docker image '$IMAGE_TAG' into Kind cluster '$CLUSTER_NAME'..."
# 打印并执行加载镜像命令
run_command "kind load docker-image \"$IMAGE_TAG\" --name \"$CLUSTER_NAME\""
echo "✅ Image loaded successfully!"
}
# 健康检查函数
health_check() {
echo "🧠 Running health check for the cluster..."
echo -n "🧩 Nodes reachable: "
run_command "kubectl get nodes &>/dev/null && echo \"$checkmark\" || echo \"$crossmark\""
echo -n "📈 Metrics-server running: "
run_command "kubectl get deployment metrics-server -n kube-system &>/dev/null && echo \"$checkmark\" || echo \"$crossmark\""
echo -n "🌐 Ingress controller running: "
run_command "kubectl get pods -n ingress-nginx &>/dev/null && echo \"$checkmark\" || echo \"$crossmark\""
echo -n "🧪 Demo app deployed: "
run_command "kubectl get deploy demo &>/dev/null && echo \"$checkmark\" || echo \"$crossmark\""
echo -n "🛰️ Ingress route configured: "
run_command "kubectl get ingress demo-ingress &>/dev/null && echo \"$checkmark\" || echo \"$crossmark\""
}
# 处理集群模板设置命令
cluster_demo_setting() {
if [[ "$1" == "list" ]]; then
echo "🔍 Listing all available templates:"
for template in "$TEMPLATES_DIR"/*.yaml; do
echo "- $(basename "$template" .yaml)"
done
elif [[ "$1" == "show" ]]; then
if [[ -z "$2" ]]; then
echo "Error: Template name is required!"
exit 1
fi
load_template "$2"
else
echo "Unknown subcommand: $1"
usage
fi
}
# 集群命令执行
case "$1" in
"create")
if [ -z "$2" ]; then
echo "Cluster name is required!"
usage
fi
# ${@:2} 表示从忽略第一个参数，传入其余所有参数
create_cluster "${@:2}"
;;
"list")
echo "🔍 Listing all existing Kind clusters..."
run_command "kind get clusters"
run_command "kubectl config get-contexts"
run_command "kubectl config current-context"
;;
"delete")
if [ -z "$2" ]; then
echo "Cluster name is required!"
usage
fi
echo "🗑️ Deleting Kind cluster: $2..."
run_command "kind delete cluster --name \"$2\""
;;
"status")
if [ -z "$2" ]; then
echo "Cluster name is required!"
usage
fi
echo "🔍 Checking cluster status..."
run_command "kind get clusters | grep -q \"$2\" && echo \"$checkmark Cluster exists: $2\" || echo \"$crossmark Cluster does not exist.\""
;;
"use")
if [ -z "$2" ]; then
echo "Cluster name is required to switch!"
usage
fi
use_cluster "$2"
;;
"load"|"load-image")
if [ -z "$2" ] || [ -z "$3" ]; then
echo "Both cluster name and image tag are required!"
usage
fi
load_image "$2" "$3"
;;
"ek"|"export-kubeconfig")
if [ -z "$2" ]; then
echo "Cluster name is required!"
usage
fi
export_kubeconfig "$2"
;;
"health-check")
health_check
;;
"cds"|"cluster-demo-setting")
cluster_demo_setting "${@:2}"
;;
"-h"|"--help"|"help")
usage
;;
*)
usage
;;
esac
