k8s集群安装坑点汇总

前言

由于使用最新的Rocky9.5,导致kubekey一键安装用不了,退回Rocky8麻烦机器都建好了,决定手动安装k8s,结果手动安装过程中遇到各种坑,这里记录下;

k8s安装

k8s具体安装过程可自行搜索,或者deepseek; 也可参考我早期写的文章最精简kubernetes(1.15.1)(k8s)集群部署教程--基于CentOS 7 这片文章虽然版本较老,但新版安装的大致流程是不变的,有参考的价值。

安装后遇到的坑

本文中提到的坑点及解决方案可能仅适用Rocky9.5,请自行判断。

1. kubelet启动失败

kubelet刚安装好还没有加入集群时,是必然会失败的,也就是说,在加入集群前虽然启动了kubelet,但其状态必然是不断重启中,报的错误是找不到配置文件,这个问题不需要解决,等加入集群自然会正常启动,有的文章说上来就要启动正常,这是错误的,这个误导浪费我很多时间;

2. 安装containerd

最初k8s底层容器是基于docker的,但随着技术发展,底层容器也不仅仅局限于docker,产生了很多其他的。安装的时候需要注意,我第一次安装的containerd不是由docker提供的,导致死活跟k8s无法连接报:validate service connection: CRI v1 runtime API is not implemented for endpoint

sh 复制代码
container runtime is not running: output: time="2025-06-04T14:05:41+08:00" level=fatal msg="validate service connection: CRI v1 runtime API is not implemented for endpoint \"unix:///var/run/containerd/containerd.sock\": rpc error: code = Unimplemented desc = unknown service runtime.v1.RuntimeServic

这个版本的container其/etc/containerd/config.toml文件内的配置内容特别多;卸载后,使用yum命令重新安装后,其配置文件内容就减少了很多,开头也有docker版权注解;

为了减少各种莫名其妙的问题,建议先安装docker,这样容器环境自然就有了;这里还要注意,要注掉配置文件中disabled_plugins=["cri"],并重启containerd:systemctl restart containerd

3. failed to pull and unpack image \"registry.k8s.io/pause:3.8

该问题是由于墙的存在,无法下载pause镜像,最直接办法就是下载国内镜像,重新tag一个

sh 复制代码
# 使用国内镜像源下载并导入
PAUSE_IMAGE="registry.aliyuncs.com/google_containers/pause:3.8"
sudo ctr -n=k8s.io images pull $PAUSE_IMAGE
sudo ctr -n=k8s.io images tag $PAUSE_IMAGE registry.k8s.io/pause:3.8

实时查看kubelet相关的日志信息,有助于排查问题
journalctl -n kubelet -f

4. 墙的问题

阿里把自己的镜像地址改了,初始化集群时,需要使用registry.aliyuncs.com/google_containers作为集群镜像拉取地址,集群初始化最主要设置的就这两个,其他默认即可;网段对应flannel;

sh 复制代码
kubeadm init  --pod-network-cidr=10.244.0.0/16  --image-repository=registry.aliyuncs.com/google_containers
5. 时间问题

集群中机器一定要设置统一的时区,并同步下时间,否则可能会有未知问题,这个时间需要在安装docker前完成,如果已经安装完docker,需要重新启动下容器;

安装的时候虽然选择了国家,时间也是对的,但实际使用中发现,容器启动日志里的时间是不对的,重新设置时区后正常

sh 复制代码
timedatectl set-timezone Asia/Shanghai

后续再有问题再追加

相关推荐
能不能别报错3 小时前
K8s学习笔记(七) yaml
笔记·学习·kubernetes
Rinleren3 小时前
企业级 K8s 运维实战:集群搭建、微服务暴露(Ingress)、监控告警(Prometheus)全流程
java·容器·kubernetes
小闫BI设源码4 小时前
Docker Swarm主机编排
运维·docker·容器·容器编排·docker compose·依赖管理·多服务启动
Reicher4 小时前
Docker的介绍和使用
运维·docker·容器
王道长服务器 | 亚马逊云4 小时前
AWS Route 53 详解:不只是 DNS,还能做智能流量调度
服务器·网络·微服务·云原生·架构·云计算·aws
退役小学生呀5 小时前
二十一、DevOps:从零建设基于K8s的DevOps平台(二)
运维·docker·云原生·容器·kubernetes·devops
知五年三6 小时前
【云原生】openebs-device+cstor存储方案部署
云原生·openebs·cstor
荣光波比7 小时前
Docker(一)—— Docker入门到精通:从基础概念到容器管理
运维·docker·容器·云计算
JanelSirry7 小时前
VMware+RockyLinux+ikuai+docker+cri-docker+k8s+calico BGP网络 自用 实践笔记(二)
笔记·docker·kubernetes
m0_464608267 小时前
Docker入门
运维·docker·容器