跳到正文
每周二、五更新 · 排障记录与可运行代码邮件订阅:hi@xiaoming1.cn
编程心得标志,字母 A 与代码尖括号组合编程心得Awesome Dev

Kubernetes 1.31 升级窗口:把 3 个版本差拆成两次发布

一位工作人员走在数据中心机房的服务器通道里
一位工作人员走在数据中心机房的服务器通道里。配图为免费图库实拍,与本文主题对应。

2024 年 8 月 13 日,CNCF 发布 Kubernetes 1.31,代号 Elli。这个版本把 AppArmor 支持推进到 beta,并继续收紧 Pod 安全相关默认值。

事实核对
  • 发布机构:CNCF,发布时间 2024 年 8 月 13 日
  • 版本信息:Kubernetes 1.31,代号 Elli
  • 升级跨度:从 1.28 到 1.31,共 3 个次版本

为什么要拆成两次

Kubernetes 官方建议一次最多跨一个次版本升级控制面,1.28 到 1.31 直接跳会跳过两个中间版本的弃用检查。我们把它拆成 1.28 到 1.29、1.29 到 1.31 两次,每次间隔 7 天,留出观察期。

第一次窗口只动控制面,工作负载保持在 1.28;第二次窗口再滚工作节点。每个窗口 45 分钟,etcd 快照在开始前完成,快照恢复演练在一台预发集群上做过 3 次,平均 11 分钟恢复。

AppArmor 进入 beta

1.31 的 AppArmor 支持进入 beta,Pod 可以通过 securityContext.appArmorProfile 指定配置。节点必须预装 AppArmor 并加载对应 profile,否则 Pod 会启动失败,事件里写的是 profile not found。

我们用一条 12 行的 profile 限制了一个日志采集容器的写路径,测试 6 个越权写入全部被拒绝。上线前先在 3 个节点开启,观察 48 小时,确认没有误拦截再扩到全部节点。

API 与默认值检查

升级前用 kubectl api-resources 与 kube-no-trouble 扫一遍,确认没有依赖已移除的 API。1.31 的弃用清单里包含若干 v1beta1 资源,客户端版本低于 1.28 的 operator 最容易踩到。

默认值方面,重点关注 Service 的 externalTrafficPolicy 与 Pod 的 securityContext。变更不会直接让集群挂掉,但会让部分流量走向改变,升级后用 3 个探针检查入口、内部调用和定时任务。

回滚条件写进发布单

回滚不是“失败了再说”。发布单里写三条硬条件:控制面 API 5xx 超过 1%、关键业务 P99 翻倍、etcd 成员健康检查连续 2 分钟失败。任一条触发,立即恢复快照并回退 kubelet 版本。

1.31 的支持窗口仍按 CNCF 的 14 个月计算,1.28 在 2025 年 10 月结束维护。把升级排到支持结束前 3 个月,能留出两次失败重试的机会,不要把窗口压到最后一个星期。

文中提到的命令与数据来自公开版本说明和本站测试机。换环境后数值会变,先在小规模数据上复跑一遍,再动生产。

相关

读完可以接着看

两件与本文问题域直接相关的产品。

把下一次故障写成可复用的记录

每周二、五发一封邮件,只放当周的排障笔记、命令清单和一处容易踩错的细节。不发广告,随时可退。

hi@xiaoming1.cn

也可以直接打电话:0668-339 7712,工作日 09:30 至 18:00。