1.31 版本信息和更新操作

查看 IBM Cloud® Kubernetes Service 的 1.31 版本信息。有关 Kubernetes 项目版本 1.31 的更多信息，请参阅 Kubernetes 变更日志。

此徽章表示 Kubernetes 版本 1.31 IBM Cloud Kubernetes Service — Kubernetes 版本 1.31 认证徽章

IBM Cloud Kubernetes Service 是 CNCF 软件一致性认证计划下版本的认证产品。Kubernetes 1.31 Kubernetes Kubernetes® 是基金会在美国和其他国家的注册商标，根据基金会的许可使用。Linux Linux

发布时间表

下表包括 IBM Cloud® Kubernetes Service 的 1.31 版本的预期发布时间表。您可以将此信息用于规划目的，例如估计该版本可能不支持的大致时间。

标记有短剑 (†) 的日期表示这是暂定时间，会随时更改。

IBM Cloud Kubernetes Service 1.31 版本的发布时间表
版本	是否受支持？	发布日期	不受支持的日期
1.31	是	2024 年 9 月 18 日	2025 年 12 月 10 日 `†`

准备更新

此信息汇总了将群集更新到 1.31 版本时可能对已部署应用程序产生影响的更新。有关变更的完整列表，请查看版本 1.31 的社区 Kubernetes 变更日志和 IBM 版本变更日志。您还可以查看 Kubernetes 有用的警告。

Portworx 尚不支持 1.31 版本。如果您的应用程序使用 Portworx 版本，请不要将集群升级到 1.31 版本。

在更新主节点之前更新

下表说明了在更新 Kubernetes 主节点之前必须执行的操作。

在将主文件更新为 Kubernetes 1.31 之前需要进行的更改
类型	描述
Calico API 服务器是受管资源	IBM Cloud Kubernetes Service 现在可以管理 Calico API 服务器组件的安装和更新。如果您的群集包含 `calico-apiserver` 命名空间，则必须在升级前卸载 Calico API 服务器。此外，如果有任何网络策略阻止从 kube-system/konnectivity-agent pod 传出，包括基于 allow-egress-pods-public 这样适用于所有 pod 的示例策略，则还需要允许从 kube-system/konnectivity-agent pod 传出到 calico-apiserver/calico-apiserver pod 上的 5443 端口。
防止音量模式转换	Kubernetes 快照控制器现在会在从卷快照创建持久卷主张时拒绝卷模式更改，除非 `snapshot.storage.kubernetes.io/allow-volume-mode-change: "true"` 注解已添加到与 `VolumeSnapshot` 相对应的 `VolumeSnapshotContent` 中。有关更多信息，请参阅转换快照的卷模式。
Ubuntu 24 是默认操作系统	Ubuntu 24 现在是 IBM Cloud Kubernetes Service 版本 1.31 群集的默认操作系统。有关 Ubuntu 24 的更多信息和可能的迁移操作，请参阅迁移到新的 Ubuntu 版本。

在更新主节点之后更新

下表说明了在更新 Kubernetes 主节点之后必须执行的操作。

将主文件更新为 Kubernetes 1.31 后要进行的更改
类型	描述
不支持： `kubectl exec` 命令执行时不带破折号	过时的 `kubectl exec [POD] [COMMAND]` 命令执行已被删除，取而代之的是 `kubectl exec [POD] -- [COMMAND]`。如果脚本依赖于先前的行为，请更新这些脚本。
不支持： `kubectl drain` `--delete-local-data` 选项	删除了 `--delete-local-data` 命令中过时的 `kubectl drain` 选项，代之以 `--delete-emptydir-data` 选项。如果脚本依赖于先前的行为，请更新这些脚本。
不支持：许多 `kubectl run` 选项	删除了 `--filename`, `--force`, `--grace-period`, `--kustomize`, `--recursive`, `--timeout` 和 `--wait` 命令的 `kubectl run` 选项。如果脚本依赖于先前的行为，请更新这些脚本。
弃用： Pod `container.apparmor.security.beta.kubernetes.io` 注释	Pod `container.apparmor.security.beta.kubernetes.io` 注解现已废弃。对于 pod 和容器，这些注释会被 `securityContext.appArmorProfile` 字段取代。如果您的 pod 依赖于这些已废弃的注释，请更新它们，改用 `securityContext.appArmorProfile` 字段。有关详细信息，请参阅 AppArmor 支持现已稳定。
已弃用：持久音量 `volume.beta.kubernetes.io/mount-options` 注解	持久卷 `volume.beta.kubernetes.io/mount-options` 注解现已废弃。该注释由 `spec.mountOptions` 字段代替。如果您的 pod 依赖于这个已废弃的注解，请更新它们，改用 `spec.mountOptions` 字段。有关更多信息，请参阅安装选项。