在统信UOS上使用Minikube+Docker驱动可快速搭建功能完整的Kubernetes单节点测试环境,支持YAML部署、Service暴露、Ingress路由等核心能力;需依次安装Docker、kubectl、Minikube(推荐阿里云镜像源v1.34.0),启动时指定--driver=docker、--force-systemd=true、--image-repository及资源参数,最后通过minikube service验证服务可达性。

在统信UOS系统上快速搭建一个功能完整的Kubernetes单节点测试环境,用于验证YAML部署、Service暴露、Ingress路由等核心能力,无需云账号或虚拟化平台授权,全程使用本地Docker驱动运行。
安装基础依赖:Docker与kubectl
统信UOS基于Debian/Ubuntu内核,但默认不预装Docker和kubectl。必须先启用非自由软件源并安装容器运行时——否则minikube启动时会报driver not found错误且无法回退。
执行以下命令添加Docker官方GPG密钥和仓库:
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg && echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
更新源并安装Docker CE:
sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io
将当前用户加入docker组,避免后续每次执行docker命令都输密码:
sudo usermod -aG docker $USER && newgrp docker
【重要前提】重启终端或重新登录,否则docker命令仍提示权限拒绝。
安装kubectl:下载最新稳定版二进制文件并设为可执行:
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl" && chmod +x kubectl && sudo mv kubectl /usr/local/bin/
安装Minikube并配置国内镜像加速
统信UOS的apt源中不提供minikube包,需手动下载二进制。由于GitHub Release在国内访问不稳定,必须使用阿里云镜像源,否则下载会卡死或404。
方法一(推荐):用curl从阿里云镜像拉取最新版minikube(截至2026年10月,v1.34.0为稳定可用版本):
curl -Lo minikube https://mirrors.aliyun.com/kubernetes/minikube/releases/download/v1.34.0/minikube-linux-amd64 && chmod +x minikube && sudo mv minikube /usr/local/bin/
方法二:若网络策略严格限制外部镜像站,可改用清华源(响应略慢但更稳定):
curl -Lo minikube https://mirrors.tuna.tsinghua.edu.cn/kubernetes/minikube/releases/download/v1.34.0/minikube-linux-amd64
验证安装结果:
minikube version && kubectl version --client
启动Minikube集群(Docker驱动模式)
统信UOS内核已启用cgroup v2,而旧版minikube默认使用cgroup v1接口,直接运行minikube start会失败并提示systemd not detected。必须显式指定驱动和镜像仓库。
第一步:关闭systemd检测并强制使用Docker驱动:
minikube start --driver=docker --force-systemd=true
第二步:为避免拉取gcr.io镜像超时,同步配置国内镜像仓库:
minikube start --driver=docker --force-systemd=true --image-repository=registry.cn-hangzhou.aliyuncs.com/google_containers
第三步:分配足够资源防止OOM(UOS桌面环境常驻进程较多,建议至少2CPU+4GB内存):
minikube start --driver=docker --force-systemd=true --cpus=2 --memory=4096 --image-repository=registry.cn-hangzhou.aliyuncs.com/google_containers
启动成功后,终端会输出Done! kubectl is now configured to use "minikube",此时kubectl get nodes应返回READY状态的单节点。
验证集群连通性与基础服务
执行kubectl get pods -A确认coredns、etcd、kube-apiserver等核心组件Pod处于Running状态。若出现ContainerCreating卡住,大概率是镜像拉取失败,需检查--image-repository参数是否拼写正确。
启用Dashboard插件,快速查看集群拓扑:
minikube dashboard
该命令会自动打开浏览器并跳转到https://127.0.0.1:32773(端口随机),若提示证书警告,点击“高级→继续访问”即可。
部署一个Nginx测试Pod,验证调度功能:
kubectl create deployment nginx-test --image=nginx && kubectl expose deployment nginx-test --port=80 --type=NodePort
获取服务访问地址:
minikube service nginx-test --url










