Debian上Kubernetes的版本选择指南

Debian上Kubernetes版本选择指南

一 选择原则与版本策略

• 明确目标：优先选择处于维护期的稳定小版本，避免过旧或即将停止维护的分支。Kubernetes 项目通常只维护最近的3个小版本分支，补丁支持周期约为9–12个月（1.19+约1年，1.18及更早约9个月），因此不建议选择已超出维护窗口的版本。对于需要更长维护窗口的团队，可考虑采用带有更长支持周期的发行版或企业版（如 OpenShift、Rancher、Canonical Kubernetes 等）。
• 运行时匹配：自 v1.24 起移除 dockershim，生产推荐 containerd 或 CRI‑O 作为容器运行时；在 Debian 上以 systemd 管理的容器运行时更便于运维与排障。
• 生态兼容：所选 Kubernetes 小版本需与你的网络插件（如 Cilium、Calico、Flannel）、存储 CSI、Ingress 控制器、监控与日志栈的已验证矩阵相匹配，避免 API 或特性不兼容导致回滚。

二 版本选择决策表

三 Debian系统与运行时要点

• 操作系统建议：选择 Debian 11+（或更高），内核较新、容器生态完善；确保节点间网络互通与时间同步（NTP/chrony）。
• 容器运行时：优先 containerd（或 CRI‑O）。v1.24+ 不再内置 dockershim，若使用 Docker 需通过 cri-dockerd 适配；在 Debian 上以 systemd 管理更便于日志与重启策略配置。
• 基础环境：内核开启桥接与转发（如 br_netfilter、ip_forward），并按需放行 6443/2379‑2380/10250/10251/10252/30000‑32767 等端口，确保 kubelet、apiserver、scheduler、controller‑manager 与控制平面负载均衡/etcd 通信正常。

四 版本兼容与升级路径

• 版本偏差规则（核心）：
  • kube-apiserver：HA 场景下多个实例小版本差不超过 1。
  • kube-controller-manager / kube-scheduler / cloud-controller-manager：版本不能高于 apiserver，最多低 1 个小版本。
  • kubelet：不能高于 apiserver，最多低 2 个小版本。
  • kubectl：可高于或低于 apiserver 各 1 个小版本。
  • kube-proxy：与同节点 kubelet 小版本一致，且不能高于 apiserver、最多低 2 个小版本。
• 升级顺序（示例）：先升级 kube-apiserver，再升级 controller/scheduler/cloud-controller-manager，最后升级 kubelet/kube-proxy；跨小版本升级需逐步进行，严禁一次性跨越多个小版本。

五 在Debian上落地与锁定版本的操作要点

• 使用官方 kubernetes/deb 仓库并“固定版本”，避免无意升级：
  • 添加仓库与密钥，安装指定补丁版本（示例为 v1.29.10）：
    • curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.29/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-archive-keyring.gpg
    • echo “deb [signed-by=/etc/apt/keyrings/kubernetes-archive-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.29/deb/ /” | sudo tee /etc/apt/sources.list.d/kubernetes.list
    • sudo apt-get update
    • sudo apt-get install -y kubelet=1.29.10-00 kubeadm=1.29.10-00 kubectl=1.29.10-00
    • sudo apt-mark hold kubelet kubeadm kubectl
  • 初始化/升级时显式指定版本：kubeadm init --kubernetes-version=v1.29.10。
• 验证与回滚准备：
  • 核对组件版本：kubectl version --client && kubectl get nodes -o wide
  • 核对 apiserver 与 kubelet 偏差：确保满足“apiserver 最高、kubelet 最多低 2 个小版本”的约束
  • 保留回滚方案：备份关键清单与 etcd 快照，按“apiserver → 控制平面组件 → kubelet/kube-proxy”的顺序回滚。