...
Eroare Kubernetes · Volume, PVC și StatefulSet

The Pod "arhiva" is invalid: spec.containers[0].volumeMounts[0].name: Not found: "date"

Pe scurt

Containerul montează un volum care nu e declarat în spec.volumes (sau are alt nume acolo). Numele din volumeMounts trebuie să fie identic cu un nume din volumes.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Volumele unui pod se declară în două locuri: spec.volumes spune ce este volumul (PVC, ConfigMap, emptyDir), iar containers[].volumeMounts spune unde apare în container. Legătura se face prin name. Dacă un volumeMounts folosește un nume care nu există în volumes, validarea refuză podul (sau Deploymentul) cu Not found: "date".

Cauze: o greșeală de scriere, un volum redenumit doar într-un loc, volumes pus la nivelul greșit (în container, nu în spec), sau, în cazul unui StatefulSet, un nume diferit de cel din volumeClaimTemplates.

Mesajul arată exact containerul și poziția (containers[0].volumeMounts[0]), deci găsești ușor linia.

De ce apare: cauzele frecvente

1Nume diferite

Greșit
YAML
  volumes:
  - name: arhiva-date
  ...
    volumeMounts:
    - name: date
Corect
YAML
  volumes:
  - name: date
  ...
    volumeMounts:
    - name: date

Numele leagă montarea de volum.

2volumes pus în container

Greșit
YAML
  containers:
  - name: app
    volumes:
    - name: date
Corect
YAML
  volumes:
  - name: date
  containers:
  - name: app

volumes stă în spec-ul podului, nu în container.

3StatefulSet cu alt nume în șablon

Greșit
YAML
  volumeClaimTemplates:
  - metadata:
      name: data
Corect
YAML
  volumeClaimTemplates:
  - metadata:
      name: date

Montarea folosește numele din volumeClaimTemplates.

Repară tu

Repară eroarea, direct în pagină

Podul arhiva al unei biblioteci (~/k8s/arhiva.yaml) e refuzat cu volumeMounts[0].name: Not found: "date": volumul e declarat ca arhiva-date. Corectează numele din volumeMounts să fie arhiva-date și creează podul.

Indiciu

Numele din volumeMounts trebuie să existe în spec.volumes.

Alte forme ale mesajului

  • The Deployment "web" is invalid: spec.template.spec.containers[0].volumeMounts[0].name: Not found: "config"

Cum o eviți pe viitor

  • Folosește nume scurte și consecvente pentru volume (date, config).
  • Când redenumești un volum, caută toate aparițiile în fișier.
  • Validează manifestele cu kubectl apply --dry-run=server înainte de livrare.
  • Un linter (kubeconform, kube-linter) prinde montările fără volum încă din pipeline.
  • Declară volumes imediat după containers sau înainte, mereu în același loc, ca să le compari ușor.

Întrebări frecvente

Un volum poate fi montat în mai multe containere?

Da. Declari volumul o dată în volumes, iar fiecare container îl montează cu același nume.

Pot monta același volum de două ori?

Da, în căi diferite, de exemplu cu subPath pentru foldere diferite.

Erori înrudite

← Toate erorile Kubernetes

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Kubernetes de la zero, cu exerciții la fiecare lecție

Curs Kubernetes: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 12 lecții sunt gratuite.