如果你正准备开始学Kubernetes第一道坎往往不是概念而是环境。很多人照着教程兴冲冲地执行kubectl get nodes结果卡在安装这一步上。我自己在CentOS 7上装minikube前前后后折腾了不下两天踩过不少坑。这篇内容就是从那段实操记录里整理出来的Step by Step 讲清楚在CentOS 7环境中把minikube跑起来这件事顺带把常见报错和绕坑技巧一并写出来。K8s学习这件事最忌讳的就是“只想不练”。minikube是目前最适合本地学习的单节点Kubernetes环境工具它能在你的电脑或服务器上快速拉起一个可用的集群用来验证Pod、Deployment、Service这些核心概念完全够用。而CentOS 7作为企业服务器最常见的操作系统之一踩坑记录也最多很多人手里正好有CentOS 7的虚拟机。所以这篇文章主要面向刚接触K8s、想在本地或虚拟机上搭环境、又不想一上来就搞多节点集群的同学。1. 为什么用minikube入门K8s1.1 单机搭建K8s集群的痛点很多人最初的想法是直接装一个完整的Kubernetes集群三个master五个node全都照官方文档来。问题是Kubernetes分布式系统的安装并不友好——你要搞定etcd、API Server、kubelet、kube-proxy、CNI插件还得处理证书、网络、高可用这些组件。光是理解“每个组件在干什么”就已经够头大了更别提所有组件之间的相互依赖。如果你只有一台机器多节点集群方案基本走不通。用虚拟机模拟多节点又要求宿主机内存足够大否则单单运行三四个虚拟机就卡得动弹不得。我见过不少同学用2G内存的机器跑minikube直接起不来。所以说本地学习阶段最需要的不是“像生产环境一样复杂”而是“能把核心概念跑起来”。1.2 minikube在本地扮演的角色minikube是一个能在本地运行单节点Kubernetes的工具。它支持多种驱动Docker、KVM、VirtualBox、Hyper-V甚至直接作为普通进程运行。它的价值在于把“K8s控制平面”和“工作节点”都压缩到一个环境中你在终端敲下minikube start它就会自动帮你把API Server、etcd、Controller Manager、Scheduler、kubelet等组件拉起来最终返回给你一个可以正常执行kubectl命令的集群。对学习而言这太重要了。你可以在这个单节点环境里练习Pod编排、Deployment滚动更新、Service暴露访问、ConfigMap和Secret挂载。环境烂了就minikube delete一键清理完全不影响宿主机。它不像生产环境那么复杂但足以让你把官方文档里的核心概念实际操作一遍。1.3 为什么特别强调CentOS 7CentOS 7是很多教学文档里的“默认系统”因为它的生命周期长、资料多、yum依赖成熟而且企业内部运维体系里大量存量机器就是CentOS 7。虽然它默认内核是3.10比起新内核有一些限制但跑minikube是没问题的。还有一个原因是CentOS 7下面安装Docker、配置镜像加速、管理systemd服务都很顺手不像某些轻量系统那样缺依赖缺到让人怀疑人生。不过我要提前说一句CentOS 7默认没有带图形界面很正常minikube本身也不依赖图形界面只要命令行能连上就行。如果你用的是最小化安装后面只需要补上必要的工具包不需要重新装系统。1.4 这篇内容适合谁如果你是正在准备CKA考试、刚看完K8s理论想动手实践、或者在Windows上用虚拟机装了CentOS 7但不想再装第二个Kubernetes发行版的人这篇文章都适合。读完你可以照着命令一步步操作中间遇到报错也能从常见问题那一章里找到对应解法。需要的基础知识不多会敲Linux命令、知道Docker常用操作就可以开始。2. 安装前的环境准备2.1 确认系统版本与内核我在实际运行中第一步会先确认系统的具体版本别拿到一个CentOS 7变体就直接往下走。cat /etc/redhat-release uname -r输出里一般会看到CentOS Linux release 7.9.2009 (Core)内核是3.10.0-xxx.el7.x86_64。只要位数是x86_64基本没问题。如果内核太低比如3.10.0-693之前的版本建议先yum update -y升级一下系统和内核再重启进入新内核避免后面因为旧内核出现奇怪的兼容性问题。这里还涉及到SELinux。CentOS 7默认SELinux是enforcing状态虽然Docker驱动一般不受影响但为了减少安装过程中因为安全上下文被拒绝的情况我通常会把SELinux临时调整为permissive安装完再恢复。这不是必须操作但能省掉一部分排查时间。2.2 硬件资源要求先别急着装软件用下面命令看一眼机器配置nproc free -h df -h /var/lib/dockerminikube官方建议的最低配置是2核CPU、2GB内存、20GB可用磁盘但根据我的实测2GB内存会比较吃力启动后集群基本没什么余量给Pod跑。如果你是想正常做实验我建议至少4GB内存CPU 2核以上。磁盘方面要注意Docker镜像和minikube虚拟磁盘都会占用空间尤其是启动时会拉取基础镜像临时空间不够很容易导致启动中断。下面是一个参考配置表资源项最低要求推荐配置说明CPU2核4核及以上编译调度、运行Pod都需要CPU内存2GB4GB及以上低于3GB容易OOM磁盘20GB40GBDocker镜像、minikube缓存占空间网络能访问外网宽带网络需要拉取K8s组件镜像2.3 检查虚拟化支持在CentOS 7上使用minikube时驱动选择很重要。如果你打算用KVM驱动宿主机必须支持并开启VT-x/AMD-V嵌套虚拟化。尤其是虚拟机里装CentOS 7再跑minikube的场景必须确认宿主机的CPU虚拟化已经透传进来。可以用下面命令快速检查egrep -c (vmx|svm) /proc/cpuinfo返回的数字大于0说明支持。如果返回0说明当前环境下不支持嵌套虚拟化那就别折腾KVM了老老实实用Docker驱动也就是让minikube在一个容器里运行Kubernetes节点这种方式不依赖CPU虚拟化实际体验也更简单。2.4 安装DockerCentOS 7安装Docker的方式有好几种我建议从Docker官方仓库安装能保证版本比较新。先把yum源配置好yum install -y yum-utils yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo yum install -y docker-ce docker-ce-cli containerd.io国内网络下载这个源可能很慢如果你的服务器在境内建议先配置一个国内镜像加速器然后把Docker的源地址换成镜像站。这一步本质上是让Docker从可达的HTTP源拉取rpm包不涉及任何额外的网络动作只是加快安装速度。装完以后启动Docker并设置开机自启systemctl enable --now docker docker version看到Client和Server都正常输出即可。如果Server段报错多半是守护进程没起来用journalctl -u docker看日志。2.5 把当前用户加入docker组安装完Docker后直接用root操作虽然省事但后续minikube生成的配置文件放在当前用户的home目录下会比较干净。而且我不建议始终用root执行minikube命令因为某些环境变量和权限处理会有差异。把当前用户加入docker组可以避免每条命令都加sudousermod -aG docker $USER newgrp docker docker ps如果还是提示权限问题最彻底的办法是注销重新登录一次。这一步很重要我遇过很多人卡在docker permission denied上以为是minikube的问题其实只是没加入docker组。2.6 关于容器运行时的选择minikube目前主要依赖Docker驱动来运行Kubernetes节点。CentOS 7上Docker本身可以直接用不需要额外安装containerd配置文件。如果你对容器运行时很感兴趣后续可以看看minikube对containerd的支持但入门阶段用Docker就够了。重点是把Docker daemon配置的cgroup驱动和后面Kubernetes保持一致这个细节我在第4章会专门说。3. 安装kubectl和minikube3.1 为什么要单独安装kubectlminikube自带集群启动能力但日常操作集群需要kubectl命令行工具。更重要的是kubectl是你和Kubernetes API交互的入口不管连接minikube还是远程集群都用同一个工具。所以要么单独安装要么用minikube提供的minikube kubectl子命令但我还是建议单独装一个全局可用写脚本也方便。3.2 安装kubectl下载kubectl时要注意版本。Kubernetes版本与kubectl版本差异过大会出现兼容问题所以一般建议安装和minikube启动的集群版本一致或接近的kubectl。curl -LO https://dl.k8s.io/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl chmod x kubectl mv kubectl /usr/local/bin/ kubectl version --client如果下载太慢可以换用国内镜像站的kubectl二进制文件名和官方一致。下载完成后执行kubectl version --client能看到客户端版本就行。3.3 安装minikube安装minikube非常简单本质上就是下载一个二进制文件放到PATH里curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 install minikube-linux-amd64 /usr/local/bin/minikube minikube version如果storage.googleapis.com在你的网络环境下访问很慢同样可以找minikube的国内镜像下载路径。下载完成后确认minikube version能正常输出。这里注意一点不要用过于旧的minikube版本否则默认的Kubernetes版本和当前kubectl可能差太多。3.4 验证安装结果安装完以后我会习惯性检查三样东西docker version kubectl version --client minikube version三个命令都正常后说明工具链已经就绪。这时别急着minikube start先做一步规划选择驱动、给Docker配置镜像加速、确认磁盘空间。这些前置工作做足后面启动会一次成功。4. 启动单节点集群4.1 驱动选择为什么优先Docker驱动CentOS 7上启动minikube最省心的方式是用Docker驱动。原因是CentOS 7的内核相对保守KVM驱动需要额外安装libvirt相关组件而且一旦嵌套虚拟化不支持就完全没法用。Docker驱动则是在Docker容器里运行一个轻量级的Linux虚拟机镜像对内核要求没那么苛刻也不需要在当前系统里再装KVM。none驱动呢它直接在当前主机上运行kubelet和容器进程要求非常多必须关闭swap、SELinux要放行、主机网络要能被Kubernetes管理。在入门阶段搞这些纯属给自己增加难度。所以我的建议非常明确除非你对systemd和Kubernetes网络非常熟悉否则不要用none。4.2 配置Docker的cgroup驱动在启动minikube之前我强烈建议先把Docker的cgroup驱动改成systemd避免出现kubelet is configured with systemd cgroup driver, but cgroupfs is set这类报错。Docker默认在CentOS 7上可能使用cgroupfs而Kubernetes官方推荐使用systemd作为cgroup驱动。编辑/etc/docker/daemon.json{ exec-opts: [native.cgroupdriversystemd], registry-mirrors: [https://your-mirror.example.com] }registry-mirrors填你实际使用的加速地址。修改后执行systemctl restart docker docker info | grep -i cgroup输出中能看到Cgroup Driver: systemd就算成功了。这一小步能避免很多莫名其妙的问题。4.3 使用Docker驱动启动minikube接下来执行启动命令。这里我建议显式指定驱动、CPU和内存不要完全依赖默认值minikube start \ --driverdocker \ --cpus2 \ --memory4096 \ --kubernetes-versionv1.28.3执行过程中minikube会创建一个名为minikube的容器里面包含一个精简Linux系统并在那个环境里启动Kubernetes。这一步会拉取一个基础镜像具体叫什么名字你会看到的。如果拉取卡住大部分是镜像加速没配好检查/etc/docker/daemon.json里的registry-mirrors是否生效。启动成功后会输出类似 “Done! kubectl is now configured to use minikube cluster” 的话。看到这句就说明集群起来了。4.4 常用启动参数详解很多教程只写minikube start但实际实验时你早晚需要定制参数。下面这几个参数我经常用参数作用举例--driver指定驱动--driverdocker--cpus给K8s节点分配的CPU数--cpus4--memory给K8s节点分配的内存--memory4096--kubernetes-version指定K8s版本--kubernetes-versionv1.28.3--image-repository指定镜像仓库地址国内环境可指定镜像仓库--container-runtime指定运行时--container-runtimecontainerd如果你想让集群在后台运行可以加--waittrue它会等所有组件就绪。但第一次跑不建议加因为等待时间可能很长反而让你以为卡死了。4.5 验证集群状态集群启动后依次执行这几条命令kubectl get nodes kubectl cluster-info minikube status正常情况下kubectl get nodes会看到一个minikube节点状态为Ready。cluster-info能看到API Server和CoreDNS的地址。minikube status会显示host: Running、kubelet: Running、apiserver: Running。到了这一步你的K8s学习环境就真正跑起来了。接下来可以做一个小实验验证集群是否可用。5. 使用minikube做实验5.1 部署第一个应用集群空跑没意义我习惯先部署一个简单的Nginx应用试试。镜像选一个能拉到的版本避免出现镜像仓库不可达的问题kubectl create deployment nginx-demo --imagenginx:1.25 kubectl get pods -w等待Pod变成Running。如果Pod一直处于ContainerCreating首先排查镜像是否能拉取用kubectl describe pod nginx-demo-xxx看事件。大多数情况就是镜像拉不下来解决办法还是去Docker加速配置里做文章。5.2 暴露服务并访问Kubernetes里的Pod默认是不对外访问的需要创建Servicekubectl expose deployment nginx-demo --typeNodePort --port80 kubectl get service nginx-demo可以看到Service拿到一个ClusterIPNodePort会映射到一个高位端口。用minikube内置命令可以直接打开访问地址minikube service nginx-demo --url把输出的地址在浏览器或curl里访问能看到Nginx欢迎页。这一步会让你对Service的NodePort机制有直观认识。5.3 使用端口转发如果不想依赖NodePort也可以直接用kubectl的端口转发功能把本机端口映射到Pod端口kubectl port-forward service/nginx-demo 8080:80然后访问http://localhost:8080。这个方式适合调试而且不占用NodePort。我平时排查接口问题经常用。5.4 启停和删除集群学习过程中不一定一直开机。minikube提供了完整的生命周期管理minikube stop # 暂停集群 minikube start # 再次启动 minikube delete # 删除整个集群minikube stop不会释放磁盘空间只是停掉容器。minikube delete会删除节点数据相当于彻底清理。日常实验我基本用stop/start就够了只有遇到环境彻底坏掉时才delete重来。5.5 开启DashboardKubernetes Dashboard能让你通过网页查看工作负载。minikube自带一键开启minikube dashboard这条命令会打开默认浏览器如果没有图形界面它会输出一个dashboard的访问URL。我第一次用的时候发现它需要额外拉取dashboard组件镜像网络慢的话会卡一会儿。如果只为了看状态其实用kubectl get pods也够了Dashboard适合可视化观察。6. 常见问题与实测排查6.1 报错Exiting due to DRV_DOCKER_NOT_RUNNING这个问题我见了太多次。提示信息会告诉你Docker守护进程没有运行。执行systemctl start docker minikube start如果Docker已启动还报这个错检查一下当前用户是否有权限访问/var/run/docker.sock。用docker ps试试如果提示权限拒绝把当前用户加入docker组并重新登录。6.2 报错无法访问API Server集群启动后kubectl get nodes报连接拒绝大概率是kubeconfig上下文没配对。先执行minikube update-context kubectl config get-contexts确认当前上下文是minikube。另外看看防火墙systemctl stop firewalldCentOS 7默认可能开着firewalld如果它拦住了minikube的通信可以临时关闭再测试。虽然生产环境不建议关防火墙但本地实验环境先把集群跑起来最重要。6.3 报错cgroup driver 不一致启动时若出现类似failed to parse kubelet flag: cgroup-driversystemd检查Docker cgroup驱动。按前面第4.2节改好/etc/docker/daemon.json重启Docker然后minikube stop minikube start重新启动。6.4 报错磁盘空间不足minikube启动时会检查可用磁盘空间如果不够会直接中止。CentOS 7的/var/lib/docker所在分区很容易被镜像和容器占满。我踩过一次坑启动中途报“inode耗尽”或“No space left on device”。解决办法是把Docker的数据目录迁移到大分区或者清理垃圾镜像docker system prune -a df -h如果空间确实不够建议minikube delete之后重新配置数据目录再启动。6.5 报错拉取 kicbase 镜像超时minikube的Docker驱动会拉取一个基础镜像国内网络经常超时。这时唯一有效的手段是给Docker配置可用的镜像加速。配置完执行docker info确认镜像加速已生效再执行minikube delete最后重新minikube start。注意单纯重启Docker不重新删除minikube环境拉取状态可能还是旧缓存。6.6 报错minikube start 后一直卡住第一次启动时minikube需要初始化证书、拉组件、等待Pod就绪整个过程可能持续几分钟。如果你用的是机械硬盘等待时间会更长。判断是否卡死可以另开一个终端执行minikube status或者看当前进程是否还在活跃。不要轻易CtrlC否则会残留半初始化的状态清理更麻烦。错误现象可能原因处理方式DRV_DOCKER_NOT_RUNNINGDocker未运行或无权限启动Docker加入docker组context deadline exceeded网络或DNS问题配置镜像加速检查防火墙cgroup driver不一致Docker和K8s驱动配置不同修改daemon.json并重启Docker磁盘空间不足/var/lib/docker占满清理镜像或迁移目录kicbase拉取超时镜像仓库不可达配置registry-mirrors并重删重建6.7 简历级排障技巧遇到问题先看日志不要瞎猜。minikube启动日志会直接打在终端里如果不够详细用minikube start -v7开启详细日志。排查Pod问题用kubectl describe pod xxx和kubectl logs xxx。排查Docker问题用journalctl -u docker。把日志定位到具体模块比随机试命令要高效得多。7. 个人经验与建议7.1 我踩过的坑总结第一次在CentOS 7上跑minikube我用的是none驱动以为直接跑在主机上最省资源。结果要手动关swap、改SELinux、还要处理kubernetes组件和宿主机systemd互相抢服务的问题。折腾到最后才明白入门阶段用Docker驱动是最平滑的路径。另一次是忽略cgroup驱动配置导致kubelet一直崩溃后来通过统一配置Docker的systemd驱动解决。还有一点要提醒不要用最新的Kubernetes版本来测试旧版kubectl。我曾经随手装了最新的minikube默认启动的K8s版本很高结果本地kubectl太旧连kubectl get nodes都报版本错误。解决办法就是显式指定--kubernetes-version让客户端和集群版本尽量一致。7.2 镜像下载慢的通用解法无论拉kubectl、minikube还是K8s组件镜像慢都是共性问题。我个人习惯是先检查Docker加速是否生效再检查minikube是否指定了可用的镜像仓库。如果你遇到某个镜像始终拉不下来可以先在宿主机上手动docker pull一遍确认镜像能到本地再让minikube去用因为Docker驱动最终是在Docker容器里运行K8s宿主机的Docker缓存有时能帮上忙。7.3 关于学习路径的进一步建议minikube跑通后你完全可以继续用它做更复杂的实验Ingress、PVC、HPA、RBAC都可以在单节点上体验。等你对这些概念有了实际手感再去尝试kubeadm搭建多节点集群理解起来会顺畅得多。不要急着追求“生产级”环境学习阶段的重点是快速验证、频繁重建。最后再分享一个小技巧我给每个学习阶段都会保留一个干净的minikube快照也就是在正常启动且配置完成后先别急着做实验马上minikube stop保存当前状态。下次实验直接从stop状态开始省去重复拉镜像的时间。如果中途把集群搞坏了就minikube delete重新启动又是一个干净环境。这样学习效率会提高不少。
