mgmaheshnew/minikube

测试minikube Docker镜像文档

镜像概述

本镜像专为测试minikube环境设计，minikube是构建本地Kubernetes集群的工具。该镜像提供标准化测试环境，帮助开发者、测试人员及运维人员验证minikube的安装配置、功能完整性及环境兼容性，降低本地Kubernetes开发测试的复杂度。

核心功能与特性

核心功能

• minikube部署验证：自动检测minikube基础部署状态，包括节点启动、集群初始化及配置正确性
• 功能测试支持：验证minikube核心功能，如节点状态检查、Pod创建与调度、Service暴露及存储卷挂载
• 环境兼容性检查：测试不同版本minikube与Docker环境的兼容性，支持跨版本升级验证
• 测试结果输出：生成结构化测试报告（JSON/文本格式），包含测试项、状态及详细日志

特性

• 轻量级设计，基于Alpine基础镜像，减少资源占用
• 内置minikube测试工具链，无需额外安装依赖
• 支持自定义测试参数，灵活适配不同测试场景
• 兼容主流CI/CD平台（如GitHub Actions、GitLab CI），支持自动化测试集成

使用场景与适用范围

适用场景

• 开发者本地测试：验证本地minikube环境是否符合开发要求
• CI/CD流程集成：在持续集成中自动验证minikube部署环节，确保环境一致性
• 版本升级测试：测试minikube版本升级对现有应用的兼容性影响
• 教学与学习：Kubernetes初学者验证minikube学习环境配置正确性

适用人群

• Kubernetes本地开发者
• DevOps工程师（CI/CD流程设计）
• 测试人员（环境验证与兼容性测试）
• 技术培训学员（minikube环境实践）

使用方法与配置说明

基础使用（docker run）

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \  # 挂载Docker守护进程套接字（minikube依赖Docker环境）
  -e MINIKUBE_VERSION="v1.30.1" \                # 指定测试的minikube版本（必填）
  -e TEST_TYPE="basic" \                         # 测试类型：basic（基础部署）/feature（功能测试）/compatibility（兼容性），默认basic
  -e LOG_LEVEL="info" \                          # 日志级别：debug/info/warn/error，默认info
  -e REPORT_PATH="/test/report.json" \           # 测试报告输出路径（容器内路径），默认/stdout
  testing-minikube:latest

挂载测试报告到本地

如需将测试报告保存到本地文件系统，添加本地目录挂载：

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v $(pwd)/reports:/test \                      # 本地reports目录挂载到容器/test，报告将保存至本地reports/report.json
  -e MINIKUBE_VERSION="v1.30.1" \
  -e REPORT_PATH="/test/report.json" \
  testing-minikube:latest

环境变量配置

测试报告说明

测试报告包含以下核心字段（以JSON格式为例）：

json
{
  "test_id": "minikube-test-202405201230",
  "minikube_version": "v1.30.1",
  "test_type": "basic",
  "start_time": "2024-05-20T12:30:00Z",
  "end_time": "2024-05-20T12:35:20Z",
  "status": "passed",  // passed/failed
  "test_items": [
    {
      "name": "minikube-start",
      "status": "passed",
      "duration": "120s",
      "log": "minikube started successfully, node 'minikube' is running"
    },
    {
      "name": "node-status",
      "status": "passed",
      "duration": "15s",
      "log": "Node status: Ready"
    }
  ]
}

注意事项

1. 宿主机需已安装Docker，且当前用户有Docker守护进程访问权限（挂载/var/run/docker.sock）
2. 测试过程中会临时启动minikube集群，建议预留至少2GB内存及20GB磁盘空间
3. 不同minikube版本可能依赖特定Docker版本，兼容性测试时建议指定明确版本组合
4. CI/CD环境中使用时，需确保Runner节点已启用Docker-in-Docker（DinD）或挂载Docker套接字权限