karankumar9955/minikube

minikube 镜像文档

镜像概述

minikube 是一款开源工具，旨在帮助用户在本地环境中快速搭建单节点 Kubernetes 集群。它简化了本地 Kubernetes 集群的创建和管理流程，无需依赖复杂的多节点基础设施，即可为开发者提供接近生产环境的 Kubernetes 体验。minikube 支持多种虚拟化驱动（如 Docker、VirtualBox、Hyper-V 等），并可灵活配置 Kubernetes 版本及附加组件，是开发、测试 Kubernetes 应用和学习 Kubernetes 技术的理想工具。

核心功能和特性

1. 轻量级单节点集群

• 快速创建单节点 Kubernetes 集群，资源占用低，适合本地环境
• 集群包含完整的 Kubernetes 核心组件（kube-apiserver、kube-controller-manager、kube-scheduler、etcd、kubelet、kube-proxy）

2. 多驱动支持

• 兼容多种虚拟化/容器化驱动，满足不同环境需求：
  • Docker（推荐，无需额外虚拟化软件）
  • VirtualBox、VMware、Hyper-V（适用于不同操作系统）
  • Podman、containerd（容器运行时驱动）
  • None（直接运行在主机，需 root 权限）

3. Kubernetes 版本灵活性

• 支持指定 Kubernetes 版本（如 --kubernetes-version=v1.28.0），便于测试不同版本兼容性
• 自动匹配稳定版本，简化版本管理

4. 丰富的附加组件

• 内置多种可选附加组件，一键启用：
  • dashboard：Kubernetes 可视化控制台
  • ingress：Ingress 控制器支持
  • metrics-server：资源监控指标收集
  • registry：本地容器镜像仓库
  • storage-provisioner：动态存储卷供应
  • istio：服务网格支持（需额外配置）

5. 本地开发优化

• 支持本地文件目录挂载（--mount），实现代码热更新
• 集成 minikube tunnel 功能，暴露集群服务到本地网络
• 兼容 kubectl 命令行工具，无缝对接 Kubernetes 标准操作

使用场景和适用范围

1. 开发者本地开发测试

• 快速搭建与生产环境一致的 Kubernetes 集群，验证应用部署配置
• 本地调试容器化应用，无需依赖远程集群
• 结合 IDE 实现代码修改后即时部署测试

2. Kubernetes 学习与教学

• 零成本入门 Kubernetes，无需云资源
• 安全测试集群操作（如删除资源、升级版本），无生产风险
• 实践核心概念（Pod、Service、Deployment、ConfigMap 等）

3. CI/CD 流程本地验证

• 在 CI 管道中作为本地测试环境，验证部署脚本和配置文件
• 替代远程测试集群，降低外部依赖和成本

4. 轻量级演示环境

• 快速搭建临时演示集群，展示 Kubernetes 应用功能
• 支持离线环境使用（需提前下载镜像）

使用方法和配置说明

前提条件

• 操作系统：Linux、macOS 或 Windows
• 安装 Docker（推荐，作为驱动时需 Docker Engine 18.09+）或其他支持的虚拟化软件
• 硬件要求：至少 2 CPU、2GB 内存、20GB 磁盘空间

安装 minikube

通过官方脚本安装（适用于 Linux/macOS）：

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

# macOS 可使用 brew：brew install minikube
# Windows 可使用 choco：choco install minikube

启动 Kubernetes 集群

基础启动（默认 Docker 驱动）

bash
# 启动单节点集群（默认使用最新稳定版 Kubernetes）
minikube start

# 验证集群状态
minikube status
# 输出示例：
# minikube
# type: Control Plane
# host: Running
# kubelet: Running
# apiserver: Running
# kubeconfig: Configured

指定驱动和 Kubernetes 版本

bash
# 使用 Docker 驱动，指定 Kubernetes v1.27.0 版本
minikube start --driver=docker --kubernetes-version=v1.27.0

# 使用 VirtualBox 驱动（需先安装 VirtualBox）
minikube start --driver=virtualbox

启用附加组件

bash
# 启动时启用 Dashboard 和 Ingress
minikube start --addons=dashboard,ingress

# 后续添加组件（如 metrics-server）
minikube addons enable metrics-server

基本集群操作

访问 Kubernetes Dashboard

bash
# 启动 Dashboard 并自动打开浏览器
minikube dashboard

# 如需手动访问，获取访问令牌：
kubectl -n kubernetes-dashboard create token admin-user
# 然后通过 dashboard URL 使用令牌登录

部署示例应用

bash
# 部署 nginx 应用
kubectl create deployment nginx --image=nginx:alpine

# 暴露服务（NodePort 类型）
kubectl expose deployment nginx --port=80 --type=NodePort

# 获取服务访问 URL
minikube service nginx --url
# 输出示例：http://192.168.49.2:30080（通过此 URL 在本地访问 nginx）

本地文件挂载（开发热更新）

bash
# 启动集群时挂载本地目录（/home/user/dev 挂载到集群 /app）
minikube start --mount --mount-string="/home/user/dev:/app"

# 在 Pod 中使用挂载目录（需在 Deployment 中配置 volumeMounts）

停止和删除集群

bash
# 暂停集群（保留数据，快速恢复）
minikube pause

# 恢复集群
minikube unpause

# 停止集群（释放资源，保留配置）
minikube stop

# 彻底删除集群（清理所有数据）
minikube delete

# 删除所有 minikube 资源（包括缓存镜像）
minikube delete --all --purge

常用配置参数

环境变量配置

• MINIKUBE_HOME：指定 minikube 数据存储目录（默认 ~/.minikube）
• MINIKUBE_DRIVER：默认驱动（无需每次启动指定 --driver）
• HTTP_PROXY/HTTPS_PROXY：配置代理（适用于网络受限环境）

常见问题排查

• 集群启动失败：检查驱动是否安装（如 Docker 状态）、资源是否充足（CPU/内存），查看日志 minikube logs
• 服务无法访问：确认服务类型（NodePort/Load***），使用 minikube service <服务名> 获取访问地址，或通过 minikube tunnel 暴露 Load*** 服务
• 镜像拉取慢：配置 --registry-mirror 使用国内镜像源，或提前 minikube ssh 进入节点手动拉取镜像
• 附加组件启用失败：检查集群状态 minikube status，通过 minikube addons list 查看组件状态，重新启用 minikube addons enable <组件名>

参考链接

• minikube 官方文档
• 支持的驱动列表
• 附加组件说明
• kubectl 命令参考