You need to enable JavaScript to run this app. 如何为现有AKS集群配置Windows认证配置文件以创建Windows节点池?
优惠活动
大模型
产品
解决方案
定价
更多

如何为现有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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.05 20:27:04