sumanthpolineni/minikube

minikube 镜像文档

1. 镜像概述

minikube 是一款专为本地开发和测试设计的 Kubernetes 集群管理工具，旨在帮助开发者无需复杂配置即可在个人计算机上运行单节点 Kubernetes 集群。它简化了本地 Kubernetes 环境的搭建流程，支持多种容器运行时（如 Docker、containerd、CRI-O），并提供集群生命周期管理、插件扩展等功能，是开发、学习和测试 Kubernetes 的理想工具。

2. 核心功能与特性

2.1 轻量级单节点集群

• 默认创建单节点 Kubernetes 集群（包含控制平面和工作节点），资源占用低，适合本地环境
• 支持自定义集群资源（CPU、内存、磁盘空间），满足不同应用需求

2.2 多容器运行时支持

• 兼容主流容器运行时：Docker、containerd、CRI-O、Podman 等
• 可通过命令行参数灵活切换运行时，适配不同开发环境

2.3 完整集群生命周期管理

• 提供简单的命令行操作管理集群生命周期：
  • minikube start：启动集群
  • minikube stop：停止集群（保留数据）
  • minikube delete：删除集群
  • minikube pause/unpause：暂停/恢复集群运行
  • minikube status：查看集群状态

2.4 丰富的插件生态

• 内置常用 Kubernetes 组件插件，支持一键启用：
  • Ingress：启用 HTTP/HTTPS 路由
  • Dashboard：Web UI 管理界面
  • Metrics Server：集群资源监控
  • StorageClass：持久化存储支持
  • 可通过 minikube addons list 查看所有插件

2.5 跨平台兼容性

• 支持 Windows、macOS、Linux 操作系统
• 适配多种硬件架构（x86_64、ARM64 等）
• 支持多种虚拟化技术（VirtualBox、VMware、Hyper-V、KVM 等）

2.6 与 Kubernetes 生态无缝集成

• 自动配置 kubectl 上下文，无需手动设置集群访问凭证
• 支持 Kubernetes 最新稳定版本，同步跟进上游特性
• 兼容标准 Kubernetes API，可直接使用 kubectl 命令管理集群资源

3. 使用场景与适用范围

3.1 开发环境

• 本地开发 Kubernetes 应用，实时测试应用部署、服务发现、配置管理等功能
• 快速验证应用在 Kubernetes 环境中的运行状态，减少开发-测试周期

3.2 Kubernetes 学习与实践

• 初学者无需云服务即可零成本学习 Kubernetes 核心概念（Pod、Service、Deployment 等）
• 实践 Kubernetes 高级特性（如 StatefulSet、DaemonSet、ConfigMap/Secret 管理）

3.3 功能测试与验证

• 测试 Kubernetes 版本升级对应用的影响
• 验证第三方工具（如 Helm、Kustomize）在 Kubernetes 环境中的使用流程
• 测试网络策略、安全上下文等 Kubernetes 安全特性

3.4 CI/CD 本地测试

• 集成到本地 CI/CD 流程，在代码提交前验证应用在 Kubernetes 中的部署流程
• 减少对远程测试环境的依赖，提高开发效率

4. 使用方法与配置说明

4.1 安装 minikube

minikube 可通过多种方式安装，主流操作系统推荐使用包管理器：

Linux（Debian/Ubuntu）

bash
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube

macOS（Homebrew）

bash
brew install minikube

Windows（Chocolatey）

bash
choco install minikube

4.2 启动 Kubernetes 集群

使用 Docker 作为容器运行时启动集群（默认配置）：

bash
minikube start --driver=docker

说明：--driver 参数可指定容器运行时，支持 docker、containerd、podman 等，未指定时自动检测系统可用驱动

4.3 集群基本操作

查看集群状态

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

访问 Kubernetes Dashboard

启用并访问内置 Dashboard（Web UI）：

bash
minikube dashboard

命令执行后会自动打开浏览器，显示 Kubernetes 集群管理界面。

部署测试应用

使用 kubectl 部署示例应用（minikube 自动配置 kubectl 上下文）：

bash
kubectl create deployment hello-minikube --image=k8s.gcr.io/echoserver:1.4
kubectl expose deployment hello-minikube --type=NodePort --port=8080

访问应用：

bash
minikube service hello-minikube

停止/删除集群

bash
# 停止集群（保留数据，下次启动可恢复）
minikube stop

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

4.4 插件管理

查看所有可用插件：

bash
minikube addons list

启用指定插件（如 Ingress）：

bash
minikube addons enable ingress

禁用插件：

bash
minikube addons disable ingress

5. 配置参数说明

5.1 常用启动参数

5.2 环境变量配置

6. 注意事项

• 确保宿主机已安装 Docker 或其他容器运行时，且版本满足 minikube 要求（参考 minikube 官方文档）
• 资源受限环境下，可通过 --cpus 和 --memory 参数减少集群资源占用
• 部分插件（如 Ingress）可能需要额外配置网络规则，具体参考插件文档
• 停止集群后，数据会保留在宿主机 ~/.minikube 目录，删除集群需执行 minikube delete

7. 参考链接

• minikube 官方文档
• Kubernetes 官方文档
• https://github.com/kubernetes/minikube