当前位置：首页 > news >正文

云原生入门系列｜第2集：搭建你的第一个K8s实验环境 —— minikube 零基础教程

news 2026/4/24 11:20:26

云原生入门系列｜第2集：搭建你的第一个K8s实验环境 —— minikube 零基础教程

1. 为什么需要本地环境？

学游泳不能只在岸上看视频，学K8s也不能只看概念。你需要一个可随意折腾的集群，而且是免费的、跑在你自己的电脑上。

生产环境的集群至少需要几台服务器，但本地开发可以用minikube—— 一个单节点的K8s集群，占用资源小（通常分配2核4GB内存即可），支持 Linux/macOS/Windows。

除了 minikube，还有kind（K8s in Docker）、k3s等选择。但对于初学者，minikube 最成熟，文档最全。

2. 安装前的准备

minikube 需要一个虚拟化或容器驱动。推荐使用 Docker（如果你已经安装了 Docker Desktop）：

Windows：安装 Docker Desktop for Windows，并启用 WSL2 后端。
macOS：安装 Docker Desktop for Mac。
Linux：安装 Docker Engine。

然后去 minikube 官网下载适合你系统的二进制文件。

Windows 快速安装（使用 winget）：

winget install minikube macOS 使用 brew： brew install minikube Linux： curl-LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 sudo install minikube-linux-amd64/usr/local/bin/minikube}

启动你的第一个集群
一切顺利的话，一条命令启动：
minikube start
如果没有报错，你会看到类似输出：

😄 minikube v1.33.0 on Ubuntu 22.04
✨ Using the docker driver based on user configuration
👍 Starting control plane node minikube in cluster minikube
🔥 Creating docker container (CPUs=2, Memory=2200MB) …
🐳 Preparing Kubernetes v1.28.3 on Docker 24.0.7 …
🔗 Configuring bridge CNI (Container Networking Interface) …
🔎 Verifying Kubernetes components…
🌟 Enabled addons: default-storageclass, storage-provisioner
🏄 Done! kubectl is now configured to use “minikube” cluster and default namespace
这时候你的 K8s 集群已经运行起来了。执行 kubectl get nodes，应该看到一个叫 minikube 的节点状态为 Ready。

关于 kubectl —— 与 K8s 对话的瑞士军刀
kubectl 是 K8s 的命令行工具。minikube 启动时会自动配置 kubectl 指向自己。如果你还没有 kubectl，minikube 会帮你装好一个（minikube kubectl --），但为了方便，建议单独安装。

验证 kubectl 是否可用：

bash
kubectl version --client --short
常用别名：很多人喜欢设置 alias k=kubectl，后续文章我们也将使用 k 来简化。

你的第一个 Pod
现在集群准备好了，我们来运行一个真正的容器化应用。创建 nginx Pod：

bash
kubectl run my-nginx --image=nginx --port=80
这条命令会创建一个名为 my-nginx 的 Pod，容器镜像为 nginx。查看 Pod 状态：

bash
kubectl get pods
一开始是 ContainerCreating，几十秒后变成 Running。

此时 Pod 在集群内部有一个 IP（可通过 kubectl get pod my-nginx -o wide 查看）。但这个 IP 只有集群内部能访问。我们怎样才能在浏览器里看到 nginx 欢迎页呢？需要用到端口转发：

bash
kubectl port-forward pod/my-nginx 8080:80
然后打开浏览器访问 http://localhost:8080，你会看到 nginx 主页。按 Ctrl+C 停止转发。

几个必会的 minikube 命令
命令作用
minikube status 查看集群状态（是否 running）
minikube pause / unpause 暂停/恢复集群（不销毁资源）
minikube stop 停止集群（虚拟机或容器停止）
minikube start 重新启动已存在的集群
minikube delete 删除整个集群（所有资源被清空）
minikube dashboard 打开 Web UI 管理界面（非常直观，推荐探索）
执行 minikube dashboard 后，会自动打开浏览器，里面有工作负载、网络、存储等图形化面板。
遇到问题怎么办？
问题1：minikube start 卡在 “Starting the cluster”
检查你的 Docker 是否正在运行。

尝试 minikube delete 后重新 start。

指定驱动：minikube start --driver=docker 或 --driver=hyperkit（macOS）。

问题2：kubectl get nodes 显示 “The connection to the server … was refused”
确认 minikube 状态：minikube status。

如果没有 running，执行 minikube start。

问题3：端口转发时提示 “Unable to listen on port 8080”
8080 可能被其他程序占用，更换一个端口，如 kubectl port-forward pod/my-nginx 8888:80，访问 localhost:8888。