如何为现有AKS集群配置Windows认证配置文件以创建Windows节点池?
为存量AKS集群补配Windows认证配置的操作流程
出现Windows操作系统选项置灰、提示需要Windows认证配置文件的本质原因是:创建初始AKS集群时,没有初始化集群级别的Windows节点配置参数。目前Azure门户暂不支持直接为存量AKS集群补配该配置,需通过Azure CLI走官方预留的更新逻辑完成写入,具体步骤如下:
前置条件
- 本地安装的Azure CLI版本不低于2.32.0,旧版本无存量集群补配Windows配置的接口能力
- 对目标AKS集群拥有所有者或AKS集群管理员权限
- 准备符合复杂度要求的Windows节点管理员密码:长度至少12位,需同时包含大写字母、小写字母、数字、特殊字符,不符合要求的密码会直接触发命令校验报错
具体操作步骤
1. 登录并切换到目标订阅
依次执行以下命令完成CLI登录、订阅切换:
az login az account set --subscription "你的目标订阅ID"
2. 执行集群配置更新,注入Windows认证配置
运行官方支持的集群更新命令,完成Windows认证配置的写入:
az aks update --name 你的AKS集群名称 --resource-group 集群所在资源组名称 --windows-admin-password 你预先准备的管理员密码
注意:该命令配置的是所有后续新增Windows节点池的本地管理员账号密码,默认管理员用户名为
azureuser,无需额外指定。
配置更新过程预计需要3-10分钟,期间后端会自动完成控制面的配置注入,不需要手动重启控制面节点。
3. 验证配置是否生效
配置执行完成后,运行以下命令查询集群的Windows配置,确认配置写入成功:
az aks show --name 你的AKS集群名称 --resource-group 集群所在资源组名称 --query windowsProfile
如果返回结果中能看到adminUsername字段返回azureuser,说明配置已经生效。
4. 回到门户新增Windows节点池
打开AKS集群的节点池管理页面,点击新建节点池,此时操作系统选择项中的Windows选项已经可以正常选择,按照常规节点池的配置流程选定VM规格、节点数量、K8s版本即可完成创建。
常见踩坑提示
- 不要尝试通过手动修改ARM模板的方式直接添加
windowsProfile字段,未初始化过Windows配置的存量集群直接提交这类更新,后端会返回Windows profile cannot be added to an existing cluster的报错,必须走上述az aks update的官方命令路径,这是Azure专门为存量集群适配的补配逻辑 - 配置更新过程中不要中途取消操作,否则可能出现控制面配置不一致的问题,只需要重新执行一次更新命令即可修复
- 若你的K8s集群版本低于1.20.0,需要先将集群升级到1.20.0以上版本,再执行Windows配置补配操作,低版本集群不支持Windows节点池能力
- 已开启Azure AD集成的集群不需要额外调整认证参数,Windows节点池的权限模型和Linux节点池保持一致
内容的提问来源于stack exchange,提问作者Rafał Sroka
相关产品推荐
相关产品推荐

