Skip to content

Commit 17e2731

Browse files
authored
Update windows-cse-error-check-api-server-connectivity.md
review performed // added 1 more step for troubleshooting, as well as some documentation referring to windows CSE exit codes.
1 parent a47e534 commit 17e2731

1 file changed

Lines changed: 10 additions & 6 deletions

File tree

support/azure/azure-kubernetes/create-upgrade-delete/windows-cse-error-check-api-server-connectivity.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
title: Troubleshoot WINDOWS_CSE_ERROR_CHECK_API_SERVER_CONNECTIVITY error (5)
33
description: Learn how to troubleshoot the WINDOWS_CSE_ERROR_CHECK_API_SERVER_CONNECTIVITY error (5) when you try to add Windows node pools in an AKS cluster.
4-
ms.date: 10/31/2023
5-
ms.reviewer: shtao, abelch, junjiezhang, v-weizhu
4+
ms.date: 03/26/2025
5+
ms.reviewer: shtao, abelch, junjiezhang, v-weizhu, addobres
66
ms.service: azure-kubernetes-service
77
#Customer intent: As an Azure Kubernetes user, I want to troubleshoot the WINDOWS_CSE_ERROR_CHECK_API_SERVER_CONNECTIVITY error (5) so that I can successfully add Windows node pools in an Azure Kubernetes Service (AKS) cluster.
88
ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool)
@@ -31,7 +31,9 @@ Your cluster nodes can't connect to the cluster API server pod.
3131

3232
## Troubleshooting steps
3333

34-
1. Verify that your nodes can resolve the cluster's fully qualified domain name (FQDN):
34+
1. Follow these [steps](https://learn.microsoft.com/en-us/azure/aks/node-access#windows-server-proxy-connection-for-ssh) to connect to the respective node:
35+
36+
2. Verify that your nodes can resolve the cluster's fully qualified domain name (FQDN):
3537

3638
On existing Windows nodes, run the following command:
3739

@@ -45,16 +47,18 @@ Your cluster nodes can't connect to the cluster API server pod.
4547
nc -vz <cluster-fqdn> 443
4648
```
4749
48-
2. If the command output shows `False` or `Timeout`, check your network configuration. For example, check whether you set "Deny" rules for the API server in network security groups (NSGs) of the virtual network.
50+
3. If the command output shows `False` or `Timeout`, check your network configuration. For example, check whether you set "Deny" rules for the API server in network security groups (NSGs) of the virtual network.
4951
50-
3. If you're using egress filtering through a firewall, make sure that traffic is allowed to your cluster FQDN.
52+
4. If you're using egress filtering through a firewall, make sure that traffic is allowed to your cluster FQDN.
5153
52-
4. If you've authorized IP addresses that are enabled on your cluster, the firewall's outbound IP address can be blocked. In this scenario, you must add the outbound IP address of the firewall to the list of authorized IP ranges for the cluster. For more information, see [Secure access to the API server using authorized IP address ranges in AKS](/azure/aks/api-server-authorized-ip-ranges).
54+
5. If you've authorized IP addresses that are enabled on your cluster, the firewall's outbound IP address can be blocked. In this scenario, you must add the outbound IP address of the firewall to the list of authorized IP ranges for the cluster. For more information, see [Secure access to the API server using authorized IP address ranges in AKS](/azure/aks/api-server-authorized-ip-ranges).
5355
5456
## References
5557
5658
[General troubleshooting of AKS cluster creation issues](troubleshoot-aks-cluster-creation-issues.md)
5759
60+
[More exit codes in Windows CSE](https://github.com/Azure/AgentBaker/blob/master/parts/windows/windowscsehelper.ps1)
61+
5862
[!INCLUDE [Third-party disclaimer](../../../includes/third-party-disclaimer.md)]
5963
6064
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

0 commit comments

Comments
 (0)