1. 为什么选择Docker Desktop搭建K8s环境刚开始接触Kubernetes时我在云服务器上折腾过Minikube也尝试过手动部署多节点集群结果不是网络配置出问题就是资源消耗太大。直到发现Docker Desktop内置的Kubernetes功能才真正体会到什么叫开箱即用。这个方案特别适合以下场景本地开发测试不需要额外虚拟机笔记本就能跑起完整集群快速验证想法部署一个应用只需几分钟随时可以推倒重来学习K8s基础所有核心功能都支持从Pod到Service再到Ingress我团队现在所有新人的K8s入门第一课都是在Docker Desktop上完成的。相比其他方案它有三大优势零配置勾选一个复选框就能启用K8s资源友好可以灵活调整CPU/内存分配生态集成和Docker镜像仓库无缝配合2. 环境准备与安装2.1 安装Docker Desktop国内用户建议从阿里云镜像站下载安装包速度会快很多。安装时注意Windows系统需要开启WSL2后端Win10 2004以上版本macOS建议分配至少4GB内存给Docker首次启动后记得在Settings→Docker Engine里配置国内镜像源// 推荐镜像配置 { registry-mirrors: [ https://registry.docker-cn.com, https://docker.mirrors.ustc.edu.cn ] }2.2 启用Kubernetes功能在Docker Desktop的设置界面找到Kubernetes选项卡勾选Enable Kubernetes建议将API Server端口改为6443避免与其他服务冲突点击Apply按钮等待安装完成第一次启动可能会下载约500MB的镜像建议挂上网络加速工具。我在公司网络下实测安装需要15-20分钟完成后会看到右下角鲸鱼图标变成绿色。注意如果长时间卡在starting状态可以尝试重置集群Reset Kubernetes Cluster3. 验证集群状态安装完成后打开终端运行几个基本命令# 检查节点状态 kubectl get nodes # 查看所有系统Pod kubectl get pods -n kube-system # 获取集群信息 kubectl cluster-info正常情况应该看到类似这样的输出NAME STATUS ROLES AGE VERSION docker-desktop Ready control-plane 5d v1.25.24. 部署Dashboard可视化界面虽然命令行够用但有个可视化面板会更直观。推荐使用官方Dashboard# 安装Dashboard kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.7.0/aio/deploy/recommended.yaml # 创建管理员账号 kubectl apply -f - EOF apiVersion: v1 kind: ServiceAccount metadata: name: admin-user namespace: kubernetes-dashboard EOF # 绑定集群管理员权限 kubectl apply -f - EOF apiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRoleBinding metadata: name: admin-user roleRef: apiGroup: rbac.authorization.k8s.io kind: ClusterRole name: cluster-admin subjects: - kind: ServiceAccount name: admin-user namespace: kubernetes-dashboard EOF获取访问令牌kubectl -n kubernetes-dashboard create token admin-user启动代理后浏览器访问http://localhost:8001/api/v1/namespaces/kubernetes-dashboard/services/https:kubernetes-dashboard:/proxy/5. 实战部署Nginx应用让我们用三种不同方式部署Nginx体验K8s的核心功能5.1 直接创建Deploymentkubectl create deployment nginx-demo --imagenginx:latest --replicas25.2 通过YAML文件部署创建nginx-deployment.yamlapiVersion: apps/v1 kind: Deployment metadata: name: nginx spec: selector: matchLabels: app: nginx replicas: 2 template: metadata: labels: app: nginx spec: containers: - name: nginx image: nginx:alpine ports: - containerPort: 80应用配置kubectl apply -f nginx-deployment.yaml5.3 暴露Service访问# 创建NodePort类型的Service kubectl expose deployment nginx --typeNodePort --namenginx-service # 获取访问端口 kubectl get svc nginx-service访问测试Docker Desktop会自动映射端口到localhost浏览器打开http://localhost: 就能看到Nginx欢迎页6. 常见问题排查6.1 镜像拉取失败典型报错ErrImagePull or ImagePullBackOff解决方法# 先检查镜像名称是否正确 kubectl describe pod pod-name # 国内环境可以为特定Pod配置镜像加速 kubectl edit deployment deployment-name # 在spec→containers→image字段替换为国内镜像源6.2 Pod一直处于Pending状态运行kubectl describe pod pod-name常见原因资源不足调整Docker Desktop内存分配节点有污点开发环境可以移除污点存储卷挂载失败6.3 Dashboard无法访问检查步骤确认代理是否运行kubectl proxy检查防火墙是否放行8001端口尝试清除浏览器缓存7. 进阶配置技巧7.1 自定义资源配额在Docker Desktop的Advanced设置中可以调整CPUs数量建议留1核给系统内存大小开发环境4GB起步Swap大小不建议完全禁用7.2 使用本地镜像开发时经常需要测试自建镜像# 先构建本地镜像 docker build -t my-app:latest . # 让K8s使用本地镜像 kubectl run my-app --imagemy-app:latest --image-pull-policyNever7.3 持久化存储配置创建hostPath类型的存储卷示例apiVersion: v1 kind: Pod metadata: name: test-pd spec: containers: - image: nginx name: nginx volumeMounts: - mountPath: /usr/share/nginx/html name: test-volume volumes: - name: test-volume hostPath: path: /data type: Directory8. 日常开发工作流我个人的最佳实践是在本地用Docker构建和测试单个容器编写K8s部署描述文件YAML使用kubectl apply -f部署到本地集群通过kubectl port-forward调试服务确认无误后提交到代码仓库对于复杂项目建议使用Skaffold这样的工具自动化这个流程。它能在代码变更时自动重建镜像并重新部署大幅提升开发效率。