Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 4: Images und Container-Start

Ziel: Du unterscheidest Pull-Fehler an ihrer Meldung, prüfst Images direkt auf dem Knoten und findest Fehler zwischen Pull und Start. · Dauer: ca. 60 min · Voraussetzung: Tag 1

Briefing

  • Nach dem Scheduling ist das kubelet dran: Image ziehen (containerd), Container aus Env, Secrets und Volumes zusammenbauen, Prozess starten. Jede Phase hat ihr eigenes Fehlerbild.
  • ErrImagePull ist der erste Fehlschlag, ImagePullBackOff das Warten bis zum nächsten Versuch. Die Ursache steht in der Meldung dahinter, nicht im Status.
  • exec format error ist ein Startfehler, kein Pull-Fehler: Das Image ist da, aber der Kernel kann die Datei nicht ausführen.
Fehlerbild Symptom Wo die Antwort steht
Tag falsch ErrImagePull Meldung: not found
Registry unerreichbar ErrImagePull Meldung: no such host, HTTPS client
Privat ohne Secret ImagePullBackOff Meldung: pull access denied
ConfigMap/Secret fehlt CreateContainerConfigError Event Failed am Pod
Shebang, Architektur CrashLoopBackOff Log: exec format error

Drill 1: Drei Pull-Fehler, drei Meldungen

Einbauen:

# auf cp1
mkdir -p ~/debug/tag04 && cd ~/debug/tag04
kubectl create namespace tag04
kubectl -n tag04 create deployment tippfehler \
  --image=nginxinc/nginx-unprivileged:1.29-alpne
kubectl -n tag04 create deployment unerreichbar --image=registry.tag04.invalid/web:1.0
kubectl -n tag04 create deployment privat --image=docker.io/dbglabor/privat-app:1.0

Symptom:

# auf cp1
kubectl -n tag04 get pods

Erwartet:

NAME                            READY   STATUS             RESTARTS   AGE
privat-6b74c95474-p5shr         0/1     ImagePullBackOff   0          40s
tippfehler-7c975b5497-5cc46     0/1     ErrImagePull       0          40s
unerreichbar-699cd56b54-lmwrx   0/1     ErrImagePull       0          40s

Untersuchen: Die Meldung steht in state.waiting.message (oder in describe unter Events):

# auf cp1
for a in tippfehler unerreichbar privat; do
  kubectl -n tag04 get pod -l app=$a \
    -o jsonpath='{.items[0].status.containerStatuses[0].state.waiting.message}{"\n"}'
done

Erwartet (Zeilen umbrochen, gekürzt):

rpc error: code = NotFound desc = failed to pull and unpack image
  "docker.io/nginxinc/nginx-unprivileged:1.29-alpne": ...
  docker.io/nginxinc/nginx-unprivileged:1.29-alpne: not found
failed to pull and unpack image "registry.tag04.invalid/web:1.0": ... failed to do
  request: Head "https://registry.tag04.invalid/v2/web/manifests/1.0": dial tcp:
  lookup registry.tag04.invalid on 127.0.0.53:53: no such host
Back-off pulling image "docker.io/dbglabor/privat-app:1.0": ErrImagePull: ... pull
  access denied, repository does not exist or may require authorization: server
  message: insufficient_scope: authorization failed

Ursache: not found – die Registry antwortet, kennt den Tag aber nicht. no such host – der Knoten (nicht der Pod!) kann den Namen nicht auflösen; die Adresse 127.0.0.53 ist der systemd-resolved des Hosts. pull access denied – das Repository gibt es nicht oder es ist privat; Docker Hub unterscheidet das absichtlich nicht.

Fix für den Tippfehler (der Containername kommt bei create deployment aus dem Image-Namen):

# auf cp1
kubectl -n tag04 set image deploy/tippfehler \
  nginx-unprivileged=nginxinc/nginx-unprivileged:1.29-alpine
kubectl -n tag04 rollout status deploy/tippfehler
kubectl -n tag04 delete deploy unerreichbar privat

Nachweis:

# auf cp1
kubectl -n tag04 get pods -l app=tippfehler

Erwartet: ein Pod 1/1 Running. Den privaten Fall baust du in Drill 4 richtig nach.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Auf dem Knoten nachsehen

Ob ein Pull am Knoten selbst klappt, prüfst du ohne kubelet mit crictl. So trennst du „Knoten kommt nicht an die Registry“ von „Pod-Spezifikation falsch“.

# auf worker1
sudo -i crictl pull nginxinc/nginx-unprivileged:1.29-alpne 2>&1 | tail -1 | cut -c1-88
sudo -i crictl pull nginxinc/nginx-unprivileged:1.29-alpine
sudo -i crictl images | grep -E 'IMAGE|nginx'

Erwartet (gekürzt):

time="2026-11-20T07:09:08Z" level=error msg="pulling image: rpc error: code = NotFound d
Image is up to date for sha256:7312fa98595737958df41e20f21a2880dd9775f455c6bf76e638024dc
IMAGE                                   TAG                    IMAGE ID          ...
docker.io/nginxinc/nginx-unprivileged   1.29                   b3c400d96d1d1     ...
docker.io/nginxinc/nginx-unprivileged   1.29-alpine            7312fa9859573     ...

Image is up to date meldet crictl nach jedem erfolgreichen Pull. Kurze Namen wie nginxinc/… ergänzt containerd zu docker.io/….

Talos: Dort heißt das talosctl image pull bzw. talosctl image list (Tag 18).

Fortschritt speichern? Kostenlos registrieren

Drill 3: registries.yaml – Mirror und HTTP-Registry

Docker Hub begrenzt anonyme Pulls pro IP. Ein Mirror wird nicht im Pod, sondern in containerd auf jedem Knoten eingetragen. RKE2 liest dafür /etc/rancher/rke2/registries.yaml – nur beim Start. Der zweite Eintrag bereitet Drill 4 vor: Die Labor-Registry dort kann nur HTTP, containerd versucht es aber bei jeder Registry per HTTPS, solange nichts anderes eingetragen ist.

# auf cp1, worker1 und worker2
sudo tee /etc/rancher/rke2/registries.yaml >/dev/null <<'EOF'
mirrors:
  docker.io:
    endpoint: ["https://mirror.gcr.io"]
  "172.16.0.126:30500":
    endpoint: ["http://172.16.0.126:30500"]
EOF
sudo chmod 600 /etc/rancher/rke2/registries.yaml

Achtung: Der Neustart des RKE2-Dienstes startet kubelet und containerd neu. Laufende Pods überstehen ihn, auf cp1 ist die API aber kurz weg.

# auf cp1
sudo systemctl restart rke2-server
# auf worker1 und worker2
sudo systemctl restart rke2-agent

RKE2 erzeugt daraus pro Registry eine hosts.toml für containerd:

# auf worker1
sudo cat /var/lib/rancher/rke2/agent/etc/containerd/certs.d/docker.io/hosts.toml

Erwartet:

# File generated by rke2. DO NOT EDIT.
server = "https://registry-1.docker.io/v2"
capabilities = ["pull", "resolve", "push"]

[host]

[host."https://mirror.gcr.io/v2"]
  capabilities = ["pull", "resolve"]
# auf worker2
sudo -i crictl pull busybox:1.36

Erwartet:

Image is up to date for sha256:b116e155074440ffd9e449559433feb4cd2341eb3554b1da1c638c

Warum? containerd fragt zuerst den Mirror und fällt sonst auf server zurück. Ein kaputter Mirror fällt deshalb nicht sofort auf: Pulls werden nur langsamer und zählen wieder gegen das Limit.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Private Registry und imagePullSecret

Für den echten Weg brauchst du eine Registry mit Passwort. Du startest registry:3 mit htpasswd-Datei im Cluster, erreichbar über NodePort 30500.

# auf cp1
kubectl -n tag04 run htpasswd --rm -i --quiet --restart=Never \
  --image=httpd:2.4-alpine -- htpasswd -Bbn labor labor-pw-123 > htpasswd
kubectl -n tag04 create secret generic registry-auth --from-file=htpasswd
cat > registry.yaml <<'EOF'
apiVersion: apps/v1
kind: Deployment
metadata: {name: registry, namespace: tag04}
spec:
  selector: {matchLabels: {app: registry}}
  template:
    metadata: {labels: {app: registry}}
    spec:
      containers:
      - name: registry
        image: registry:3.1.2
        env:
        - {name: REGISTRY_AUTH, value: htpasswd}
        - {name: REGISTRY_AUTH_HTPASSWD_REALM, value: labor}
        - {name: REGISTRY_AUTH_HTPASSWD_PATH, value: /auth/htpasswd}
        ports: [{containerPort: 5000}]
        volumeMounts: [{name: auth, mountPath: /auth}]
      volumes:
      - name: auth
        secret: {secretName: registry-auth}
---
apiVersion: v1
kind: Service
metadata: {name: registry, namespace: tag04}
spec:
  type: NodePort
  selector: {app: registry}
  ports: [{port: 5000, nodePort: 30500}]
EOF
kubectl apply -f registry.yaml
kubectl -n tag04 rollout status deploy/registry
curl -s -i http://172.16.0.126:30500/v2/ | grep -E 'HTTP|Authenticate'

Erwartet:

HTTP/1.1 401 Unauthorized
Www-Authenticate: Basic realm="labor"

Ein Image hineinkopieren, mit regctl in einem kurzlebigen Pod:

# auf cp1
kubectl -n tag04 run regctl --restart=Never --image=regclient/regctl:v0.11.7-alpine \
  --command -- sh -c '
regctl registry set --tls disabled registry.tag04:5000 2>/dev/null
regctl registry login registry.tag04:5000 -u labor -p labor-pw-123 &&
regctl image copy traefik/whoami:v1.11 registry.tag04:5000/privat/whoami:1.0 &&
regctl tag ls registry.tag04:5000/privat/whoami'
kubectl -n tag04 wait pod/regctl --for=jsonpath='{.status.phase}'=Succeeded
kubectl -n tag04 logs regctl
kubectl -n tag04 delete pod regctl

Erwartet:

pod/regctl condition met
registry.tag04:5000/privat/whoami:1.0
1.0
pod "regctl" deleted from tag04 namespace

Einbauen:

# auf cp1
kubectl -n tag04 create deployment intern --image=172.16.0.126:30500/privat/whoami:1.0

Symptom:

# auf cp1
kubectl -n tag04 get pod -l app=intern \
  -o jsonpath='{.items[0].status.containerStatuses[0].state.waiting.message}{"\n"}'

Erwartet (Zeile umbrochen, gekürzt):

Back-off pulling image "172.16.0.126:30500/privat/whoami:1.0": ErrImagePull: ...
  pull access denied, repository does not exist or may require authorization:
  authorization failed: no basic auth credentials

Der Pull erreicht die Registry, sie verlangt aber Zugangsdaten. Ohne den Eintrag für 172.16.0.126:30500 aus Drill 3 käme er nicht so weit, denn containerd spräche die Registry per HTTPS an. Die Meldung sähe dann so aus:

Back-off pulling image "172.16.0.126:30500/privat/whoami:1.0": ErrImagePull: ...
  failed to do request: Head
  "https://172.16.0.126:30500/v2/privat/whoami/manifests/1.0": http: server gave
  HTTP response to HTTPS client

Fix:

# auf cp1
kubectl -n tag04 create secret docker-registry intern-pull \
  --docker-server=172.16.0.126:30500 \
  --docker-username=labor --docker-password=labor-pw-123
kubectl -n tag04 patch deploy intern --type=merge \
  -p '{"spec":{"template":{"spec":{"imagePullSecrets":[{"name":"intern-pull"}]}}}}'
kubectl -n tag04 rollout status deploy/intern

Nachweis:

# auf cp1
kubectl -n tag04 events --for pod/$(kubectl -n tag04 get pod -l app=intern \
  --field-selector=status.phase=Running -o jsonpath='{.items[0].metadata.name}') \
  | grep Pulled | cut -c1-88

Erwartet:

10s         Normal   Pulled      Pod/intern-7574d675f7-h684z   Successfully pulled image

Warum? Das Secret muss im selben Namespace wie der Pod liegen und --docker-server genau so heißen wie der Registry-Teil des Image-Namens, hier mit Port.

Fortschritt speichern? Kostenlos registrieren

Drill 5: CreateContainerConfigError

Einbauen:

# auf cp1
cat > config.yaml <<'EOF'
apiVersion: v1
kind: Secret
metadata: {name: app-secret, namespace: tag04}
stringData: {db-password: lab-db-123}
---
apiVersion: apps/v1
kind: Deployment
metadata: {name: konfig, namespace: tag04}
spec:
  replicas: 1
  selector: {matchLabels: {app: konfig}}
  template:
    metadata: {labels: {app: konfig}}
    spec:
      containers:
      - name: app
        image: busybox:1.37
        command: [sh, -c, 'echo "Modus $MODE"; sleep infinity']
        env:
        - name: MODE
          valueFrom: {configMapKeyRef: {name: app-config, key: mode}}
        - name: DB_PASSWORD
          valueFrom: {secretKeyRef: {name: app-secret, key: DB_PASSWORD}}
EOF
kubectl apply -f config.yaml

Symptom:

# auf cp1
kubectl -n tag04 get pods -l app=konfig
kubectl -n tag04 events --for $(kubectl -n tag04 get pod -l app=konfig -o name) \
  --types=Warning | cut -c1-88

Erwartet (Zeile umbrochen):

NAME                      READY   STATUS                       RESTARTS   AGE
konfig-6dff46b849-5jvhk   0/1     CreateContainerConfigError   0          8s
LAST SEEN         TYPE      REASON   OBJECT                        MESSAGE
6s (x3 over 7s)   Warning   Failed   Pod/konfig-6dff46b849-5jvhk   Error: configmap
  "app-config" not found

Fix, erster Teil:

# auf cp1
kubectl -n tag04 create configmap app-config --from-literal=mode=produktion

Nachweis: Das kubelet versucht es von selbst erneut – und findet den nächsten Fehler:

# auf cp1
kubectl -n tag04 events --for $(kubectl -n tag04 get pod -l app=konfig -o name) \
  --types=Warning | tail -1 | cut -c1-88
kubectl -n tag04 get secret app-secret -o jsonpath='{.data}{"\n"}'

Erwartet (Zeile umbrochen):

9s                  Warning   Failed   Pod/konfig-6dff46b849-5jvhk   Error: couldn't
  find key DB_PASSWORD in Secret tag04/app-secret
{"db-password":"bGFiLWRiLTEyMw=="}

Ursache: Das Secret heißt richtig, der Schlüssel heißt db-password, nicht DB_PASSWORD. Das kubelet meldet immer nur den ersten fehlenden Verweis.

Fix, zweiter Teil:

# auf cp1
kubectl -n tag04 patch deploy konfig --type=json -p '[{"op": "replace",
  "path": "/spec/template/spec/containers/0/env/1/valueFrom/secretKeyRef/key",
  "value": "db-password"}]'
kubectl -n tag04 rollout status deploy/konfig
kubectl -n tag04 logs deploy/konfig

Erwartet (gekürzt):

deployment "konfig" successfully rolled out
Found 2 pods, using pod/konfig-866568954c-s6r94
Modus produktion

Fortschritt speichern? Kostenlos registrieren

Drill 6: exec format error – der fehlende Shebang

Einbauen:

# auf cp1
cat > skript.yaml <<'EOF'
apiVersion: v1
kind: ConfigMap
metadata: {name: start-skript, namespace: tag04}
data:
  start.sh: |
    echo "Starte Dienst"
    exec sleep infinity
---
apiVersion: apps/v1
kind: Deployment
metadata: {name: skript, namespace: tag04}
spec:
  replicas: 1
  selector: {matchLabels: {app: skript}}
  template:
    metadata: {labels: {app: skript}}
    spec:
      containers:
      - name: app
        image: busybox:1.37
        command: [/scripts/start.sh]
        volumeMounts: [{name: skript, mountPath: /scripts}]
      volumes:
      - name: skript
        configMap: {name: start-skript, defaultMode: 0755}
EOF
kubectl apply -f skript.yaml

Symptom und Untersuchen:

# auf cp1
kubectl -n tag04 get pods -l app=skript
kubectl -n tag04 logs deploy/skript
kubectl -n tag04 get pod -l app=skript \
  -o jsonpath='{.items[0].status.containerStatuses[0].state.terminated.exitCode}{"\n"}'

Erwartet:

NAME                      READY   STATUS   RESTARTS      AGE
skript-7c8d47fd74-f62gt   0/1     Error    1 (10s ago)   12s
exec /scripts/start.sh: exec format error
255

Ursache: Die Datei ist ausführbar, aber ohne #!/bin/sh weiß der Kernel nicht, womit er sie starten soll. Eine Shell würde so ein Skript notfalls selbst lesen, der Kernel nicht. Exit-Code 255 kommt vom Startprozess im Container.

Fix:

# auf cp1
sed -i 's|  start.sh: \||  start.sh: \|\n    #!/bin/sh|' skript.yaml
sed -n 4,8p skript.yaml
kubectl apply -f skript.yaml
kubectl -n tag04 rollout restart deploy/skript
kubectl -n tag04 rollout status deploy/skript

Nachweis:

# auf cp1
kubectl -n tag04 logs deploy/skript

Erwartet (gekürzt):

Starte Dienst

Warum der rollout restart? Die ConfigMap im Volume wird zwar nach einer Weile aktualisiert, aber ein neuer Pod zeigt sofort, ob der Fix wirkt.

Fortschritt speichern? Kostenlos registrieren

Drill 7: exec format error – fremde Architektur

Ein Multi-Arch-Image ist ein Index, der pro Architektur auf ein eigenes Manifest zeigt. Referenzierst du ein Manifest direkt über seinen Digest, umgehst du die Auswahl.

# auf cp1
kubectl -n tag04 run digest --restart=Never --image=regclient/regctl:v0.11.7-alpine \
  --command -- sh -c 'for p in linux/amd64 linux/arm64; do
  echo "$p $(regctl image digest --platform $p busybox:1.37)"; done'
kubectl -n tag04 wait pod/digest --for=jsonpath='{.status.phase}'=Succeeded
kubectl -n tag04 logs digest
kubectl -n tag04 delete pod digest

Erwartet (gekürzt):

linux/amd64 sha256:66a6306db78bf2dbf3487f293aa8d6990d8e506fdffab9cc43fe422becf886e4
linux/arm64 sha256:d82c2ab94640ded77cf76514ce6a84870761105058a4a9e51b05a8a79be97a6c

Einbauen: Auf amd64-Knoten nimmst du den arm64-Digest, auf arm64-Knoten (Apple Silicon, multipass) den amd64-Digest.

# auf cp1
D=sha256:d82c2ab94640ded77cf76514ce6a84870761105058a4a9e51b05a8a79be97a6c
kubectl -n tag04 create deployment fremd --image=busybox@$D -- sleep infinity

Symptom und Untersuchen:

# auf cp1
kubectl -n tag04 get pods -l app=fremd
kubectl -n tag04 logs deploy/fremd
kubectl -n tag04 get pod -l app=fremd -o jsonpath='{.items[0].spec.nodeName}{"\n"}'

Erwartet:

NAME                     READY   STATUS             RESTARTS      AGE
fremd-568d4f46d8-p9c7s   0/1     CrashLoopBackOff   1 (11s ago)   16s
exec /bin/sleep: exec format error
worker2
# auf worker2
D=sha256:d82c2ab94640ded77cf76514ce6a84870761105058a4a9e51b05a8a79be97a6c
sudo -i crictl inspecti busybox@$D | jq -r .info.imageSpec.architecture

Erwartet:

arm64

Ursache: containerd zieht, was der Digest verlangt, auch wenn es nicht zum Knoten passt. Erst beim Start scheitert der Kernel an der fremden Binärdatei.

Fix:

# auf cp1
kubectl -n tag04 set image deploy/fremd busybox=busybox:1.37
kubectl -n tag04 rollout status deploy/fremd

Nachweis:

# auf cp1
kubectl -n tag04 get pods -l app=fremd

Erwartet: ein neuer Pod 1/1 Running, der alte in Terminating.

Fortschritt speichern? Kostenlos registrieren

Übung: Speed-Drills

  1. Zeig für alle Pods in tag04 Name und Image. Zeitziel: 30 s
  2. Zeig alle Pods in tag04, die nicht Running sind. Zeitziel: 20 s
  3. Für welche Registry gilt das Secret intern-pull? Zeitziel: 45 s
  4. Zeig auf worker1 alle busybox-Images. Zeitziel: 20 s

Lösung

# auf cp1
kubectl -n tag04 get pods -o custom-columns=NAME:.metadata.name,\
IMAGE:.spec.containers[0].image
kubectl -n tag04 get pods --field-selector=status.phase!=Running
kubectl -n tag04 get secret intern-pull -o jsonpath='{.data.\.dockerconfigjson}' \
  | base64 -d | jq -r '.auths | keys[]'
ssh worker1 sudo -i crictl images | grep busybox

Erwartet (gekürzt):

NAME                          IMAGE
fremd-78996cf9-9bvcd          busybox:1.37
intern-7574d675f7-h684z       172.16.0.126:30500/privat/whoami:1.0
konfig-866568954c-s6r94       busybox:1.37
registry-6b5c56b54d-xbgmg     registry:3.1.2
skript-f5c7c985c-gqcs4        busybox:1.37
tippfehler-6f8bbbc746-8xzld   nginxinc/nginx-unprivileged:1.29-alpine
No resources found in tag04 namespace.
172.16.0.126:30500
docker.io/library/busybox                  1.37                   30ecbe1509090 ...

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

# auf cp1
kubectl -n tag04 get deploy

Erwartet: fremd, intern, konfig, registry, skript und tippfehler, alle 1/1.

# auf worker2
sudo test -f /etc/rancher/rke2/registries.yaml && echo vorhanden

Erwartet:

vorhanden

Challenge

Ein Deployment offline nutzt nginxinc/nginx-unprivileged:1.29-alpine-slim mit imagePullPolicy: Never, weil die Knoten später ohne Internet laufen sollen. Bring es zum Laufen, ohne das Manifest zu ändern.

Hinweis: Never heißt: Das kubelet zieht nie selbst, das Image muss schon auf dem Knoten liegen.

Lösung

# auf cp1
cat > offline.yaml <<'EOF'
apiVersion: apps/v1
kind: Deployment
metadata: {name: offline, namespace: tag04}
spec:
  replicas: 1
  selector: {matchLabels: {app: offline}}
  template:
    metadata: {labels: {app: offline}}
    spec:
      containers:
      - name: web
        image: nginxinc/nginx-unprivileged:1.29-alpine-slim
        imagePullPolicy: Never
EOF
kubectl apply -f offline.yaml
kubectl -n tag04 events --for $(kubectl -n tag04 get pod -l app=offline -o name) \
  --types=Warning | head -2 | cut -c1-88

Erwartet (Zeile umbrochen):

LAST SEEN         TYPE      REASON              OBJECT                         MESSAGE
5s (x3 over 7s)   Warning   ErrImageNeverPull   Pod/offline-748df9f596-bqx6b   Container
  image "nginxinc/nginx-unprivileged:1.29-alpine-slim" is not present with pull
  policy of Never

Das Image auf alle Knoten bringen, denn der nächste Pod kann woanders landen:

# auf cp1
sudo -i crictl pull nginxinc/nginx-unprivileged:1.29-alpine-slim
ssh -n worker1 sudo -i crictl pull nginxinc/nginx-unprivileged:1.29-alpine-slim
ssh -n worker2 sudo -i crictl pull nginxinc/nginx-unprivileged:1.29-alpine-slim
kubectl -n tag04 get pods -l app=offline

Erwartet (nach etwa 30 Sekunden):

NAME                       READY   STATUS    RESTARTS   AGE
offline-748df9f596-bqx6b   1/1     Running   0          66s

Das kubelet versucht es selbst erneut; ein Neustart des Pods ist nicht nötig.

Fortschritt speichern? Kostenlos registrieren

Aufräumen

# auf cp1
kubectl delete namespace tag04
kubectl get pods -A --field-selector=status.phase!=Running,status.phase!=Succeeded

Erwartet:

namespace "tag04" deleted
No resources found

Die registries.yaml bleibt auf allen Knoten: Der Docker-Hub-Mirror schont ab jetzt das Pull-Limit. Der Eintrag für 172.16.0.126:30500 stört ohne Registry nicht.

Interview-Notiz

  • ImagePullBackOff – wie gehst du vor? Meldung lesen: not found (Tag), no such host/Timeout (Netz/DNS des Knotens), pull access denied (privat oder gar nicht vorhanden), dann crictl pull auf dem Knoten.
  • Wo kommen Registry-Zugangsdaten hin? Als imagePullSecrets im Pod oder am ServiceAccount, Secret im selben Namespace; alternativ knotenweit in registries.yaml.
  • exec format error? Shebang fehlt oder Architektur passt nicht – prüfen mit crictl inspecti bzw. regctl image digest --platform.

Enterprise-Notiz

  • Pull-Through-Cache (Harbor, Zot, Artifactory) statt öffentlicher Mirror; in registries.yaml mit Zugangsdaten unter configs:.
  • imagePullSecrets am ServiceAccount default des Namespace ersparen sie in jedem Manifest.
  • Images per Digest pinnen ist gut – aber immer den Index-Digest, nie den einer Architektur.
  • Registries ohne TLS nur im Labor; produktiv eigenes CA-Zertifikat unter configs: tls: ca_file.
  • Air-Gap-Knoten bekommen Images vorab (Tarballs in agent/images/) und imagePullPolicy: IfNotPresent statt Never.