0


kubernetes新版本使用kubeadm init的超全问题解决和建议

这一篇能节省你在 kubeadm init 时遇到问题的排错时间⌚️。

整合了网上大佬的方案🧍‍♂️和官方建议⚠️。

个人被这个问题折磨了好久😭,希望总结出来能帮助到大家~

自定义配置文件初始化的建议

生成当前版本的初始化配置文件到 /etc/kubernetes 目录下

kubeadm config print init-defaults > /etc/kubernetes/init-default.yaml

关注配置:

advertiseAddress

指定kube-apiserver广播给其他组件的IP地址。

这个参数需要设置为主节点的IP地址,以确保其他节点可以访问到kube-apiserver

即:advertiseAddress: 1.2.3.4 -> advertiseAddress: [宿主机ip(内网)]

imageRepository

指定安装镜像的仓库源

建议使用国内镜像如阿里云->** imageRepository: registry.aliyuncs.com/google_containers**

可以通过ping仓库源看看宿主机能否正常访问

nodeRegistration.criSocket

高版本(k8s 1.24+)使用非默认(containerd)容器运行时要修改socket位置

低版本无需关注

官网:Container Runtimes | Kubernetes

nodeRegistration:
criSocket: [Path to Unix domain socket]

不同运行时默认到Unix域套接字的路径
containerd unix:///var/run/containerd/containerd.sock
CRI-O unix:///var/run/crio/crio.sock
Docker Engine (using cri-dockerd) unix:///var/run/cri-dockerd.sock

this version of kubeadm only supports deploying clusters with the control plane version >= 1.26.3. Current version: v1.22

初始化时指定的版本跟安装的版本不一致

# kubeadm version 查看的版本为1.26.3,
kubeadm version
# kubeadm init 指定的kubernetes版本为不兼容版本
kubeadm init --kubernetes-version=1.22

这个很好解决,卸载安装的高版本或者指定版本为兼容版本

官网版本支持:

Version Skew Policy | Kubernetes

参考上文提到的初始化出来的配置文件对应版本也很有

跟这个类似还有一个 apiKeys不兼容问题,也直接参考初始化出来的配置文件的apiKeys。

failed to pull image registry.k8s.io/kube-apiserver:v1.26.3

问题:

拉取registry.k8s.io仓库的镜像源失败

解决:

配置国内镜像源

配置文件修改:

  • imageRepository: registry.k8s.io -> imageRepository: registry.aliyuncs.com/google_containers

启动命令加上:

--image-repository=registry.aliyuncs.com/google_containers

container runtime is not running

这个问题导致的原因有很多

参考我的这一篇文章,有超级详细的排查流程:【(Kubernetes)1.26.3+containerd/1.20.x + docker:container runtime is not running问题详细排查】_mikasa_akm的博客-CSDN博客

error execution phase preflight: [preflight] Some fatal errors occurred: [ERROR Port-6443]:

问题:
kubeadm init

初始化集群操作失败的环境和配置遗留

解决:

重置节点:kubeadm reset

[kubelet-check] Initial timeout of 40s passed

详细错误信息参考

[wait-control-plane] Waiting for the kubelet to boot up the control plane as static Pods from directory “/etc/kubernetes/manifests”. This can take up to 4m0s
[kubelet-check] Initial timeout of 40s passed.

Unfortunately, an error has occurred:
timed out waiting for the condition

This error is likely caused by:

  • The kubelet is not running
  • The kubelet is unhealthy due to a misconfiguration of the node in some way (required cgroups disabled)

首先建议查看日志:

journalctl -xeu kubelet

每行都扫一眼:留意 err、failed、cannot connet 等关键字获取有用信息进行问题定位

常见问题:

advertiseAddress IP 配置有误

首先将 advertiseAddress指定为你宿主机的内网ip进行排查

如果换成内网IP可以成功则进行下一步:

    1.先查看当前服务器公网IP是否可达(有些云服务器没有公网ip的)

    2.如果公网可达但因为换成了公网导致初始化失败

公网IP可达但初始化仍然失败则:

    查看 kubeadm 生成的 etcd 配置文件:cat /etc/kubernetes/manifests/etcd.yaml

    关注**--listen-peer-urls**和-**-listen-client-urls**后的地址是否正确
--listen-peer-urls 

etcd

节点监听对等节点请求的URL地址列表。

   --listen-client-urls

是 etcd 服务监听客户端请求的地址。

默认情况下,

--listen-client-urls

http://localhost:2379

,只监听本地回环地址,不允许远程连接。为了在集群外访问 etcd,需要修改这个参数。常见的设置是使用内部 IP 地址或者主机名(检查这个是不是被换成你的公网ip了,如果是则修改)

Failed to create sandbox for pod :拉取 registry.k8s.io/pause:3.6 镜像失败

journalctl -xeu kubelet查看的日志报错信息

Failed to create sandbox for pod” 
err="rpc error: code = Unknown desc = 
failed to get sandbox image “registry.k8s.io/pause:3.6”: 
failed to pull image “registry.k8s.io/pause:3.6

问题:

拉取 registry.k8s.io/pause:3.6 镜像失败 导致sandbox 创建不了而报错

解决

重新配置 sandbox 镜像 仓库,将默认的 registry.k8s.io/pause:3.6 修改成 “k8simage/pause:3.6”

### 生成 containerd 的默认配置文件
containerd config default > /etc/containerd/config.toml 
### 查看 sandbox 的默认镜像仓库在文件中的第几行 
cat /etc/containerd/config.toml | grep -n "sandbox_image"  
### 使用 vim 编辑器 定位到 sandbox_image,将 仓库地址修改成 k8simage/pause:3.6
vim /etc/containerd/config.toml  
sandbox_image = "k8simage/pause:3.6"  
### 重启 containerd 服务  
systemctl daemon-reload  
systemctl restart containerd.service 

参考:

Creating a cluster with kubeadm | Kubernetes

Kubernetes 入门 篇 Master 节点的安装与部署_Robpubking的博客-CSDN博客

解决阿里云ECS下kubeadm部署k8s无法指定公网IP - osc_tc7vil4d的个人空间 - OSCHINA - 中文开源技术交流社区

kubeadm init初始化k8s集群时报错,[kubelet-check] Initial timeout of 40s passed._k8s集群初始化失败_「已注销」的博客-CSDN博客

总结

真的使用新版本超级超级麻烦,不停试错,找论坛,查文档。弄了几天时间才把问题解决 kubeadm init的的问题,长路漫漫,后续还有很长的路要走!

建议就是要

  • 优先考虑 机器适配和版本兼容问题
  • 优先考虑 网络问题:宿主机能否ping通所需镜像包的镜像仓库
  • 多看官方文档!英语不好就翻译

这篇文章希望能帮到大家,有问题欢迎大家评论区一起讨论一起解决!

标签: linux 运维 服务器

本文转载自: https://blog.csdn.net/weixin_52156647/article/details/129765134
版权归原作者 mikasa_akm 所有, 如有侵权,请联系我们删除。

“kubernetes新版本使用kubeadm init的超全问题解决和建议”的评论:

还没有评论