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

后续再有问题再追加

相关推荐
慌糖2 小时前
微服务介绍
微服务·云原生·架构
高山莫衣7 小时前
Docker Desktop导致存储空间不足时的解决方案
docker·容器·eureka
鹏大师运维7 小时前
在银河麒麟V10 SP1上手动安装与配置高版本Docker的完整指南
linux·运维·docker·容器·麒麟·统信uos·中科方德
Ahlson7 小时前
【fnNAS】docker的nginx配置html
nginx·docker·容器·fnnas
LuckyLay7 小时前
Compose 常用命令详解——AI教你学Docker
docker·容器·eureka
阿里云云原生7 小时前
阿里云可观测 2025 年 6 月产品动态
云原生
阿里云云原生7 小时前
30 秒锁定黑客攻击:SLS SQL 如何从海量乱序日志中“揪”出攻击源
云原生
moppol8 小时前
容器化 vs 虚拟机:什么时候该用 Docker?什么时候必须用 VM?
运维·docker·容器
没有名字的小羊8 小时前
7.可视化的docker界面——portainer
docker·容器·eureka
斯普信专业组9 小时前
K8s环境下基于Nginx WebDAV与TLS/SSL的文件上传下载部署指南
nginx·kubernetes·ssl