使用Azure SDK for Python升级AKS集群Kubernetes版本的问题咨询

早期报错原因 #

你最早遇到的AttributeError: 'ManagedClustersOperations' object has no attribute 'create_or_update'是因为新版Azure Python SDK已经移除了同步的create_or_update方法，所有集群变更操作统一使用异步的begin_create_or_update方法，你后续修改后的方法名是正确的。 #

无报错但集群未升级的核心原因 #

1. 异步操作未等待执行 #

所有带begin_前缀的SDK方法都是长作业异步操作，调用后仅返回操作轮询器对象，不会主动阻塞等待作业执行完成。如果你的脚本调用该方法后直接退出，升级请求还未提交到Azure服务端，自然不会触发实际升级。
解决方法：调用轮询器的wait()方法阻塞等待操作完成，或者调用result()方法直接获取执行结果：

update_aks = containerservice_client.managed_clusters.begin_create_or_update(
    resource_group_name=group.name,
    resource_name=resource.name,
    parameters=param
)
# 等待升级操作执行完成，可传入timeout参数设置超时时间（单位：秒）
update_aks.wait()
# 或者直接获取操作结果，会自动阻塞到操作完成
# upgrade_result = update_aks.result()

2. 参数构造存在潜在问题 #

你当前构造ManagedCluster参数时，仅传入了版本、节点池名称、模式等少数字段，直接提交会覆盖集群原有配置，容易丢失节点数、VM规格、磁盘配置、标签污点等自定义配置，甚至因为参数缺失导致请求被服务端静默拒绝。
推荐的参数构造方式是先拉取现有集群的配置，在原有基础上修改版本字段，避免配置丢失：

# 先获取现有集群的完整配置
existing_cluster = containerservice_client.managed_clusters.get(group.name, resource.name)
# 修改控制面K8s版本
existing_cluster.kubernetes_version = latest_version
# 遍历修改所有节点池的K8s版本
for pool in existing_cluster.agent_pool_profiles:
    pool.orchestrator_version = latest_version
# 提交更新请求
update_aks = containerservice_client.managed_clusters.begin_create_or_update(
    group.name,
    resource.name,
    existing_cluster
)
update_aks.wait()

其他排查要点 #

• 确认azure-mgmt-containerservice依赖版本为最新稳定版，旧版本SDK存在接口逻辑缺陷，可执行命令升级：pip install --upgrade azure-mgmt-containerservice
• 确认你使用的服务主体/身份凭证有Microsoft.ContainerService/managedClusters/write权限，权限不足会导致请求被静默拦截，可以到Azure门户对应集群的活动日志中筛选操作记录，查看是否有升级请求提交、以及具体的失败原因
• AKS不支持跨多个Minor版本升级（例如不能直接从1.19.x升级到1.21.x），请确认你选择的目标版本是当前版本允许直接升级的兼容版本

内容的提问来源于stack exchange，提问作者Matrix