Kubernetes kubeadm 1.29版本中bootstrap-token阶段kubeconfig参数失效问题分析

在Kubernetes集群部署工具kubeadm的最新1.29版本中，用户报告了一个重要的功能回归问题。当使用kubeadm init phase bootstrap-token命令时，指定的--kubeconfig参数会被完全忽略，导致命令无法正常执行。

问题现象

在kubeadm 1.29版本中，当用户尝试使用自定义kubeconfig文件执行bootstrap-token阶段时，会遇到以下错误：

error execution phase bootstrap-token: could not bootstrap the admin user in file admin.conf: failed to load admin kubeconfig: open /etc/kubernetes/admin.conf: no such file or directory

这个错误表明命令强制尝试从默认路径/etc/kubernetes/admin.conf加载kubeconfig文件，而完全忽略了用户通过--kubeconfig参数指定的配置文件路径。

技术背景

bootstrap-token是kubeadm中用于初始化集群时创建引导令牌的重要阶段。这些令牌允许新节点加入集群，并为节点配置必要的RBAC规则和CSR自动批准机制。在1.28及更早版本中，用户可以通过--kubeconfig参数灵活指定任意位置的kubeconfig文件来完成这一过程。

问题根源

通过代码分析发现，这个问题源于1.29版本中引入的一个逻辑错误。在PR #121305的修改中，代码结构发生了变化，导致--kubeconfig参数的处理路径变得不可达。具体表现为：

1. 代码中设置了一个adminKubeConfigBootstrapped标志
2. 但这个标志只在默认kubeconfig路径的情况下才会被设置
3. 导致使用自定义kubeconfig路径时无法进入正确的处理分支

解决方案

社区已经确认这是一个回归问题，并提出了修复方案。核心思路是：

1. 首先判断用户是否使用了默认的kubeconfig路径
2. 如果是默认路径且尚未完成引导，则执行admin.conf的引导过程
3. 否则直接加载用户指定的kubeconfig文件

修复后的代码逻辑更加清晰，同时保留了原有的灵活性。这个修复将被包含在后续的1.29.x补丁版本中。

影响范围

这个问题影响所有使用kubeadm 1.29.0版本并依赖--kubeconfig参数执行bootstrap-token阶段的用户。特别是在自动化部署场景中，如果脚本依赖于指定自定义kubeconfig路径，将会遇到执行失败。

临时解决方案

在官方修复发布前，受影响的用户可以：

1. 暂时回退到kubeadm 1.28版本
2. 或者将自定义kubeconfig文件放置在默认路径/etc/kubernetes/admin.conf
3. 也可以考虑手动创建所需的引导令牌和RBAC规则

总结

这个问题的出现提醒我们，在升级关键基础设施工具时需要充分测试所有使用场景。kubeadm团队已经快速响应并制定了修复方案，体现了开源社区对问题的高效处理能力。对于生产环境用户，建议等待包含此修复的正式补丁版本发布后再进行升级。