在Win10 Linux Shell中运行Kubebuilder安装自定义资源实例报错求助

可能的环境相关原因及解决步骤 #

• WSL文件系统兼容性问题
  WSL和Windows主机的文件系统交互容易出现权限或路径解析问题。如果你的kubebuilder项目放在Windows磁盘路径（比如/mnt/c/xxx），直接把项目移到WSL原生文件系统（比如~/xxx），再重新执行安装命令：

  make install
  kubectl apply -f config/samples/
  

  Windows文件系统的权限模型和Linux不一样，很可能导致CRD的yaml文件读取、生成时出异常。

• kubectl上下文配置错误
  先检查WSL里的kubectl是不是指向了目标K8s集群：

  kubectl config get-contexts
  kubectl config current-context
  

  确认当前上下文是你要部署的集群，再用kubectl cluster-info验证WSL能不能正常连接集群API。

• 版本不兼容问题
  要保证kubebuilder版本和K8s集群版本匹配：

  • kubebuilder v3.x 仅支持K8s 1.21及以上版本
  • 如果集群版本太低，要么升级集群，要么降级kubebuilder到对应兼容版本。
    用kubebuilder version和kubectl version分别查看双方版本信息。

• WSL网络连通问题
  要是你的K8s集群跑在Windows主机上（比如Docker Desktop自带的K8s），得确保WSL能访问主机的K8s API地址。可以先在WSL里ping主机IP，或者检查kubeconfig文件里的server地址能不能在WSL里正常访问。

通用排查手段 #

• 查看CRD安装的详细错误日志：

  kubectl apply -f config/crd/bases/xxx.yaml -v=5
  

  把xxx.yaml换成你的自定义资源定义文件，通过-v=5获取最详细的调试信息，精准定位报错点。
• 检查控制器运行日志（如果控制器已经部署）：

  kubectl logs -n <namespace> <controller-pod-name>
  

  看看控制器启动或者处理资源时有没有报错。

内容的提问来源于stack exchange，提问作者NKHL