Kubernetes v1.31：kubeadm v1beta4
内容提要
Kubernetes v1.31发布了kubeadm v1beta4版本，支持新的配置文件格式。建议迁移到v1beta4并停止使用v1beta3。v1beta4修复了一些问题并添加了新字段。迁移方法是使用kubeadm config migrate命令。
延伸解读
迁移时间窗口与兼容性
v1beta3 配置格式已正式弃用，但支持至少 3 个 Kubernetes 次要版本。这意味着您有约 3 个版本的过渡期来迁移到 v1beta4。建议尽快使用 kubeadm config migrate 命令迁移，避免未来版本升级时配置失效。
新增字段的实用价值
v1beta4 新增了多个实用字段：certificateValidityPeriod 和 caCertificateValidityPeriod 可自定义证书有效期（默认非 CA 1 年、CA 10 年）；encryptionAlgorithm 支持 RSA-2048/3072/4096 或 ECDSA-P256；dns.disabled 和 proxy.disabled 可在初始化时禁用 CoreDNS 和 kube-proxy；imagePullSerial 控制镜像拉取方式。这些字段提升了配置灵活性。
配置结构的重要变化
extraArgs 从 map 改为结构化参数，支持重复参数，涉及 apiServer、controllerManager、scheduler、etcd 和 kubeletExtraArgs。新增 timeouts 结构统一管理超时，替代了 ClusterConfiguration.timeoutForControlPlane 和 JoinConfiguration.discovery.timeout。此外，UpgradeConfiguration 和 ResetConfiguration 成为独立配置类型，支持通
升级时的注意事项
使用 kubeadm upgrade 子命令时，若传递 --config，其中 kubelet 和 kube-proxy 的组件配置以及 InitConfiguration 和 ClusterConfiguration 已弃用且会被忽略。请改用 UpgradeConfiguration 来配置升级过程。迁移时务必使用 kubeadm config migrate 命令，确保配置文件格式正确转换。
Q&A
kubeadm v1beta4版本有哪些新特性？
kubeadm v1beta4版本新增了ResetConfiguration和UpgradeConfiguration字段，支持dryRun模式和nodeRegistration.imagePullSerial字段，并增加了多个ClusterConfiguration的新字段。
如何从v1beta3迁移到v1beta4？
可以使用kubeadm config migrate命令将旧格式配置文件转换为新格式，例如：kubeadm config migrate --old-config old-v1beta3.yaml --new-config new-v1beta4.yaml。
v1beta3格式被弃用的原因是什么？
v1beta3格式被正式弃用是因为它不再支持新的功能和改进，建议用户迁移到v1beta4以获得更好的支持和新特性。
v1beta4中ClusterConfiguration新增了哪些字段？
v1beta4中ClusterConfiguration新增了certificateValidityPeriod、caCertificateValidityPeriod、encryptionAlgorithm、dns.disabled和proxy.disabled等字段。
kubeadm v1beta4如何支持自定义环境变量？
kubeadm v1beta4支持在ClusterConfiguration中为所有控制平面组件使用自定义环境变量，例如通过apiServer.extraEnvs、controllerManager.extraEnvs等字段。
kubeadm v1beta4的UpgradeConfiguration有什么变化？
在v1beta4中，UpgradeConfiguration kubeadm API得到了支持，用户可以在升级子命令中使用--config参数。
