berteerdekensosu/minikube

minikube测试Docker镜像文档

镜像概述和主要用途

本镜像专为测试minikube本地Kubernetes集群设计，集成必要的测试工具与环境配置，旨在帮助开发者快速验证minikube的安装正确性、功能完整性及环境兼容性。minikube是一款轻量级本地Kubernetes集群工具，本镜像通过封装测试逻辑与工具链，简化minikube测试流程，支持本地开发与自动化测试场景。

核心功能和特性

• 预装测试工具：内置kubectl、minikube CLI及常用测试脚本，无需额外配置即可开展测试
• 多场景测试支持：覆盖minikube安装验证（节点状态、组件健康检查）、核心功能测试（Pod创建、服务暴露、网络连通性）及版本兼容性测试
• 轻量级环境：基于Alpine或Debian-slim基础镜像，镜像体积小，资源占用低
• CI/CD集成友好：支持非交互式运行，可直接集成到GitHub Actions、GitLab CI等自动化流程
• 灵活配置：通过环境变量自定义测试参数，适配不同minikube版本与测试需求

使用场景和适用范围

• 开发者本地测试：验证本地minikube安装是否正确，功能是否正常
• CI/CD自动化测试：在持续集成流程中自动测试minikube环境部署与功能
• 版本升级验证：测试minikube版本升级后的功能兼容性与稳定性
• 教学/演示环境：快速搭建minikube测试环境，用于教学或技术演示
• 兼容性测试：验证minikube与不同操作系统、容器运行时（Docker、containerd）的兼容性

详细使用方法和配置说明

镜像拉取

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/minikube-testing:latest

基础运行命令

bash
docker run -it --rm \
  --name minikube-test \
  -v /var/run/docker.sock:/var/run/docker.sock \  # 如需在容器内启动minikube（依赖宿主机Docker）
  -e MINIKUBE_VERSION=v1.31.2 \                  # 指定测试的minikube版本
  -e TEST_SCENARIO=install-validation \          # 指定测试场景
  [镜像仓库地址]/minikube-testing:latest

核心配置参数（环境变量）

测试场景说明

1. 安装验证（install-validation）
   验证minikube集群是否正常启动，包括：节点状态（Ready）、核心组件（apiserver、controller-manager等）健康检查、kubectl与集群连接测试。
   执行命令示例：

   bash
   docker run -it --rm -e TEST_SCENARIO=install-validation docker.xuanyuan.run/[镜像仓库地址]/minikube-testing
   

2. 功能测试（feature-test）
   验证minikube核心功能，包括：创建测试Pod并验证运行状态、创建Service并测试网络访问、部署简单应用并验证可用性。
   执行命令示例：

   bash
   docker run -it --rm -e TEST_SCENARIO=feature-test -e MINIKUBE_VERSION=v1.31.2 docker.xuanyuan.run/[镜像仓库地址]/minikube-testing
   

3. 兼容性测试（compatibility-test）
   验证minikube与指定Kubernetes版本的兼容性，测试不同K8s版本下的功能一致性。需通过MINIKUBE_VERSION指定minikube版本，镜像自动匹配对应K8s版本。

测试结果输出

测试完成后，结果将以JSON格式输出至/test-results/result.json，同时在控制台打印摘要信息。可通过挂载目录持久化测试结果：

bash
docker run -it --rm -v $(pwd)/test-results:/test-results docker.xuanyuan.run/[镜像仓库地址]/minikube-testing

注意事项

• 若需在容器内启动minikube集群，需挂载宿主机Docker socket（-v /var/run/docker.sock:/var/run/docker.sock）并确保宿主机已安装Docker
• 部分测试场景（如网络访问测试）可能需要容器具备网络访问权限，建议使用--net=host模式或配置端口映射
• 高版本minikube可能需要特定系统资源（如CPU、内存），运行容器时建议通过--cpus、--memory参数分配足够资源