在香港服务器搭建 Kubernetes 1.36 集群前,如何核对节点环境与组件兼容性?
在香港服务器首次搭建 Kubernetes 1.36,实施前要先确认目标版本是否已正式发布并可从可信软件源获取,再核对操作系统、CPU 架构、容器运行时、节点资源、网络地址和防火墙规则是否与该版本的官方要求相符。不能仅凭“版本号相同”判断兼容:kubeadm、kubelet、kubectl、容器运行时和 CNI 网络插件各有版本约束,需逐项检查。

下文以 Linux 服务器、kubeadm 部署为例。香港机房的服务器与其他地区服务器在 Kubernetes 安装机制上没有本质区别,但公网地址、私网互通、运营商路由和防火墙策略会影响节点加入及跨节点通信。示例命令用于说明核对方法,不代表某台服务器的实测结果;涉及 1.36 的具体支持范围,应以对应版本的发布说明和组件兼容文档为准。
一、准备条件:先确定版本、拓扑与网络
1. 确认 Kubernetes 1.36 的发布状态
安装前,先确认 1.36 是正式稳定版本,而非预发布版本;再确认目标软件源已提供该版本的 kubeadm、kubelet 和 kubectl。若 1.36 尚未正式发布,或目标源尚未提供相应软件包,不要用其他小版本的软件包拼装集群,也不要把预发布版本用于生产环境。
建立版本记录,至少包含:
| 项目 | 实施前确认内容 |
|---|---|
| Kubernetes | 目标小版本,例如 v1.36.x,以及版本发布状态 |
| kubeadm | 与控制平面初始化版本匹配 |
| kubelet | 不高于控制平面版本;允许的版本偏差以该版本官方策略为准 |
| kubectl | 与 API Server 保持在官方允许的版本偏差内 |
| 容器运行时 | 支持 CRI v1,并符合该版本 Kubernetes 的运行时要求 |
| CNI 插件 | 明确支持目标 Kubernetes 版本、内核和所选 IP 地址规划 |
Kubernetes 对 kubelet、kubectl 与控制平面有版本偏差规则;不能用“软件包仓库里最新版本”代替兼容性判断。若后续计划分批升级,还需确认升级路径和跨版本跳跃限制。
2. 明确节点规模与资源用途
首次验证集群可以采用一台控制平面节点加至少一台工作节点;生产环境则应按控制平面高可用、业务负载和故障冗余要求规划。单节点集群适合学习或测试,不能据此推断其具备节点故障时的可用性。
每台机器至少核对:
- CPU 架构是否受目标 Kubernetes 发行包、容器运行时及 CNI 支持。常见架构包括
amd64和arm64,但仍须核对实际软件包。 - 内存、CPU、磁盘是否满足控制平面组件、镜像和业务 Pod 的需求。测试集群可把每节点 2 核、4 GB 内存作为起步估算,不是生产资源保证;控制平面与业务负载较多时应预留更多资源。
- 磁盘类型、可用空间和 I/O 是否适合承载容器镜像与 etcd 数据。不要将容量全部分配给业务文件,需为系统日志、镜像缓存和控制平面数据预留空间。
- 所有节点的系统时间是否同步,主机名是否唯一,节点间名称解析是否稳定。
- 是否具备服务器控制台或带外管理入口,以便网络配置错误时仍能恢复访问。
核对系统与架构:
cat /etc/os-release
uname -m
uname -r
nproc
free -h
df -hT
hostnamectl
timedatectl status
预期结果是操作系统发行版、内核版本和架构与目标组件支持范围一致;磁盘、内存有明确余量;各节点主机名不重复,时间同步状态正常。命令只提供现状信息,不会自动判断其是否满足 1.36 的版本要求。
Kubernetes 集群的节点规模与网络拓扑,需要匹配底层服务器的计算、存储和线路资源。A5数据提供香港物理服务器,涵盖 Xeon Gold、AMD EPYC 等平台,以及 SSD、NVMe 和不同带宽线路方案,可用于承载控制平面、工作节点、业务后台与数据库等集群负载。香港之外,还提供美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的服务器资源,覆盖多地区业务部署需求。
3. 规划地址与端口
部署前画清三类地址:节点管理地址、Pod 地址段、Service 地址段。Pod 和 Service 网段不得与节点私网、机房现有网段、云平台路由或企业互联地址重叠。地址段重叠可能导致路由歧义,通常比安装失败更难排查。
香港服务器若同时配置公网与私网地址,要决定 kubelet 和控制平面组件使用哪个地址通信。多网卡机器尤其要检查默认路由、源地址选择,以及节点加入时是否会通告不可达的公网地址。集群节点之间的 API Server、etcd(如采用外置或多控制平面)、kubelet 和 CNI 流量,应优先走稳定且互通的网络;不应仅因为服务器有公网 IP,就假定节点可以通过该地址安全通信。
逐节点查看接口和路由:
ip -br address
ip route
getent hosts node-1
将 node-1 替换为实际主机名。预期节点名称解析到规划中的可达地址,路由表中存在节点间通信所需的路径;若多个节点解析结果不一致,先修复 DNS 或主机名配置,再继续安装。
常见端口取决于拓扑、组件和 CNI 配置。典型 kubeadm 集群涉及 API Server TCP 6443、kubelet TCP 10250;控制平面节点间可能涉及 etcd TCP 2379–2380;NodePort 默认范围通常为 TCP/UDP 30000–32767。CNI 可能另需特定协议或端口,不能仅按这张清单放行全部流量。应依据实际插件文档和节点角色制定最小访问规则,并确认机房防火墙、安全组和主机防火墙三处策略一致。
二、逐步核对依赖与兼容性
1. 检查系统前置条件
检查交换分区、内核模块和网络转发设置。是否允许启用交换分区取决于 Kubernetes 版本、节点配置和运行策略;不要把关闭交换分区当成唯一方案,也不要在未确认现有业务依赖前直接修改系统。
swapon --show
lsmod | grep -E 'overlay|br_netfilter'
sysctl net.ipv4.ip_forward
sysctl net.bridge.bridge-nf-call-iptables 2>/dev/null
根据目标版本文档配置所需内核模块和 sysctl。若文档要求启用 IP 转发,结果应为 1;模块是否已加载可通过 lsmod 查看。若需要修改持久化配置,应先备份原配置文件,记录变更项,并确保有控制台访问能力。不要直接覆盖整份 sysctl 或网络配置。
2. 检查容器运行时
Kubernetes 通过 CRI 与容器运行时通信。确认运行时支持 CRI v1、其版本符合目标 Kubernetes 要求,并且 kubelet 与运行时使用兼容的 cgroup 驱动。systemd 系统通常优先采用 systemd cgroup 驱动,但最终以所选运行时和 Kubernetes 版本文档为准。
以 containerd 为例,以下是检查命令,不假设服务器已安装该软件:
containerd --version
crictl --version
crictl info
如果命令不存在,说明对应工具或服务可能未安装,不能据此判断运行时兼容。安装后需确认 containerd 服务正常,CRI 信息可读取,且 kubelet 配置的 CRI socket 与运行时实际 socket 一致。不要复制其他版本的 containerd 配置模板后直接覆盖现有配置;先备份,再按目标版本文档调整。
3. 核对软件源和组件版本
从可信且适用于操作系统发行版的软件源获取组件。分别确认仓库确实提供目标小版本,而非只提供一个会自动漂移的“最新版”。在安装前查看软件包候选版本或包管理器元数据,并记录最终安装的版本。
安装后核验:
kubeadm version -o short
kubelet --version
kubectl version --client
输出应显示计划使用的版本系列。对版本号中的 v1.36.x,x 表示补丁版本,实际部署应选定一个已发布的补丁版本并在所有节点间保持规划一致。若三个组件版本不符合官方版本偏差规则,先停止部署,不要用跳过检查的方式强行初始化。
4. 选择并核对 CNI
CNI 不是 Kubernetes 自带的完整 Pod 网络实现。安装前明确选择一种与目标 Kubernetes 版本兼容的网络插件,并核对其支持的内核、CPU 架构、IP 地址管理方式、封装模式及所需端口。不要同时安装多个 CNI;多个网络插件争用路由或接口时,可能导致 Pod 网络异常。
将 CNI 使用的 Pod 地址段与 kubeadm 计划设置的 Pod CIDR 对齐。插件若采用自动地址分配,应按插件文档确认节点地址池划分和容量;不能把 Service CIDR 当作 Pod CIDR 使用。此阶段应将插件版本和配置文件来源固定下来,避免集群初始化后才发现插件不支持目标版本。
三、安装配置与启动:先控制平面,后工作节点
1. 安装并验证节点组件
在所有节点上安装兼容版本的容器运行时与 kubelet;在准备执行集群初始化的控制平面节点上安装 kubeadm。是否立即启用 kubelet,按所用发行版软件包说明处理;尚未初始化时 kubelet 出现反复等待配置的日志,不一定代表安装失败。
安装完成后确认运行时服务处于运行状态,并复查版本。若使用包管理器锁定软件包版本,可避免后续自动更新造成节点版本偏离;版本锁定方式因发行版而异,应按系统包管理器操作,并记录解锁流程。
2. 初始化控制平面
初始化前再次确认节点地址、Pod CIDR、Service CIDR 和 CNI 配置一致。下面命令仅展示参数关系,<控制平面可达地址>、<Pod网段> 和版本号需替换为已核验的实际值;只有在目标版本正式发布且软件源提供对应包时才使用。
sudo kubeadm init \
--kubernetes-version=v1.36.x \
--apiserver-advertise-address=<控制平面可达地址> \
--pod-network-cidr=<Pod网段>
若使用负载均衡地址、多个控制平面或特定 CRI socket,应按 kubeadm 配置文件和目标版本文档进行规划,不能照搬单控制平面示例。初始化成功后,保存终端输出中的加入命令和证书密钥信息;不要把包含令牌的输出公开到工单、网页或公共日志中。
预期结果是 kubeadm 完成控制平面组件配置,并提示如何设置 kubectl 凭据以及工作节点加入方式。若初始化中断,先读取报错并定位具体阶段,不要反复执行 kubeadm reset 或删除目录。
3. 配置 kubectl,安装 CNI,再加入工作节点
按 kubeadm 输出提示,为有权限的管理用户配置 kubectl 凭据。随后安装选定版本的 CNI,并使用其文档要求的清单或 Helm 配置。插件启动并完成节点网络初始化前,节点显示 NotReady 可能是预期状态;仍需查看具体原因,不能仅凭状态猜测。
工作节点使用本次初始化生成的加入命令。令牌和 CA 哈希属于集群加入凭据,应通过受控渠道传递,避免写入公开脚本仓库。加入后检查节点状态和 kubelet 日志:
kubectl get nodes -o wide
kubectl -n kube-system get pods -o wide
sudo systemctl status kubelet --no-pager
sudo journalctl -u kubelet -n 100 --no-pager
预期所有计划内节点最终处于 Ready,系统命名空间中的控制平面及网络组件进入正常运行状态。若节点长期 NotReady,先看节点条件和 CNI Pod 状态,再核对节点间路由、地址段、运行时和 kubelet 日志。
四、异常处理:按依赖链定位,不跳过检查
节点无法加入或长期 NotReady
先确认加入地址从工作节点可达,时间同步正常,令牌尚未过期,CA 哈希和命令参数未被截断。检查 kubelet 日志中的连接错误,再核对 API Server 端口、防火墙方向、节点通告地址和 DNS 解析。若 API Server 地址配置为公网地址,还要确认节点访问路径稳定,并评估将控制面暴露在公网的安全风险。
初始化报版本或运行时错误
版本不匹配时,核对 kubeadm、kubelet、kubectl 和运行时的实际版本及软件源候选版本;不要用 --ignore-preflight-errors 绕过未知错误。运行时连接失败时,检查服务状态、CRI socket 路径和 CRI v1 支持情况。cgroup 驱动不匹配时,应按运行时与 Kubernetes 文档统一配置,然后重启受影响服务并重新验证。
Pod 网络不通
检查 CNI 插件是否支持目标 Kubernetes 版本,配置的 Pod CIDR 是否一致,节点间所需端口和协议是否被放行,路由是否与机房现有网络冲突。香港服务器若跨私网或跨机房组网,还应验证 MTU、路径和源地址;封装型网络对 MTU 的要求可能与物理网络不同。先定位具体丢包路径,再调整网络配置,避免一次性修改多个变量。
五、结果检查与回滚边界
集群安装完成后,不应只以 kubectl get nodes 作为验收。至少验证:
- 计划内节点全部为
Ready,节点地址与规划的管理或集群通信地址一致。 kube-system中控制平面、DNS 和 CNI 组件处于预期状态,无持续重启或未调度 Pod。- Pod CIDR、Service CIDR 与节点网络及机房路由无重叠。
- 在获批的测试命名空间中创建一个简单工作负载,确认 Pod 能调度、获取地址并通过集群 DNS 解析服务名。
- 按业务需要验证节点间通信、服务访问和出站访问;不要把测试流量直接发送到生产业务地址。
- 记录 Kubernetes 与组件版本、节点地址、网段、软件源、CNI 配置、开放端口及凭据保管位置。
若需要撤销首次部署,先判断是否已有业务数据、持久卷或需要保留的 etcd 数据。kubeadm reset 会撤销 kubeadm 管理的部分节点配置,但不等于自动清理所有 CNI 配置、容器镜像、业务数据和防火墙规则。执行前备份相关配置与数据,确认影响的节点范围,并安排业务停机窗口。
只有在确认节点可重建、无需保留集群状态后,才按 kubeadm 文档在相应节点执行 reset;之后依据所用 CNI 文档清理其专属接口和配置。不要用通配符批量删除网络配置目录,也不要直接清空容器运行时数据目录。回滚后检查服务状态、网卡与路由、主机防火墙以及残留配置,确认服务器恢复到预期基线,再决定是否重新部署。
首次部署的验收与回滚检查项如下:
- [ ] 目标 Kubernetes 版本已正式发布,软件包来源及组件版本已记录。
- [ ] 操作系统、架构、内核、运行时和 cgroup 设置符合目标版本要求。
- [ ] 节点、Pod、Service 地址段不冲突,香港机房节点间路由及所需端口已验证。
- [ ] 控制平面、工作节点、CNI 和 DNS 状态正常,基础工作负载验证通过。
- [ ] 配置、数据及凭据有受控备份;回滚范围、执行窗口和恢复步骤已确认。
- [ ] 回滚后不会误删业务数据、持久卷或仍需保留的集群状态。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/4284.html



