Skip to content

Commit 0e7810a

Browse files
committed
Add documentation for ImagePullBackOff
1 parent c4d103b commit 0e7810a

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

content/en/docs/concepts/containers/images.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,6 +77,20 @@ the pull policy of any object after its initial creation.
7777

7878
When `imagePullPolicy` is defined without a specific value, it is also set to `Always`.
7979

80+
### ImagePullBackOff
81+
82+
When a kubelet starts creating containers for a Pod using a container runtime,
83+
it might be possible the container is in [Waiting](/docs/concepts/workloads/pods/pod-lifecycle/#container-state-waiting)
84+
state because of `ImagePullBackOff`.
85+
86+
The status `ImagePullBackOff` means that a container could not start because Kubernetes
87+
could not pull a container image (for reasons such as invalid image name, or pulling
88+
from a private registry without `imagePullSecret`). The `BackOff` part indicates
89+
that Kubernetes will keep trying to pull the image, with an increasing back-off delay.
90+
91+
Kubernetes raises the delay between each attempt until it reaches a compiled-in limit,
92+
which is 300 seconds (5 minutes).
93+
8094
## Multi-architecture images with image indexes
8195

8296
As well as providing binary images, a container registry can also serve a [container image index](https://github.com/opencontainers/image-spec/blob/master/image-index.md). An image index can point to multiple [image manifests](https://github.com/opencontainers/image-spec/blob/master/manifest.md) for architecture-specific versions of a container. The idea is that you can have a name for an image (for example: `pause`, `example/mycontainer`, `kube-apiserver`) and allow different systems to fetch the right binary image for the machine architecture they are using.

0 commit comments

Comments
 (0)