Skip to content

Commit e627e89

Browse files
authored
editorial changes
1 parent dd5cb74 commit e627e89

File tree

1 file changed

+12
-11
lines changed

1 file changed

+12
-11
lines changed

support/azure/azure-kubernetes/extensions/cannot-pull-image-from-acr-to-aks-cluster.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
22
title: Can't pull images from Azure Container Registry to Kubernetes
33
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.
4-
ms.date: 03/25/2025
4+
ms.date: 06/04/2025
55
author: genlin
66
ms.author: genli
7-
ms.reviewer: chiragpa, andbar, v-weizhu, v-leedennis
7+
ms.reviewer: chiragpa, andbar, albarqaw, v-weizhu, v-leedennis
88
ms.service: azure-kubernetes-service
99
ms.custom: sap:Extensions, Policies and Add-Ons, devx-track-azurecli
1010
---
@@ -349,15 +349,20 @@ spec:
349349
nodeSelector:
350350
"kubernetes.io/os": linux
351351
```
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:
354355

355356
> 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.
356357
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:
359365

360-
Here’s an example of how you can do this in your deployment YAML file:
361366
```yaml
362367
apiVersion: apps/v1
363368
kind: Deployment
@@ -378,10 +383,6 @@ spec:
378383
image: myacr.azurecr.io/my-image:latest
379384
imagePullPolicy: IfNotPresent
380385
```
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
384-
385386
386387
## More information
387388

0 commit comments

Comments
 (0)