realcurrents/minikube

Minikube Docker镜像文档

概述

Minikube Docker镜像是用于在本地环境快速部署单节点Kubernetes集群的轻量级解决方案。该镜像封装了Minikube核心组件，旨在为开发者提供便捷的本地Kubernetes开发环境，无需依赖远程集群即可完成应用的开发、测试与验证。

核心功能与特性

主要功能

• 一键部署单节点Kubernetes集群，支持Kubernetes最新稳定版本
• 集成Kubernetes核心组件（kube-apiserver、kube-controller-manager、kube-scheduler等）
• 提供集群生命周期管理（启动、停止、重启、删除）
• 内置Kubernetes Dashboard可视化界面

关键特性

• 轻量级设计：最小化资源占用，支持2CPU/2GB内存的基础环境运行
• 多运行时兼容：支持Docker、containerd、CRI-O等主流容器运行时
• 跨平台支持：兼容Linux、macOS、Windows操作系统
• 快速启动：集群启动时间通常小于2分钟
• Add-ons扩展：支持一键启用常用插件（如ingress、metrics-server、dashboard）
• 持久化存储：支持本地目录挂载实现数据持久化

使用场景

典型应用场景

• 开发者本地开发Kubernetes应用（验证部署配置、服务发现、资源调度等）
• 测试Kubernetes资源清单（Deployment、Service、ConfigMap等）
• 学习Kubernetes核心概念与操作（适合初学者入门实践）
• 离线环境下的Kubernetes功能验证

适用人群

• Kubernetes应用开发者
• DevOps工程师
• 学习Kubernetes的学生或初学者
• 需要本地验证集群配置的技术人员

使用方法

基础使用流程

1. 拉取Minikube镜像
2. 启动本地Kubernetes集群
3. 连接集群并部署应用
4. 管理集群生命周期

镜像拉取

bash
docker pull minikube/minikube:latest

集群部署示例

1. 快速启动集群

bash
docker run -d \
  --name minikube \
  --privileged \
  --restart=unless-stopped \
  -p 8443:8443 \
  -v /var/lib/minikube:/var/lib/minikube \
  -v /var/run/docker.sock:/var/run/docker.sock \
  minikube/minikube:latest start --driver=docker

2. 自定义Kubernetes版本

bash
docker run -d \
  --name minikube \
  --privileged \
  -v /var/lib/minikube:/var/lib/minikube \
  minikube/minikube:latest start --driver=docker --kubernetes-version=v1.28.0

3. 启用Add-ons插件

bash
# 启动集群并启用Dashboard和Metrics Server
docker exec minikube minikube addons enable dashboard
docker exec minikube minikube addons enable metrics-server

集群管理命令

查看集群状态

bash
docker exec minikube minikube status

停止集群

bash
docker exec minikube minikube stop

重启集群

bash
docker exec minikube minikube start

删除集群

bash
docker stop minikube && docker rm minikube

连接集群

获取集群配置文件：

bash
docker exec minikube cat /root/.kube/config > minikube-config
export KUBECONFIG=minikube-config

验证连接：

bash
kubectl get nodes

配置参数说明

常用启动参数

环境变量配置

注意事项

系统要求

• 宿主机需支持虚拟化技术（AMD-V/Intel VT-x）
• 至少2CPU核心、2GB内存、20GB磁盘空间
• Docker引擎版本≥19.03

权限说明

• 容器需以--privileged模式运行，确保Kubernetes组件正常启动
• 宿主机/var/run/docker.sock需挂载至容器，以支持Docker运行时

数据持久化

• 建议挂载/var/lib/minikube目录至宿主机，避免容器删除导致集群数据丢失
• 应用数据需通过Kubernetes PV/PVC或宿主机目录挂载实现持久化

网络配置

• 默认暴露8443端口（kube-apiserver），可通过-p参数自定义端口映射
• 宿主机与集群内部网络通过Docker桥接实现互通，无需额外端口转发配置