error: unable to read URL "https://k8s.io/examples/aplication/deployment.yaml", server reported 404 Not Found, status code=404
kubectl a încercat să descarce manifestul de la adresa dată cu -f, iar serverul a răspuns 404: URL-ul e greșit sau fișierul a fost mutat. Deschide adresa în browser, corectează calea și, la GitHub, folosește linkul raw.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
-f acceptă și adrese https: kubectl descarcă fișierul și îl aplică. Mesajul spune că descărcarea a eșuat, cu codul HTTP primit. 404 înseamnă că la adresa respectivă nu e nimic: o literă greșită în cale, un fișier mutat într-o versiune nouă a documentației sau o ramură git redenumită (master față de main).
O capcană frecventă e linkul către pagina GitHub a fișierului (github.com/.../blob/...): acela întoarce o pagină HTML, nu YAML-ul, iar kubectl dă altă eroare, de parsare. Pentru fișierele de pe GitHub folosește linkul „Raw” (raw.githubusercontent.com/...).
Alte coduri au alte cauze: 403 (acces interzis, repository privat), erori de rețea sau certificat (proxy, firewall).
De ce apare: cauzele frecvente
1Greșeală în cale
kubectl apply -f https://k8s.io/examples/aplication/deployment.yamlkubectl apply -f https://k8s.io/examples/application/deployment.yamlaplication nu există în documentație; calea corectă e application.
2Link spre pagina GitHub, nu spre fișier
kubectl apply -f https://github.com/org/repo/blob/main/k8s/app.yamlkubectl apply -f https://raw.githubusercontent.com/org/repo/main/k8s/app.yamlPagina blob e HTML; varianta raw este fișierul YAML.
3Ramura sau versiunea s-a schimbat
kubectl apply -f https://raw.githubusercontent.com/org/repo/master/app.yamlkubectl apply -f https://raw.githubusercontent.com/org/repo/main/app.yamlCând un proiect redenumește ramura, linkurile vechi dau 404.
Repară eroarea, direct în pagină
Documentația Kubernetes are un exemplu de Deployment la https://k8s.io/examples/application/deployment.yaml. Colegul tău a scris adresa greșit și kubectl apply -f https://k8s.io/examples/aplication/deployment.yaml dă server reported 404 Not Found. Aplică exemplul de la adresa corectă și verifică Deploymentul creat.
Indiciu
Compară literă cu literă cuvântul application din cale.
Reparația
Adresa greșită:
kubectl apply -f https://k8s.io/examples/aplication/deployment.yaml || trueerror: unable to read URL "https://k8s.io/examples/aplication/deployment.yaml", server reported 404 Not Found, status code=404Adresa corectă:
kubectl apply -f https://k8s.io/examples/application/deployment.yaml
kubectl get deploy nginx-deploymentdeployment.apps/nginx-deployment created
NAME READY UP-TO-DATE AVAILABLE AGE
nginx-deployment 0/2 2 0 2sDe ce merge
kubectl descarcă fișierul de la URL și abia apoi îl aplică. Cu o literă lipsă în cale, serverul documentației răspunde 404 și nu se aplică nimic. La adresa corectă e Deploymentul nginx-deployment, pe care kubectl îl creează ca pe orice fișier local.
Alte forme ale mesajului
error: unable to read URL "https://raw.githubusercontent.com/org/repo/master/app.yaml", server reported 404 Not Found, status code=404
Cum o eviți pe viitor
- Descarcă manifestele externe, citește-le și păstrează-le în proiect, în loc să aplici direct de pe internet.
- Folosește linkuri cu versiune fixă (un tag), nu ramuri care se mută.
- Verifică adresa cu
curl -sI URLînainte să o dai la kubectl.
Întrebări frecvente
E sigur să aplici manifeste direct de pe internet?
Doar din surse în care ai încredere și, ideal, după ce le-ai citit. Un manifest poate crea orice în cluster, inclusiv permisiuni largi.
De ce în browser merge, iar în kubectl nu?
Fie browserul a urmat o redirecționare pe care o pagină o face doar pentru oameni, fie ai deschis varianta HTML. kubectl are nevoie de fișierul brut.
Erori înrudite
error: the path "api.yaml" does not exist Fișierul dat cu -f nu există în folderul în care rulezi comanda: e în alt folder, are altă extensie (.yml) sau numele e scris greșit. Verifică cu ls și pwd și dă calea corectă, relativă sau absolută (-f manifeste/api.yaml). error: must specify one of -f and -k kubectl apply (sau delete, diff) nu știe ce fișier să folosească: ai scris numele fișierului fără -f. Scrie kubectl apply -f web.yaml (sau -f folder/), iar -k doar pentru un folder cu kustomization.yaml. error: no objects passed to apply Fișierul dat la kubectl apply -f nu conține niciun obiect: e gol, are doar comentarii sau separatoare ---, ori folderul nu are fișiere .yaml. Verifică conținutul cu cat și scrie manifestul (apiVersion, kind, metadata, spec). Î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.
