You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: support/azure/azure-kubernetes/extensions/cannot-pull-image-from-acr-to-aks-cluster.md
+12-11Lines changed: 12 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,10 @@
1
1
---
2
2
title: Can't pull images from Azure Container Registry to Kubernetes
3
3
description: This article helps you troubleshoot the most common errors that you may encounter when pulling images from a container registry to an AKS cluster.
ms.custom: sap:Extensions, Policies and Add-Ons, devx-track-azurecli
10
10
---
@@ -349,15 +349,20 @@ spec:
349
349
nodeSelector:
350
350
"kubernetes.io/os": linux
351
351
```
352
-
## Cause 6: Kubelet exceeded the default pull rate limit for image
353
-
When multiple jobs require pulling same images it can exceed Kubelet default pull rate limit, see [registryPullQPS](https://kubernetes.io/docs/reference/config-api/kubelet-config.v1beta1/#kubelet-config-k8s-io-v1beta1-KubeletConfiguration)
352
+
## Cause 6: Kubelet exceeds the default image pull rate limit
353
+
354
+
When multiple jobs pull the same images, it can exceed the Kubelet default pull rate limit. In this case, the following error is displayed:
354
355
355
356
> Failed to pull image "acrname.azurecr.io/repo/nginx:latest": **pull QPS exceeded**. This occurred for pod podname at 4/22/2025, 12:48:32.000 PM UTC.
356
357
357
-
### Solution:
358
-
Change the [```imagePullPolicy```](https://kubernetes.io/docs/concepts/containers/images/#image-pull-policy) from ```Always``` to ```IfNotPresent``` to prevent unnecessary pulls.
358
+
For more information about the limit, see the [registryPullQPS configuration](https://kubernetes.io/docs/reference/config-api/kubelet-config.v1beta1/#kubelet-config-k8s-io-v1beta1-KubeletConfiguration).
359
+
360
+
### Solution: Change imagePullPolicy to IfNotPresent
361
+
362
+
To resolve this issue, change the value of [imagePullPolicy](https://kubernetes.io/docs/concepts/containers/images/#image-pull-policy) from `Always` to `IfNotPresent` in the deployment YAML file to prevent unnecessary pulls. `IfNotPresent` ensures that the image is pulled from the registry only if it's not already present on the node.
363
+
364
+
Here's an example of the deployment YAML file:
359
365
360
-
Here’s an example of how you can do this in your deployment YAML file:
361
366
```yaml
362
367
apiVersion: apps/v1
363
368
kind: Deployment
@@ -378,10 +383,6 @@ spec:
378
383
image: myacr.azurecr.io/my-image:latest
379
384
imagePullPolicy: IfNotPresent
380
385
```
381
-
In this example:
382
-
383
-
The imagePullPolicy: IfNotPresent ensures that the image is pulled from registry only if it is not already present on the node
0 commit comments