6·基础入门入门

安装 Minikube

kubernetesminikubeinstallation

安装 Minikube

学习目标

  1. 了解 Minikube 的作用和适用场景
  2. 掌握在不同操作系统上安装 Minikube
  3. 学会启动和管理 Minikube 集群

核心概念

Minikube 是什么

定义:
• 本地 Kubernetes 集群工具
• 单节点集群
• 用于开发和测试

特点:
┌─────────────────────────────────────┐
│  Minikube                           │
│  • 单节点集群                       │
│  • 支持多种驱动 (Docker, VM, 等)   │
│  • 内置 kubectl                     │
│  • 内置 Dashboard                   │
│  • 支持插件                         │
└─────────────────────────────────────┘

适用场景:
• 本地开发和测试
• 学习 Kubernetes
• CI/CD 流水线
• 快速原型验证

Minikube vs 其他工具

工具特点适用场景
Minikube单节点,功能完整本地开发测试
kind多节点,轻量CI/CD 测试
k3s轻量级 K8s边缘计算,IoT
Docker Desktop内置 K8s桌面开发

安装前准备

系统要求:
┌─────────────────────────────────────┐
│  • 2 GB+ 内存                       │
│  • 2 CPU+ 核心                      │
│  • 20 GB+ 磁盘空间                  │
│  • 网络连接                         │
└─────────────────────────────────────┘

前置依赖:
┌─────────────────────────────────────┐
│  macOS:                             │
│  • Docker Desktop 或                │
│  • HyperKit / VirtualBox           │
│                                     │
│  Linux:                             │
│  • Docker 或                        │
│  • KVM / VirtualBox                │
│                                     │
│  Windows:                           │
│  • Docker Desktop 或                │
│  • Hyper-V / VirtualBox            │
└─────────────────────────────────────┘

实践练习

练习 1:安装 Minikube

macOS 安装

# 方法 1: Homebrew (推荐)
brew install minikube

# 方法 2: 直接下载
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-darwin-amd64
sudo install minikube-darwin-amd64 /usr/local/bin/minikube

Linux 安装

# 方法 1: 直接下载
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube

# 方法 2: Debian/Ubuntu
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube_latest_amd64.deb
sudo dpkg -i minikube_latest_amd64.deb

Windows 安装

# 方法 1: Chocolatey
choco install minikube

# 方法 2: 直接下载
# 下载 https://storage.googleapis.com/minikube/releases/latest/minikube-installer.exe
# 运行安装程序

练习 2:验证安装

# 检查版本
minikube version

# 输出示例:
# minikube version: v1.32.0
# commit: 8220a6eb99f1453bf653ea77db46e83956b15560

练习 3:启动集群

# 使用 Docker 驱动 (推荐)
minikube start --driver=docker

# 使用其他驱动
minikube start --driver=hyperkit    # macOS
minikube start --driver=kvm2        # Linux
minikube start --driver=hyperv      # Windows

# 指定资源
minikube start --cpus=4 --memory=8192 --disk-size=40g

# 指定 Kubernetes 版本
minikube start --kubernetes-version=v1.28.0

练习 4:管理集群

# 查看集群状态
minikube status

# 停止集群
minikube stop

# 删除集群
minikube delete

# 查看集群 IP
minikube ip

# SSH 到节点
minikube ssh

# 查看日志
minikube logs

练习 5:使用插件

# 查看可用插件
minikube addons list

# 启用插件
minikube addons enable dashboard
minikube addons enable metrics-server
minikube addons enable ingress

# 禁用插件
minikube addons disable dashboard

# 打开 Dashboard
minikube dashboard

练习 6:配置镜像

# 配置 Docker 环境变量
eval $(minikube docker-env)

# 现在可以直接使用 minikube 的 Docker
docker build -t my-app:v1 .

# 在 Pod 中使用本地镜像
# 需要设置 imagePullPolicy: Never

练习 7:多节点集群

# 添加节点
minikube node add

# 查看节点
minikube node list

# 删除节点
minikube node delete <node-name>

常见问题

1. 启动失败

问题:minikube start 失败
解决:
• 检查虚拟化支持 (VT-x/AMD-V)
• 检查磁盘空间
• 尝试不同的驱动
• 查看日志: minikube logs

2. 镜像拉取失败

问题:无法拉取镜像
解决:
• 配置镜像加速器
• 使用本地镜像: eval $(minikube docker-env)
• 检查网络连接

3. 资源不足

问题:内存或 CPU 不足
解决:
• 减少资源分配: --cpus=2 --memory=2048
• 关闭其他应用
• 增加系统资源

验证安装

# 完整验证流程
minikube start
kubectl cluster-info
kubectl get nodes
kubectl get pods -A

# 预期输出:
# NAME       STATUS   ROLES           AGE   VERSION
# minikube   Ready    control-plane   1m    v1.28.0

小结

要点说明
Minikube本地单节点 K8s 集群
适用场景开发、测试、学习
支持驱动Docker, HyperKit, KVM, VirtualBox
核心命令start, stop, delete, status
插件系统dashboard, ingress, metrics-server
镜像管理docker-env 切换 Docker 环境

练习编辑器

bash
Loading...

继续学习

完成本课后,建议继续学习下一课「安装 kubectl」 以巩固所学知识。