Windows10环境本地安装Kyma实例部署报错问题求助

故障对应环境信息 #

• 操作系统：Windows 10（启用Hyper-V）
• 软件版本：Docker Desktop v4.9.1、kubectl v1.24.0、k3d v5.4.3、kyma-cli v2.0.4、helm v3.8.2
• 故障场景：按官方流程执行kyma provision k3d、kyma deploy后，核心组件无法正常启动

修复步骤 #

1. 清理失败部署的残留资源 #

先执行以下命令彻底删除之前半创建的集群、残留容器和存储卷，避免脏数据影响后续部署：

kyma undeploy --force
k3d cluster delete kyma
docker system prune -f --volumes

2. 调整Docker Desktop配置 #

Win10 Hyper-V模式下Docker默认资源配额完全不足以运行Kyma核心组件，打开Docker Desktop设置页做以下调整：

• 内存分配调整为至少8GB，推荐分配10GB
• CPU核心分配调整为至少4核
• 确认Docker后端选择Hyper-V，不要混开WSL2后端，避免网络层冲突
• 确认Docker存储盘剩余可用空间大于30GB
  调整完成后重启Docker Desktop，等待服务完全启动再进行下一步。

3. 初始化兼容版本的k3d集群 #

kubectl 1.24版本默认引导的k3s 1.24集群开启了Pod安全准入策略，会拦截Kyma核心组件的特权容器启动，执行集群初始化时指定兼容的k3s版本，同时开启必要的特性门控：

kyma provision k3d --k3s-arg "--kube-apiserver-arg=feature-gates=PodSecurityPolicy=true@server:0" --k3s-version v1.23.8+k3s1

4. 以本地评估模式部署Kyma #

默认部署配置是面向生产环境的，资源要求极高，本地部署使用官方评估模式配置，会自动调低组件资源配额，跳过非必要的可选组件，大幅降低部署失败概率：

kyma deploy --profile evaluation --timeout 30m

5. 部署结果校验 #

部署命令执行完成后，执行kubectl get pods -A检查所有命名空间下的Pod状态，所有Pod处于Running或Completed状态即为部署成功，可执行kyma console命令直接打开本地Kyma控制台。

常见异常处理 #

• 若出现镜像拉取超时/失败：在Docker Desktop中配置镜像加速地址，重启Docker后重试
• 若出现端口绑定失败：提前检查本地80、443、6443端口未被IIS、代理软件等其他服务占用
• 若出现Pod长期处于Pending状态：回到Docker设置页进一步调高内存、CPU分配配额，资源不足是Win10环境下部署失败的最高发原因

内容的提问来源于stack exchange，提问作者kraus.dennis