Ubuntu 20.04实战：用KubeKey 2.0.0高效搭建K8s集群并部署DeepFlow社区版

当开发者需要在本地环境或测试服务器上快速搭建Kubernetes集群时，工具的选择往往决定了整个过程的顺畅程度。最近在Ubuntu 20.04系统上的一次实践让我深刻体会到，相比官方推荐的Sealos，KubeKey 2.0.0在下载速度、安装便捷性和网络适应性方面表现更为出色。本文将分享如何用KubeKey快速构建K8s环境，并在此基础上成功部署DeepFlow社区版的全过程，包含实际验证过的命令和避坑指南。

1. 为什么选择KubeKey替代Sealos

在最初尝试使用Sealos部署Kubernetes时，遇到了镜像下载速度极慢的问题。官方提供的labring/kubernetes镜像在国内网络环境下拉取速度经常低于100KB/s，一个400MB的镜像需要耗费数小时。这种体验对于需要快速搭建测试环境的开发者来说简直是噩梦。

相比之下，KubeKey 2.0.0具有以下优势：

• 下载速度快：通过设置KKZONE=cn环境变量，自动使用国内镜像源
• 依赖检查全面：自动验证系统环境是否符合安装要求
• 配置简单：单条命令即可完成集群创建
• 版本灵活：支持指定Kubernetes版本

实际测试中，KubeKey的安装包下载仅需10秒左右，整个集群创建过程在配置合理的服务器上不超过5分钟。

2. 使用KubeKey部署Kubernetes集群

2.1 环境准备

确保系统为Ubuntu 20.04 LTS，并已配置sudo权限。建议使用至少2核CPU、4GB内存的机器。执行以下命令更新系统：

sudo apt update && sudo apt upgrade -y sudo apt install -y curl socat conntrack ebtables ipset

2.2 安装KubeKey

设置国内下载区域并获取KubeKey二进制文件：

export KKZONE=cn curl -sfL https://get-kk.kubesphere.io | VERSION=v2.0.0 sh - chmod +x kk

验证安装成功：

./kk version

2.3 创建单节点集群

对于开发和测试环境，单节点集群是最便捷的选择。以下命令将部署Kubernetes v1.21.5：

./kk create cluster --with-kubernetes v1.21.5

安装过程中，KubeKey会显示系统检查结果并要求确认：

+------+------+------+---------+----------+-------+-------+-----------+--------+----------+ | name | sudo | curl | openssl | ebtables | socat | ipset | conntrack | docker | time | +------+------+------+---------+----------+-------+-------+-----------+--------+----------+ | mypc | y | y | y | y | y | y | y | 20.10 | CST 10:06| +------+------+------+---------+----------+-------+-------+-----------+--------+----------+

输入yes继续安装。完成后验证集群状态：

kubectl get pod -A

正常输出应显示所有核心组件处于Running状态。

3. 部署DeepFlow社区版

DeepFlow是一款开源的云原生可观测性平台，提供全栈监控能力。以下是部署步骤：

3.1 添加Helm仓库

helm repo add deepflow https://deepflow-ce.oss-cn-beijing.aliyuncs.com/chart/stable helm repo update

3.2 创建自定义配置

创建values-custom.yaml文件指定国内镜像源：

global: allInOneLocalStorage: true image: repository: registry.cn-beijing.aliyuncs.com/deepflow-ce grafana: image: repository: registry.cn-beijing.aliyuncs.com/deepflow-ce/grafana

3.3 安装DeepFlow

执行Helm安装命令：

helm install deepflow -n deepflow deepflow/deepflow --create-namespace -f values-custom.yaml

等待所有Pod就绪：

kubectl get pods -n deepflow -w

3.4 访问Grafana面板

获取访问信息：

NODE_PORT=$(kubectl get --namespace deepflow -o jsonpath="{.spec.ports[0].nodePort}" services deepflow-grafana) NODE_IP=$(kubectl get nodes -o jsonpath="{.items[0].status.addresses[0].address}") echo -e "Grafana URL: http://$NODE_IP:$NODE_PORT \nGrafana auth: admin:deepflow"

在浏览器中打开输出的URL，使用admin/deepflow登录即可看到DeepFlow预置的监控仪表板。

4. 常见问题与优化建议

4.1 网络问题排查

如果遇到镜像拉取失败，可尝试以下方法：

• 检查节点是否能正常访问registry.cn-beijing.aliyuncs.com
• 手动拉取镜像并重新标记：

docker pull registry.cn-beijing.aliyuncs.com/deepflow-ce/agent:v6.0.0 docker tag registry.cn-beijing.aliyuncs.com/deepflow-ce/agent:v6.0.0 deepflow/agent:v6.0.0

4.2 资源分配调整

默认配置可能不适合资源有限的机器，可修改values-custom.yaml：

deepflowServer: resources: limits: cpu: "1" memory: "2Gi" requests: cpu: "0.5" memory: "1Gi"

4.3 数据持久化配置

生产环境建议配置持久化存储，避免数据丢失：

global: allInOneLocalStorage: false storageClass: "your-storage-class"

这套方案在多次测试中表现出极佳的稳定性和可重复性，特别适合国内开发者快速搭建K8s开发测试环境。KubeKey的简洁设计和DeepFlow的开箱即用特性，让云原生监控的门槛大幅降低。