Azure DevOps中Helm部署AKS资源遇连接超时问题求助

1. 检查Pipeline代理的网络连通性 #

• 如果用Microsoft托管代理：确认AKS的NSG（网络安全组）没有拒绝公共网络访问AKS API端口443。可以临时在NSG入站规则里添加允许AzureCloud服务标签访问443端口的规则，测试是否能连通。
• 如果用自托管代理：检查代理所在网络的防火墙、路由策略，确保能访问AKS的公网IP（20.255.255.140），或者通过VPN/ExpressRoute让代理接入AKS所在的虚拟网络。

2. 确认AKS集群API服务器状态 #

• 登录Azure门户查看AKS集群状态，确保API服务器正常运行，没有处于维护或异常状态。
• 本地用Azure CLI执行az aks get-credentials --resource-group xx --name xx --admin，再运行kubectl version验证集群API是否能正常响应，排除集群本身的故障。

3. 优化HelmDeploy任务配置 #

• 给任务添加超时参数，延长连接等待时间：在inputs里新增timeout: '600'（单位秒，可按需调整）。
• 切换使用新版HelmDeploy任务（比如HelmDeploy@1），旧版本可能存在兼容性问题。
• 检查azureSubscription对应的服务主体权限，确保它拥有Azure Kubernetes Service Cluster Admin Role或足够的AKS访问权限。

4. 强制重新获取集群凭据 #

在HelmDeploy任务前添加Azure CLI任务，手动获取AKS凭据，避免任务自动获取时的缓存问题：

- task: AzureCLI@2
  displayName: 'Get AKS credentials'
  inputs:
    azureSubscription: xx
    scriptType: 'bash'
    scriptLocation: 'inlineScript'
    inlineScript: 'az aks get-credentials --resource-group xx --name xx --admin --overwrite-existing'

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