Skip to content

Commit 40b7f17

Browse files
authored
Merge pull request #7917 from AmandaAZ/Branch-PostEdit
Roll back four original docs that are deleted in PR#7827
2 parents 5d44b41 + cf69e40 commit 40b7f17

8 files changed

Lines changed: 332 additions & 40 deletions

support/azure/.openpublishing.redirection.azure.json

Lines changed: 0 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -6274,26 +6274,6 @@
62746274
"source_path": "azure-kubernetes/connectivity/stale-watch-azure-ad-pod-identity-nmi-status-500.md",
62756275
"redirect_url": "/troubleshoot/azure/azure-kubernetes/welcome-azure-kubernetes",
62766276
"redirect_document_id": false
6277-
},
6278-
{
6279-
"source_path": "azure-kubernetes/create-upgrade-delete/error-code-cnidownloadtimeoutvmextensionerror.md",
6280-
"redirect_url": "/troubleshoot/azure/azure-kubernetes/error-codes/vmextensionerror-cnidownloadtimeout",
6281-
"redirect_document_id": true
6282-
},
6283-
{
6284-
"source_path": "azure-kubernetes/create-upgrade-delete/error-code-k8sapiserverconnfailvmextensionerror.md",
6285-
"redirect_url": "/troubleshoot/azure/azure-kubernetes/error-codes/vmextensionerror-k8sapiserverconnfail",
6286-
"redirect_document_id": true
6287-
},
6288-
{
6289-
"source_path": "azure-kubernetes/create-upgrade-delete/error-code-k8sapiserverdnslookupfailvmextensionerror.md",
6290-
"redirect_url": "/troubleshoot/azure/azure-kubernetes/error-codes/vmextensionerror-k8sapiserverdnslookupfail",
6291-
"redirect_document_id": true
6292-
},
6293-
{
6294-
"source_path": "azure-kubernetes/create-upgrade-delete/error-code-outboundconnfailvmextensionerror.md",
6295-
"redirect_url": "/troubleshoot/azure/azure-kubernetes/error-codes/vmextensionerror-outboundconnfail",
6296-
"redirect_document_id": true
62976277
}
62986278
]
62996279
}

support/azure/azure-kubernetes/availability-performance/node-not-ready-expired-certificates.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -55,9 +55,9 @@ Check the expiration dates of certificates by invoking the [openssl-x509](https:
5555

5656
You might receive certain error codes after you invoke these commands. For information about error codes 50, 51, and 52, see the following links, as necessary:
5757

58-
- [Troubleshoot the VMExtensionError_OutboundConnFail error code (50)](../error-codes/vmextensionerror-outboundconnfail.md)
59-
- [Troubleshoot the VMExtensionError_K8SAPIServerConnFail error code (51)](../error-codes/vmextensionerror-k8sapiserverconnfail.md)
60-
- [Troubleshoot the VMExtensionError_K8SAPIServerDNSLookupFail error code (52)](../error-codes/vmextensionerror-k8sapiserverdnslookupfail.md)
58+
- [Troubleshoot the OutboundConnFailVMExtensionError error code (50)](../create-upgrade-delete/error-code-outboundconnfailvmextensionerror.md)
59+
- [Troubleshoot the K8SAPIServerConnFailVMExtensionError error code (51)](../create-upgrade-delete/error-code-k8sapiserverconnfailvmextensionerror.md)
60+
- [Troubleshoot the K8SAPIServerDNSLookupFailVMExtensionError error code (52)](../create-upgrade-delete/error-code-k8sapiserverdnslookupfailvmextensionerror.md)
6161

6262
If you receive error code 99, this indicates that the [apt-get update](https://linux.die.net/man/8/apt-get) command is being blocked from accessing one or more of the following domains:
6363

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
---
2+
title: Troubleshoot Container Network Interface download failures
3+
description: Learn how to resolve Container Network Interface download failures when you try to create and deploy an Azure Kubernetes Service (AKS) cluster.
4+
ms.date: 11/18/2024
5+
editor: v-jsitser
6+
ms.reviewer: axelg, chiragpa, mariochaves, v-weizhu, v-leedennis
7+
ms.service: azure-kubernetes-service
8+
#Customer intent: As an Azure Kubernetes user, I want to troubleshoot the container network interface download failures so that I can successfully create and deploy an Azure Kubernetes Service (AKS) cluster.
9+
ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool)
10+
---
11+
# Troubleshoot Container Network Interface download failures
12+
13+
This article discusses how to identify and resolve the `CniDownloadTimeoutVMExtensionError` error code (also known as error code `ERR_CNI_DOWNLOAD_TIMEOUT`, error number 41) or the `WINDOWS_CSE_ERROR_DOWNLOAD_CNI_PACKAGE` error code (error number 35) that occurs when you try to create and deploy a Microsoft Azure Kubernetes Service (AKS) cluster.
14+
15+
## Prerequisites
16+
17+
- The [Curl](https://curl.se/download.html) command-line tool
18+
19+
## Symptoms
20+
21+
When you try to create a Linux-based AKS cluster, you receive the following error message:
22+
23+
```output
24+
Message: We are unable to serve this request due to an internal error
25+
SubCode: CniDownloadTimeoutVMExtensionError;
26+
Message="VM has reported a failure when processing extension 'vmssCSE'.
27+
Error message: "Enable failed: failed to execute command: command terminated with exit status=41\n[stdout]\n{
28+
"ExitCode": "41",
29+
```
30+
31+
When you try to create a Windows-based AKS cluster, you receive the following error message:
32+
33+
```output
34+
Message="VM has reported a failure when processing extension 'vmssCSE' (publisher 'Microsoft.Compute' and type 'CustomScriptExtension').
35+
Error message: 'Command execution finished, but failed because it returned a non-zero exit code of: '1'. The command had an error output of: 'ExitCode: |35|,
36+
Output: |WINDOWS_CSE_ERROR_DOWNLOAD_CNI_PACKAGE|, Error: |Failed in downloading \r\nhttps://acs-mirror.azureedge.net/azure-cni/v1.4.56/binaries/azure-vnet-cni-overlay-windows-amd64-v1.4.56.zip.
37+
Error: \r\nUnable to connect to the r|\r\nAt line:1 ...'
38+
For more information, check the instance view by executing Get-AzVmssVm or Get-AzVm (https://aka.ms/GetAzVm). These commands can be executed using CloudShell (https://aka.ms/CloudShell)'. More information on troubleshooting is available at https://aka.ms/VMExtensionCSEWindowsTroubleshoot.
39+
```
40+
41+
## Cause
42+
43+
Your cluster nodes can't connect to the endpoint that's used to download the Container Network Interface (CNI) libraries. In most cases, this issue occurs because a network virtual appliance is blocking Secure Sockets Layer (SSL) communication or an SSL certificate.
44+
45+
## Solution
46+
47+
Run a Curl command to verify that your nodes can download the binaries:
48+
49+
```bash
50+
curl https://acs-mirror.azureedge.net/cni/azure-vnet-cni-linux-amd64-v1.0.25.tgz
51+
52+
curl --fail --ssl https://acs-mirror.azureedge.net/cni/azure-vnet-cni-linux-amd64-v1.0.25.tgz --output /opt/cni/downloads/azure-vnet-cni-linux-amd64-v1.0.25.tgz
53+
```
54+
55+
If you can't download these files, make sure that traffic is allowed to the downloading endpoint. For more information, see [Azure Global required FQDN/application rules](/azure/aks/outbound-rules-control-egress#azure-global-required-fqdn--application-rules).
56+
57+
## References
58+
59+
- [General troubleshooting of AKS cluster creation issues](troubleshoot-aks-cluster-creation-issues.md)
60+
61+
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]
Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
---
2+
title: Troubleshoot the K8SAPIServerConnFailVMExtensionError error code (51)
3+
description: Learn how to troubleshoot the K8SAPIServerConnFailVMExtensionError error (51) when you try to start or create and deploy an Azure Kubernetes Service (AKS) cluster.
4+
ms.date: 01/24/2024
5+
ms.reviewer: rissing, chiragpa, erbookbi, v-leedennis, jovieir
6+
ms.service: azure-kubernetes-service
7+
#Customer intent: As an Azure Kubernetes user, I want to troubleshoot the K8SAPIServerConnFailVMExtensionError error code (or error code ERR_K8S_API_SERVER_CONN_FAIL, error number 51) so that I can successfully start or create and deploy an Azure Kubernetes Service (AKS) cluster.
8+
ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool)
9+
---
10+
# Troubleshoot the K8SAPIServerConnFailVMExtensionError error code (51)
11+
12+
This article discusses how to identify and resolve the `K8SAPIServerConnFailVMExtensionError` error (also known as error code ERR_K8S_API_SERVER_CONN_FAIL, error number 51) that occurs when you try to start or create and deploy a Microsoft Azure Kubernetes Service (AKS) cluster.
13+
14+
## Prerequisites
15+
16+
- The [Netcat](https://linuxcommandlibrary.com/man/netcat) (nc) command-line tool
17+
18+
## Symptoms
19+
20+
When you try to start or create an AKS cluster, you receive the following error message:
21+
22+
> Unable to establish connection from agents to Kubernetes API server, please see <https://aka.ms/aks-required-ports-and-addresses> for more information.
23+
>
24+
> Details: Code="VMExtensionProvisioningError"
25+
>
26+
> Message="VM has reported a failure when processing extension 'vmssCSE'.
27+
>
28+
> Error message: "**Enable failed: failed to execute command: command terminated with exit status=51**\n[stdout]\n{
29+
>
30+
> "ExitCode": "51",
31+
>
32+
> "Output": "Thu Oct 14 18:07:37 UTC 2021,aks-nodepool1-18315663-vmss000000\\nConnection to
33+
## Cause
34+
35+
Your cluster nodes can't connect to your cluster API server pod.
36+
37+
## Solution
38+
39+
Run a Netcat command to verify that your nodes can resolve the cluster's fully qualified domain name (FQDN):
40+
41+
```shell
42+
nc -vz <cluster-fqdn> 443
43+
```
44+
45+
If you're using egress filtering through a firewall, make sure that traffic is allowed to your cluster FQDN.
46+
47+
In rare cases, the firewall's outbound IP address can be blocked if you've authorized IP addresses that are enabled on your cluster. In this scenario, you must add the outbound IP address of your 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).
48+
49+
## More information
50+
51+
- [General troubleshooting of AKS cluster creation issues](troubleshoot-aks-cluster-creation-issues.md)
52+
53+
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]
Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
title: Troubleshoot the K8SAPIServerDNSLookupFailVMExtensionError error code (52)
3+
description: Learn how to troubleshoot the K8SAPIServerDNSLookupFailVMExtensionError error (52) when you try to start or create and deploy an Azure Kubernetes Service (AKS) cluster.
4+
ms.date: 01/24/2024
5+
ms.reviewer: rissing, chiragpa, erbookbi, v-leedennis, jovieir
6+
ms.service: azure-kubernetes-service
7+
#Customer intent: As an Azure Kubernetes user, I want to troubleshoot the K8SAPIServerDNSLookupFailVMExtensionError error code (or error code ERR_K8S_API_SERVER_DNS_LOOKUP_FAIL, error number 52) so that I can successfully start or create and deploy an Azure Kubernetes Service (AKS) cluster.
8+
ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool)
9+
---
10+
# Troubleshoot the K8SAPIServerDNSLookupFailVMExtensionError error code (52)
11+
12+
This article discusses how to identify and resolve the `K8SAPIServerDNSLookupFailVMExtensionError` error (also known as error code ERR_K8S_API_SERVER_DNS_LOOKUP_FAIL, error number 52) that occurs when you try to start or create and deploy a Microsoft Azure Kubernetes Service (AKS) cluster.
13+
14+
## Prerequisites
15+
16+
- The [nslookup](/windows-server/administration/windows-commands/nslookup) DNS lookup tool for Windows nodes or the [dig](https://linuxize.com/post/how-to-use-dig-command-to-query-dns-in-linux/) tool for Linux nodes.
17+
18+
- [Azure CLI](/cli/azure/install-azure-cli), version 2.0.59 or a later version. If Azure CLI is already installed, you can find the version number by running `az --version`.
19+
20+
## Symptoms
21+
22+
When you try to start or create an AKS cluster, you receive the following error message:
23+
24+
> Agents are unable to resolve Kubernetes API server name. It's likely custom DNS server is not correctly configured, please see <https://aka.ms/aks/private-cluster#hub-and-spoke-with-custom-dns> for more information.
25+
>
26+
> Details: Code="VMExtensionProvisioningError"
27+
>
28+
> Message="VM has reported a failure when processing extension 'vmssCSE'.
29+
>
30+
> Error message: "**Enable failed: failed to execute command: command terminated with exit status=52**\n[stdout]\n{
31+
>
32+
> "ExitCode": "52",
33+
>
34+
> "Output": "Fri Oct 15 10:06:00 UTC 2021,aks- nodepool1-36696444-vmss000000\\nConnection to mcr.microsoft.com 443 port [tcp/https]
35+
## Cause
36+
37+
The cluster nodes can't resolve the cluster's fully qualified domain name (FQDN) in Azure DNS. Run the following DNS lookup command on the failed cluster node to find DNS resolutions that are valid.
38+
39+
| Node OS | Command |
40+
| ------- | ------------------------- |
41+
| Linux | `dig <cluster-fqdn>` |
42+
| Windows | `nslookup <cluster-fqdn>` |
43+
44+
## Solution
45+
46+
On your DNS servers and firewall, make sure that nothing blocks the resolution to your cluster's FQDN. Your custom DNS server might be incorrectly configured if something is blocking even after you run the `nslookup` or `dig` command and apply any necessary fixes. For help to configure your custom DNS server, review the following articles:
47+
48+
- [Create a private AKS cluster](/azure/aks/private-clusters)
49+
- [Private Azure Kubernetes service with custom DNS server](https://github.com/Azure/terraform/tree/00d15e09c54f25fb6387330c36aa4366122c5aaa/quickstart/301-aks-private-cluster)
50+
- [What is IP address 168.63.129.16?](/azure/virtual-network/what-is-ip-address-168-63-129-16)
51+
52+
When you use a private cluster that has a custom DNS, a DNS zone is created. The DNS zone must be linked to the virtual network. This occurs after the cluster is created. Creating a private cluster that has a custom DNS fails during creation. However, you can restore the creation process to a "success" state by reconciling the cluster. To do this, run the [az resource update](/cli/azure/resource#az-resource-update) command in Azure CLI, as follows:
53+
54+
```azurecli-interactive
55+
az resource update --resource-group <resource-group-name> \
56+
--name <cluster-name> \
57+
--namespace Microsoft.ContainerService \
58+
--resource-type ManagedClusters
59+
```
60+
61+
Also verify that your DNS server is configured correctly for your private cluster, as described earlier.
62+
63+
> [!NOTE]
64+
> Conditional Forwarding doesn't support subdomains.
65+
## More information
66+
67+
- [General troubleshooting of AKS cluster creation issues](troubleshoot-aks-cluster-creation-issues.md)
68+
69+
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

0 commit comments

Comments
 (0)