环境准备

• 操作系统：CentOS 7/8、Ubuntu 18.04/20.04/22.04、Debian 9/10、Rocky Linux 等；
• 硬件配置：最小 2 CPU，4GB 内存；
• 网络：能够访问互联网（用于下载部署脚本和二进制文件）
• 依赖：系统需先安装 git 和 curl

安装基础依赖：

1
2
3
4
5

# CentOS/RHEL
yum install git curl

# Ubuntu/Debian
apt install git curl

下载 ezdown 脚本

1
2
3
4
5
6
7
8

# 设置需要安装的 kubeasz 版本，建议使用较新的稳定版
export RELEASE=3.6.8

# 下载脚本
wget https://github.com/easzlab/kubeasz/releases/download/${RELEASE}/ezdown

# 授予执行权限
chmod +x ./ezdown

下载二进制文件和镜像

这一步会下载 Kubernetes 组件（kubelet, kubectl, kube-apiserver等）、容器运行时（Docker/Containerd）以及必要的网络插件镜像

1
2

# -D 代表 Download，下载所有必要文件
./ezdown -D

启动 kubeasz 容器

下载完成后，我们需要启动 kubeasz 的管理容器。这个容器里集成了 Ansible 环境，我们将通过它来执行安装命令

1
2

# -S 代表 Start，启动 kubeasz 容器
./ezdown -S

执行一键安装

这是最关键的一步。kubeasz 提供了一个 ezctl 工具（在容器内），专门有一个 start-aio 命令用于单机部署

1
2

# 进入 kubeasz 容器并执行单机安装命令
docker exec -it kubeasz ezctl start-aio

验证安装

安装完成后，脚本会提示成功。你可以通过以下命令验证集群状态

1
2
3
4
5

# 验证节点状态 (应该显示 Ready)
kubectl get nodes

# 验证所有 Pod 状态 (应该都为 Running)
kubectl get pods -A

如果 kubectl 命令无法使用，请尝试重新加载环境变量或手动指定配置

1

source ~/.bashrc

常用维护命令

• 停止/重启集群

  安装完成后，这台机器就是一个标准的 K8s 节点。如果重启服务器，K8s 组件会自动启动

• 清理/卸载集群

  如果你想重置环境，可以使用以下命令清理所有 K8s 组件和数据（慎用）

  1	docker exec -it kubeasz ezctl destroy-aio

• 添加更多节点

  虽然你是按单机版部署的，但 kubeasz 允许你后续添加新节点。你需要进入容器 /etc/kubeasz 目录修改 hosts 文件，然后使用 ezctl add-node 命令扩容