清晰易懂的Minikube安装和入门教程

最新推荐文章于 2025-06-01 09:01:00 发布

Tee xm

最新推荐文章于 2025-06-01 09:01:00 发布

阅读量1.3k

点赞数 13

文章标签： windows 安装 linux macos kubernetes

本文链接：https://blog.youkuaiyun.com/weixin_43236925/article/details/146883343

版权

Minikube 是一个用于在本地计算机上快速搭建单节点 Kubernetes 集群的工具，适合学习和开发测试。本教程将手把手教你安装 Minikube 并运行第一个 Kubernetes 应用，从零开始到实战，全程避坑！

一、Minikube 是什么？

核心功能：在本地一键启动轻量级 Kubernetes 集群。
适用场景：学习 Kubernetes、本地开发测试、验证容器编排流程。
底层依赖：需依赖虚拟机（如 VirtualBox）或容器运行时（如 Docker）。

二、安装 Minikube（全平台通用）

1. 系统要求

操作系统：Windows 10+/macOS 10.15+/Linux（Ubuntu/Debian/CentOS）
内存：至少 2GB（推荐 4GB+）
依赖工具：
- 容器运行时：Docker（推荐）或 containerd
- 虚拟机驱动（可选）：VirtualBox、Hyper-V（Windows）、HyperKit（macOS）

2. 安装步骤

Windows

安装 Docker Desktop：参考 Docker 安装教程。

安装 Chocolatey（包管理工具）：

Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

安装 Minikube：
```
choco install minikube
```

macOS

# 使用 Homebrew 安装
brew install minikube

# 或手动安装
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-darwin-amd64
sudo install minikube-darwin-amd64 /usr/local/bin/minikube

Linux（Ubuntu/Debian）

# 下载二进制文件
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube

3. 验证安装

minikube version
# 输出示例：minikube version: v1.32.0

三、启动 Minikube 集群

1. 启动集群（以 Docker 为驱动）

minikube start --driver=docker

首次启动会自动下载 Kubernetes 组件和基础镜像（耗时约 3-5 分钟）

输出示例：

🏄  Done! kubectl is now configured to use "minikube" cluster and "default" namespace by default

2. 检查集群状态

minikube status
# 输出示例：
# minikube
# type: Control Plane
# host: Running
# kubelet: Running
# apiserver: Running
# kubeconfig: Configured

四、运行第一个 Kubernetes 应用

1. 部署 Nginx 服务

kubectl create deployment nginx --image=nginx

2. 暴露服务端口

kubectl expose deployment nginx --port=80 --type=NodePort

3. 访问服务

minikube service nginx
# 自动打开浏览器访问 http://192.168.49.2:32415

五、新手容易忽略的细节

1. 未安装虚拟机驱动

现象：minikube start 报错 Exiting due to DRV_NOT_DETECTED。
解决：
- Windows：启用 Hyper-V 或安装 VirtualBox。
- macOS：安装 HyperKit（Docker Desktop 默认集成）。
- Linux：安装 KVM（如 Ubuntu：sudo apt install qemu-kvm）。

2. 镜像下载超时

现象：minikube start 卡在 Pulling base image。

解决：配置国内镜像加速：

minikube start --driver=docker --image-mirror-country=cn --image-repository=registry.cn-hangzhou.aliyuncs.com/google_containers

3. 资源不足导致启动失败

现象：集群启动后 CrashLoopBackOff 或频繁崩溃。

解决：调整资源分配：

minikube config set memory 4096  # 分配 4GB 内存
minikube config set cpus 2       # 分配 2 核 CPU
minikube delete && minikube start

4. 未清理旧集群

现象：多次启动失败后残留配置冲突。
解决：彻底删除旧集群：
```
minikube delete --all --purge
```

六、常用命令速查

命令	说明
`minikube start`	启动集群
`minikube stop`	停止集群
`minikube dashboard`	打开 Kubernetes 仪表盘
`minikube ssh`	进入集群节点 Shell
`kubectl get pods`	查看所有 Pod
`kubectl logs <pod-name>`	查看 Pod 日志