使用kind创建K8s集群失败求助：kubeadm API版本弃用问题

问题原因 #

kubeadm从Kubernetes 1.27版本开始正式弃用kubeadm.k8s.io/v1beta3 API规范，要求使用更高版本的API（如v1beta4或v1）。如果你的kind工具生成的kubeadm配置仍在使用旧API，就会触发控制平面启动失败的报错。

解决方案 #

场景1：未使用自定义kind配置文件（直接执行kind create cluster）

• 升级kind到最新稳定版
  旧版本的kind可能会生成基于v1beta3的kubeadm配置，升级后会自动适配当前K8s版本的API规范：

  # 用Go安装最新版（需已配置Go环境）
  go install sigs.k8s.io/kind@latest
  # 或者用包管理器（如Homebrew）
  brew upgrade kind
  

  升级后重新执行kind create cluster即可。

• 指定兼容v1beta3的K8s版本
  如果暂时不想升级kind，可以指定一个仍支持v1beta3的K8s节点镜像（如1.26.x系列）：

  kind create cluster --image kindest/node:v1.26.15
  

场景2：使用了自定义kind配置文件

如果你的集群创建依赖自定义配置文件（通过--config参数指定），需要手动更新配置中的kubeadm API版本：

1. 打开你的kind配置文件（如kind-config.yaml）
2. 将所有kubeadm相关配置块的apiVersion从kubeadm.k8s.io/v1beta3替换为对应版本的API：
   • K8s 1.27-1.28版本：使用kubeadm.k8s.io/v1beta4
   • K8s 1.29+版本：使用kubeadm.k8s.io/v1
3. 示例修改后的配置片段：

   apiVersion: kind.x-k8s.io/v1alpha4
   kind: Cluster
   nodes:
   - role: control-plane
     kubeadmConfigPatches:
     - |
       apiVersion: kubeadm.k8s.io/v1beta4
       kind: InitConfiguration
       # 其余配置内容保持不变
   

4. 重新执行集群创建命令：

   kind create cluster --config kind-config.yaml
   

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