Windows11下Docker Desktop与K8S环境搭建:从镜像构建到Dashboard部署全流程

张开发
2026/4/17 21:50:34 15 分钟阅读

分享文章

Windows11下Docker Desktop与K8S环境搭建:从镜像构建到Dashboard部署全流程
1. Windows11下Docker Desktop安装准备在Windows11上安装Docker Desktop前我们需要先了解几个关键概念。Docker Desktop本质上是一个打包好的解决方案它把Linux容器运行时环境、虚拟化技术和用户界面整合在一起。相比传统方式先装虚拟机再装Linux最后装Docker这种一体化方案让开发效率提升了好几倍。我去年帮团队迁移开发环境时发现很多同事卡在基础环境配置上。其实只要硬件满足条件整个过程可以非常顺畅。你的电脑需要Windows11 22H2或更新版本支持虚拟化的64位CPU近5年的Intel/AMD都支持至少4GB内存建议8GB以上BIOS中开启虚拟化技术VT-x/AMD-V检查虚拟化是否开启有个简单方法打开任务管理器→性能标签页看虚拟化是否显示已启用。如果显示禁用需要进入BIOS设置。不同主板进入方式不同一般是开机时按F2或Del键在Advanced或Security标签下找到Virtualization Technology选项。2. 安装Docker Desktop实战步骤2.1 启用系统必要组件现在Docker Desktop默认使用WSL 2后端我们需要先启用相关功能。以管理员身份打开PowerShell依次执行# 启用WSL功能 dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart # 启用虚拟机平台 dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart执行完后需要重启电脑。我建议顺便更新WSL内核去微软官网下载最新wsl_update_x64.msi安装包。安装后设置WSL 2为默认版本wsl --set-default-version 22.2 安装Docker Desktop从官网下载最新安装包目前是4.39.0版本双击运行安装程序。新版安装过程极其简单基本就是一路Next。不过有几点需要注意安装路径建议改到非系统盘如D:\Docker安装完成后不要立即打开先配置镜像源创建或修改配置文件%USERPROFILE%\.docker\daemon.json添加国内镜像源加速{ registry-mirrors: [ https://hub-mirror.c.163.com, https://mirror.baidubce.com ], insecure-registries: [] }第一次启动时会提示需要安装WSL内核组件耐心等待下载完成。如果卡住可以尝试科学上网或手动下载wsl内核包。3. 构建和运行第一个容器3.1 使用Dockerfile构建镜像我们以一个SpringBoot应用为例准备如下DockerfileFROM openjdk:11-jre WORKDIR /app COPY target/demo-0.0.1.jar app.jar EXPOSE 8080 ENTRYPOINT [java,-jar,app.jar]在项目目录下执行构建命令docker build -t demo-app:v1 .这里有个实用技巧在Docker Desktop设置中开启BuildKit加速构建Settings→Docker Engine添加features: { buildkit: true }。实测构建速度能提升30%以上。3.2 运行和管理容器启动容器并映射端口docker run -d -p 8080:8080 --name myapp demo-app:v1查看运行日志不必再记复杂命令Docker Desktop的GUI界面直接点击容器就能看到实时日志。我还经常用这个功能排查内存泄漏问题配合docker stats命令监控资源占用。4. Kubernetes环境搭建4.1 启用Kubernetes集群在Docker Desktop设置中找到Kubernetes选项卡勾选Enable Kubernetes。这里有个坑要注意默认会从k8s.gcr.io拉取镜像国内大概率会失败。解决方法有两种提前下载离线镜像包配置国内镜像源我推荐使用阿里云提供的镜像仓库执行以下命令修改镜像源kubectl edit daemonset kube-proxy -n kube-system # 搜索gcr.io替换为registry.aliyuncs.com/google_containers安装过程大约需要5-10分钟取决于网络状况。完成后验证kubectl get nodes # 应该看到docker-desktop节点状态为Ready4.2 部署Dashboard可视化界面首先下载官方部署文件curl -O https://raw.githubusercontent.com/kubernetes/dashboard/v2.7.0/aio/deploy/recommended.yaml编辑文件找到Service部分修改为NodePort类型spec: type: NodePort ports: - port: 443 targetPort: 8443 nodePort: 30009应用配置并创建管理员账号kubectl apply -f recommended.yaml kubectl create serviceaccount dashboard-admin -n kubernetes-dashboard kubectl create clusterrolebinding dashboard-admin --clusterrolecluster-admin --serviceaccountkubernetes-dashboard:dashboard-admin获取访问令牌kubectl -n kubernetes-dashboard create token dashboard-admin访问地址https://localhost:30009 输入令牌即可登录。我在实际使用中发现Chrome可能会拦截换成Edge浏览器通常能直接打开。5. 常见问题排查5.1 启动报错解决方案如果遇到Docker Desktop unexpected error可以尝试以下步骤彻底卸载Docker Desktop删除残留文件C:\Program Files\Docker 和 %APPDATA%\Docker清理注册表谨慎操作重新安装最新版本5.2 性能优化技巧WSL 2默认会占用大量内存可以通过在用户目录创建.wslconfig文件限制资源[wsl2] memory4GB processors2对于磁盘IO性能问题建议将项目文件放在Linux文件系统中如\wsl$\Ubuntu\home而不是Windows目录。实测编译速度能提升3-5倍。6. 进阶使用技巧6.1 多项目环境隔离开发多个微服务项目时可以用Docker Compose管理依赖。准备docker-compose.yml文件version: 3 services: app1: build: ./service1 ports: - 8080:8080 app2: build: ./service2 ports: - 8081:8080 redis: image: redis:alpine启动整个环境只需一条命令docker compose up -d6.2 CI/CD管道集成在Windows上同样可以运行Jenkins等CI工具。我常用的方案是在Docker中运行Jenkins容器挂载Docker套接字/var/run/docker.sock使用Jenkinsfile定义构建流程这样就能实现从代码提交到自动部署的完整流程。一个简单的Jenkinsfile示例pipeline { agent any stages { stage(Build) { steps { sh docker build -t myapp . } } stage(Deploy) { steps { sh docker-compose up -d } } } }在实际项目中使用这套方案我们的部署效率提升了60%环境一致性也得到了保证。特别是在团队协作时新人不再需要花一整天配置开发环境只需安装Docker Desktop就能立即投入开发。

更多文章