|
1 | 1 | --- |
2 | 2 | title: Troubleshoot network isolated AKS clusters |
3 | | -description: Learn how to troubleshoot network isolated cluster issues in Azure Kubernetes Service (AKS). |
| 3 | +description: Learn how to troubleshoot network isolated cluster issues on Azure Kubernetes Service (AKS). |
4 | 4 | ms.service: azure-kubernetes-service |
5 | | -ms.date: 04/14/2025 |
| 5 | +ms.date: 04/15/2025 |
6 | 6 | ms.reviewer: doveychase, yuewu2, v-weizhu |
7 | 7 | #Customer intent: As an Azure Kubernetes user, I want to troubleshoot problems that involve the network isolated cluster so that I can successfully use this feature on Azure Kubernetes Service (AKS). |
8 | 8 | ms.custom: sap:Extensions, Policies and Add-Ons |
9 | 9 | --- |
10 | 10 | # Troubleshoot network isolated Azure Kubernetes Service (AKS) clusters issues |
11 | 11 |
|
12 | | -This article discusses how to troubleshoot issues on [network isolated Azure Kubernetes Service (AKS) clusters](/azure/aks/concepts-network-isolated). |
| 12 | +This article discusses how to troubleshoot issues in [network isolated Azure Kubernetes Service (AKS) clusters](/azure/aks/concepts-network-isolated). |
13 | 13 |
|
14 | 14 | ## Prerequisites |
15 | 15 |
|
16 | | -- The Kubernetes [kubectl](https://kubernetes.io/docs/reference/kubectl/overview/) tool. To install kubectl by using the [Azure CLI](/cli/azure/install-azure-cli), run the [az aks install-cli](/cli/azure/aks#az-aks-install-cli) command. |
| 16 | +- The Kubernetes [kubectl](https://kubernetes.io/docs/reference/kubectl/overview/) tool. You can install kubectl by running the [Azure CLI](/cli/azure/install-azure-cli) command [az aks install-cli](/cli/azure/aks#az-aks-install-cli). |
17 | 17 |
|
18 | 18 | ## Network isolated cluster support |
19 | 19 |
|
20 | | -The network isolated cluster follows a similar support model to other [AKS add-ons](/azure/aks/integrations). There are two options available for the private Azure Container Registry (ACR) with network isolated clusters. If you're using Bring your own (BYO) ACR, you're responsible for properly configuring your ACR and associated resources. |
| 20 | +The network isolated cluster follows a similar support model to other [AKS add-ons](/azure/aks/integrations). There are two options available for the private Azure Container Registry (ACR) used with a network isolated cluster: Bring your own (BYO) ACR and AKS-managed ACR. If you use BYO ACR, you're responsible for properly configuring your ACR and associated resources. |
21 | 21 |
|
22 | 22 | ## Issue 1: Cluster image pull fails due to network isolation |
23 | 23 |
|
24 | 24 | Network isolated clusters use ACR cache rules for image pull. When an image pull faiure occurs due to network isolation: |
25 | 25 |
|
26 | | -- If you're using Bring your own (BYO) ACR, check your private ACR resources, including the cache rule and private endpoints, to verify they're configured using recommendations outlined in the documentation. |
27 | | -- If you're using AKS-managed ACR, only Microsoft Container Registry (MCR) images are supported by default. If the image pull failure occurs on images from other registries, go to the private ACR to create extra cache rules for those images. If the image pull failure occurs on MCR images,proceed to check if the associated ACR and private endpoint resource named with keyword `bootstrap` exist. If they don't exist, reconcile the cluster. |
| 26 | +- If you're using Bring your own (BYO) ACR, check and verify the private ACR resources are configured, including the cache rule and private endpoints. For more information about how to configure them, see Step 3 and Step 4 under the [Deploy a network isolated cluster with bring your own ACR](/azure/aks/network-isolated?pivots=byo-acr#deploy-a-network-isolated-cluster-with-bring-your-own-acr) section. |
| 27 | +- If you're using AKS-managed ACR, only Microsoft Container Registry (MCR) images are supported by default. If the image pull failure occurs on images from other registries, go to the private ACR to create extra cache rules for those images. If the image pull failure occurs on MCR images, check if the associated ACR and private endpoint resource named with keyword `bootstrap` exist. If they don't exist, reconcile the cluster. |
28 | 28 |
|
29 | 29 | ## Issue 2: Cluster image pull fails after updating the existed cluster to network isolated cluster or updating the private ACR resource ID |
30 | 30 |
|
31 | | -The failure is an intended behavior. You need to reimage the node to update the kubelet configuration in Container Service Extension (CSE) following the update actions mentioned. |
| 31 | +The failure is an intended behavior. To resolve this issue, reimage the node to update the kubelet configuration in Container Service Extension (CSE) following the update actions in [Update your ACR ID](/azure/aks/network-isolated?pivots=byo-acr#update-your-acr-id). |
32 | 32 |
|
33 | 33 | ## Issue 3: ACR or associated cache rule, private endpoint or private DNS zone are deleted |
34 | 34 |
|
|
0 commit comments