acyscohabs/minikube

Minikube POC 镜像文档

镜像概述

Minikube POC镜像是基于Minikube构建的本地Kubernetes环境解决方案，专为概念验证(POC)场景优化。该镜像简化了本地单节点Kubernetes集群的部署流程，使开发者、测试人员和学习者能够在个人电脑或开发服务器上快速搭建可运行的Kubernetes环境，无需复杂的集群配置，专注于功能验证和应用测试。

核心功能与特性

• 本地单节点集群：一键部署完整的Kubernetes单节点集群，包含控制平面（API Server、etcd、Scheduler等）和节点组件
• 轻量级设计：资源占用低，适合个人电脑或开发服务器运行，支持动态调整CPU/内存资源
• 多运行时兼容：支持Docker、containerd等主流容器运行时，适配不同开发环境需求
• 便捷生命周期管理：提供简单命令实现集群启动、停止、暂停、删除等操作，简化环境维护
• POC优化配置：预配置常用Kubernetes扩展组件（如Dashboard、Ingress），缩短验证周期

使用场景

• 开发者本地测试：验证Kubernetes应用部署配置、服务发现、配置管理等功能的本地开发环境
• Kubernetes学习：初学者通过实际操作学习Kubernetes核心概念（Pod、Service、Deployment等）
• 小型POC验证：团队快速验证基于Kubernetes的架构可行性，测试应用在容器编排环境中的运行表现
• 教学演示：讲师在课堂环境中快速搭建标准化Kubernetes演示集群

使用方法

基本启动命令

通过以下命令启动Minikube POC环境（需确保宿主机已安装Docker）：

bash
docker run -d --name minikube-poc \
  --privileged \
  -p 8443:8443 \  # Kubernetes API端口
  -p 30000-30100:30000-30100 \  # NodePort服务端口范围
  -v /var/run/docker.sock:/var/run/docker.sock \  # 挂载Docker守护进程（使用Docker运行时）
  -v minikube-data:/data \  # 持久化集群数据
  your-registry/minikube-poc:latest

集群状态检查

容器启动后，通过以下命令验证集群状态：

bash
# 进入容器环境
docker exec -it minikube-poc bash

# 检查集群状态
minikube status

# 验证节点状态
kubectl get nodes

访问Kubernetes Dashboard

启动Dashboard并通过宿主机端口访问：

bash
# 在容器内启动Dashboard
docker exec minikube-poc minikube dashboard --url

# 输出示例：http://127.0.0.1:30000/api/v1/namespaces/kubernetes-dashboard/services/http:kubernetes-dashboard:/proxy/
# 通过宿主机浏览器访问上述URL（需确保30000端口已映射）

环境配置参数

可通过环境变量调整集群配置，常用参数如下：

集群生命周期管理

bash
# 停止集群（保留数据）
docker exec minikube-poc minikube stop

# 重启已停止的集群
docker exec minikube-poc minikube start

# 暂停集群（节省资源）
docker exec minikube-poc minikube pause

# 恢复暂停的集群
docker exec minikube-poc minikube unpause

# 完全删除集群（容器内操作）
docker exec minikube-poc minikube delete

# 删除容器及关联数据卷
docker rm -f minikube-poc && docker volume rm minikube-data

注意事项

• 宿主机需开启虚拟化技术（Intel VT-x/AMD-V），否则集群性能会显著下降
• 首次启动时会下载Kubernetes组件镜像，耗时取决于网络环境（建议配置镜像加速器）
• 生产环境请勿使用此镜像，仅适用于开发测试和POC场景
• 如需持久化集群数据，建议通过-v参数挂载本地目录或命名卷