kubeasz 快速指南：一键部署 Kubernetes-k8s 测试环境

kubeasz 是一款基于 Ansible 的 Kubernetes 集群部署工具，通过简单的配置即可实现一键式部署，大大降低了 Kubernetes 的运维成本和时间。它支持多种操作系统和云平台，提供了丰富的配置选项，可以快速部署高可用的 Kubernetes 集群。无论是对于云原生应用的开发者和运维人员，还是对于希望快速转型到微服务架构的企业和组织来说，kubeasz 都是一个值得考虑的选择。

项目地址：https://github.com/easzlab/kubeasz

本文档适用于 kubeasz 3.3.1 以上版本，部署单节点集群（aio），作为快速体验 k8s 集群的测试环境。

1. 基础系统配置

准备一台虚机配置内存 4G / 硬盘 30G 以上
最小化安装 Ubuntu 22.04 server
配置基础网络、更新源、SSH 登录等

注意：确保在干净的系统上开始安装，不能使用曾经装过 kubeadm 或其他 k8s 发行版的环境。

2. 下载文件

2.1 下载工具脚本 ezdown

以 kubeasz 版本 3.6.7 为例：

复制代码

export release=3.6.7 wget https://github.com/easzlab/kubeasz/releases/download/${release}/ezdown chmod +x ./ezdown

更多关于 ezdown 的参数，运行 ./ezdown 查看。

2.2 使用工具脚本下载

下载 kubeasz 代码、二进制、默认容器镜像：

复制代码

# 国内环境 ./ezdown -D # 海外环境 # ./ezdown -D -m standard

2.3 可选：下载额外容器镜像

按需下载，如 cilium、flannel、prometheus 等：

复制代码

./ezdown -X dashboard ./ezdown -X prometheus # ...

2.4 可选：下载离线系统包

适用于无法使用 yum/apt 仓库的情形：

复制代码

./ezdown -P

上述脚本运行成功后，所有文件（kubeasz 代码、二进制、离线镜像）均已整理好放入目录 /etc/kubeasz：

/etc/kubeasz：包含 kubeasz 版本为 ${release} 的发布代码
/etc/kubeasz/bin：包含 k8s/etcd/docker/cni 等二进制文件
/etc/kubeasz/down：包含集群安装时需要的离线容器镜像
/etc/kubeasz/down/packages：包含集群安装时需要的系统基础软件

3. 安装集群

3.1 容器化运行 kubeasz

复制代码

./ezdown -S

3.2 使用默认配置安装 aio 集群

复制代码

docker exec -it kubeasz ezctl start-aio

提示：如果安装失败，查看日志排除后，使用如下命令重新安装 aio 集群：

复制代码

docker exec -it kubeasz ezctl setup default all

4. 验证安装

复制代码

source ~/.bashrc kubectl version # 验证集群版本 kubectl get node # 验证节点就绪 (Ready) 状态 kubectl get pod -A # 验证集群 pod 状态，默认已安装网络插件、coredns、metrics-server 等 kubectl get svc -A # 验证集群服务状态

5. 清理

以上步骤创建的 K8S 开发测试环境请尽情折腾，碰到错误尽量通过查看日志、上网搜索、提交 issues 等方式解决；当然你也可以清理集群后重新创建。

在宿主机上，按照如下步骤清理：

复制代码

# 清理集群 docker exec -it kubeasz ezctl destroy default # 重启节点，以确保清理残留的虚拟网卡、路由等信息 sudo reboot

发布到 CSDN 的建议

如果你计划将本文发布到 CSDN，以下几点建议可供参考：

1. 文章类型选择

发布前记得从下拉菜单中选择合适的文章分类，如「技术干货」、「开发经验」等，否则可能导致发布失败。

2. 转载与出处声明

CSDN 平台倡导尊重原创、鼓励原创的知识分享模式。建议在文章开头或结尾明确注明出处：

本文转载自 GitHub - easzlab/kubeasz，遵循 CC 4.0 BY-SA 版权协议。

3. 排版优化建议

使用 Markdown 编辑器的「目录索引」功能，方便读者快速跳转；
代码块使用标准格式（三个反引号 + 语言标识），确保代码展示效果；
适当使用加粗、引用等样式突出重点内容。

4. 注意事项

CSDN 对文章中的外链有一定审核要求，建议精简配图和外链数量，确保链接指向权威技术站点；
纯技术类文章的审核周期约为 6-12 小时，建议合理安排发布时间；
标题应真实反映文章内容，避免夸张表述。

本文档翻译整理自 kubeasz 官方快速指南 ，适用于 kubeasz 3.3.1 以上版本。